Connect Instantly: Creating an Easy Chat Client and Server from Scratch
Building your own chat application is the best way to understand how the internet works. At its core, network communication relies on a basic relationship: a server that listens for incoming connections and a client that talks to that server.
By using Python and its built-in socket library, you can build a functional command-line chat application from scratch in just a few minutes. Here is how to create both sides of the conversation. The Blueprint: How Socket Communication Works
Before writing code, it helps to understand the lifecycle of a network socket. Think of the server as a telephone operator and the client as the person making the call.
SERVER: Create Socket ──> Bind to IP/Port ──> Listen ──> Accept Connection ──> Read/Write Data ▲ CLIENT: Create Socket ──────────────────────> Connect to Server ──┘
The Server sets up a permanent listening post on a specific IP address and port number. The Client reaches out to that exact IP and port.
The Server accepts the handshake, creating a dedicated communication pipeline. Both sides can now send and receive raw text data. Step 1: Building the Chat Server
The server’s job is to sit quietly, wait for the client to connect, and then manage the incoming messages. Create a file named server.py and paste the following code:
import socket def run_server(): # 1. Create a socket object (AF_INET = IPv4, SOCK_STREAM = TCP) server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM) # 2. Bind the socket to the local host and a port HOST = ‘127.0.0.1’ PORT = 65432 server_socket.bind((HOST, PORT)) # 3. Listen for incoming connections (allow 1 connection in queue) server_socket.listen(1) print(f”[STARTING] Server is listening on {HOST}:{PORT}…“) # 4. Accept the connection conn, addr = server_socket.accept() print(f”[CONNECTED] Connection established with {addr}“) # 5. Continuous conversation loop while True: # Receive data from client (max 1024 bytes) data = conn.recv(1024).decode(‘utf-8’) if not data or data.lower() == ‘exit’: print(”[DISCONNECTED] Client closed the chat.“) break print(f”Client: {data}“) # Send a reply back reply = input(“You (Server): “) conn.sendall(reply.encode(‘utf-8’)) if reply.lower() == ‘exit’: break # 6. Clean up the connection conn.close() server_socket.close() print(”[SHUTDOWN] Server stopped.“) if name == “main”: run_server() Use code with caution. Step 2: Building the Chat Client
The client initiates the contact. It needs to know exactly where the server is located (127.0.0.1 represents your own computer, also known as “localhost”). Create a second file named client.py and add this code:
import socket def run_client(): # 1. Create the client socket client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM) # 2. Define the server address to connect to HOST = ‘127.0.0.1’ PORT = 65432 print(f”[CONNECTING] Trying to reach server at {HOST}:{PORT}…“) client_socket.connect((HOST, PORT)) print(”[CONNECTED] You are now linked to the server. Type ‘exit’ to quit.“) # 3. Continuous conversation loop while True: # Send a message message = input(“You (Client): “) client_socket.sendall(message.encode(‘utf-8’)) if message.lower() == ‘exit’: break # Wait for the server’s response reply = client_socket.recv(1024).decode(‘utf-8’) if not reply or reply.lower() == ‘exit’: print(”[DISCONNECTED] Server closed the chat.“) break print(f”Server: {reply}“) # 4. Clean up client_socket.close() print(”[CLOSED] Connection terminated.“) if name == “main”: run_client() Use code with caution. Step 3: Launching Your Chat
To see your creation in action, you need to use two separate terminal/command prompt windows. Start the Server: Open your first terminal window and run: python server.py Use code with caution. The terminal will print that it is listening. Start the Client: Open your second terminal window and run: python client.py Use code with caution.
Chat! Look at your server terminal; it will show a connection message. Type a message in the client terminal, hit Enter, and watch it pop up instantly on the server side. You can now pass messages back and forth. The Next Level: Making It Better
This basic setup alternates turns perfectly, but it has a major limitation: it is synchronous. One person cannot send two messages in a row without waiting for a reply, and it only handles one client at a time.
If you want to upgrade this into a modern, real-time application, look into these concepts next:
Threading (threading library): Allows the client and server to listen for new data and read keyboard input at the exact same time.
Asynchronous I/O (asyncio library): A high-performance way to manage hundreds of concurrent chatters without slowing down.
WebSockets: The protocol used to bridge this backend logic directly into web browsers like Chrome or Safari.
Congratulations! You have just stripped away the bloated layers of modern apps and communicated directly over raw network sockets. If you want to expand this project further,
See how to support multiple clients in a group chat room setup.
Modify the code to run across two different computers on your home Wi-Fi.
Leave a Reply