PyChat

A terminal-based chat application written in python.

It is meant for demo/educational purposes and not for real-world adoption.

Check out the demo video at the bottom and also the wiki

Intro
How to use
Demo reel
High level architecture

Intro

Hello. Thanks for stopping bye. Drop me a line.

Highlights

multiple users
customize how people see you
SSL encryption
scrollable chat history
0 external dependencies
single file

Requirements

python >= 3.11

Project origin

I started out wanting to do a small project that demonstrates some of my coding ability and my well rounded knowledge of computer systems.

Deciding on the right project was a challenge. With so much open-source code, it's now possible to make something really cool without actually having much skill or knowledge. That is why I choose not to use any 3rd party libraries for PyChat.

So, what is something small enough that 1 person can build, cool enough that I'd want to build it, and complicated enough that several problems need solved all in 1 project? The answer is PyChat.

PyChat concepts

To build PyChat it requires understanding or building each of the following

Concurrency
- Blocking & nonblocking
- Queues
- Coroutines & threads
Network socket IO
- Managing multiple connections
- A client/server communication spec
- SSL
Cryptography
Shell scripting
Terminal GUI & UI concepts
Terminal CLI and application design
Event-driven applications
- Pub/Sub concepts
Object serialization & JSON
"Advanced" python

All baked into a single file program, no external dependencies, just python and the standard lib.

How's THAT for a demo project?!?

How to use

Someone runs the server
1. pychat.py --serve --host 0.0.0.0 --port 8080
Others connect to the server
1. pychat.py --host 25.13.23.12 --port 8080

Things to know

Press the tab key to rotate focus between UI widgets
A widget must have focus to respond to keyboard & mouse events.
Press the return / enter key to send your message.

SSL mode

The host can run the server in SSL mode.

Both the server and client must give valid certificates to connect via SSL.

I've included a script generates a self-signed CA (certificate of authority) and issue validation certificates, see next section.

Note: PyChat expects certfiles to combine the private key and certificate into a single file like so

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----

Note: For the central authority (CA) you shouldn't comvine the key and cert. Only the cert is used to confirm others and only the cert should be shared. The CA key should be kept offline, air-gapped, in a dry-cool-place. The key is only needed to issue new certificates.

SSL example

# Server
> pychat.py -s --ssl --certfile ./server.pem --cafile ./rootCA.pem

# Client
> pychat.py --ssl --certfile ./client.pem --cafile ./rootCA.pem

Generate SSL certificates

The script I've included depends on having openssl installed on your system.

Once installed, you can generate the certificates by using the Makefile. (or examine the script and make it happen manually)

Another option for generating self-signed SSL certificates is to use a program like mkcert, but it will essentially just do the same thing as the included script.

> make ssl_certs

This should create several files in the ./ssl_certs folder

rootCA.key - The private key to the root certificate of authority (keep private, used to issue new certificates for others)
rootCA.pem - The certificate of authority. This is the file to use with pychat's --cafile option. (this file needs shared with others who want to connect via SSL)
client.pem - A unique private key/certificate combo. The certificate is issued/signed by the CA. This is the file to use with the --certfile option.
server.pem - Same as client.pem except both are their own unique key/certificate combo.

Full usage

> pychat.py --help
usage: pychat.py [-h] [-H HOST] [-P PORT] [-u USERNAME] [-c COLOR] [-s] [--ssl] [--certfile CERTFILE]
                 [--cafile CAFILE]

PyChat :)

PyChat is a terminal based multi-user, SSL enabled, chat application.

Within the app:
A widget must be 'in focus' to receive and respond to key-presses.
In other words, you must give focus to the input widget before typing your message.

The `tab` key rotates focus between UI widgets
The `return` key sends your typed message

options:
  -h, --help            show this help message and exit
  -H HOST, --host HOST  Host of sever
  -P PORT, --port PORT  Port of sever
  -u USERNAME, --username USERNAME
                        Display name to use in the chat
  -c COLOR, --color COLOR
                        Display color to use for your messages. (6 character hex string)
  -s, --serve           Run the chat server for others to connect
  --ssl                 Use secure connection via SSL
  --certfile CERTFILE   Path to SSL certificate
  --cafile CAFILE       Path to SSL certificate authority

Demo reel

pychat-demo.webm

michaelwayman / pychat