Socket Programming in Python: Client, Server, Peer Libraries

4 min readMar 3, 2023

In this tutorial, you'll learn how to exchange data between a client and a server using Python socket programming and the Socket API.  Later, this tutorial will discuss exchanging data directly between two or more Python clients using a hosted provider.  The source code used in this tutorial can be found within the GitHub repository.

Socket programming connects two sockets (a client socket and a server socket) and allows them to communicate bi-directionally in real-time.  Direct socket connections can benefit all real-time applications since data can be sent or received anytime.

Environment Set up

You will need a stable version of Python version 3.x installed on your machine.  If you are a Windows user, you have the option of adding Python to your PATH.  

You will also need a code editor to follow along with this tutorial.  Visual Studio Code is a popular open-source and free code editor that supports many languages and frameworks, including Python.  VSCode also supports extensions for Python to help with code completion and debugging.

Build and run a Python socket application

Let’s build a straightforward socket application using Python. Python provides a native socket class (socket module), so developers don’t need to depend on external libraries. Begin by setting up the Python socket client and server:

python socket connection diagram

Create the in the project directory. To use sockets, import the Python socket library and create a new socket object that connects to a specified IP address (in this case, localhost on port number 8080, but you can select any ipv4 address).  Create a new connection to the socket server, send data to the TCP server, and close the socket connection.

Your file should look like this:

import socket
client = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
client.connect(('', 8080))
client.send("I am CLIENT\n".encode())
from_server = client.recv(4096)
print (from_server.decode())

You will need a socket server to listen for incoming connections and messages from your client. Create the file and add the following contents:

import socket
serv = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
serv.bind(('', 8080))
while True:
  conn, addr = serv.accept()
  from_client = ''
  while True:
    data = conn.recv(4096)
    if not data: break
    from_client += data.decode('utf8')
    print (from_client)
    conn.send("I am SERVER\n".encode())
print ('client disconnected and shutdown') binds the socket object to the hostname (localhost) on port 8080 and continually listens for new client connections. When a client connects to this address, the server accepts the connection and reads any data. Once the data is successfully read from the client, the server provides a data response, at which point the client terminates the connection.

To test this out yourself, open two terminal windows simultaneously.  In one window, run:


In the second window, run:


Notice that the server continues running and will establish a new connection every time you run the client and append any new output.

The client will send the "I am CLIENT" string to the server and wait for a reply. The server will read the client’s message, output it to the terminal, and send back a response to the client.

python sockets

Socket Programming in Python using PubNub

So far, this tutorial has covered exchanging messages between a server and a client, but what if you need to communicate directly between Python clients? 

Sending data directly between two or more client devices is tricky because you run into many scaling and security considerations as your number of devices increases.  A client-server architecture is used to moderate and manage your client-to-client communication. If you don’t have a web server or you worry about your server scaling to meet your application’s demands, you should opt for a hosted, real-time communication solution such as PubNub. PubNub is a globally distributed and scalable cloud platform, so you don’t have to worry about deploying and maintaining servers.  PubNub’s cross-platform SDKs, including Python, can identify users and send messages to specific channels, which only subscribed clients will receive.

Client-to-Client Python socket programming

So, how would the simple app presented previously be written with PubNub to exchange messages directly between two clients?  It’s essential to understand that although PubNub uses the ‘publish’ and ‘subscribe’ architecture (pub/sub) to send and receive bidirectional messages between endpoints, it still uses sockets behind the scenes. PubNub gives you the benefits of socket communication without worrying about the details of Python network programming and maintaining an always-on connection between your clients regardless of the operating system.

To integrate PubNub into the project, install the PubNub package with pip in the terminal; this will allow you to use the PubNub Python SDK and communicate with the PubNub infrastructure.

pip3 install 'pubnub>=7.1.0'

You will need to create two clients to connect to and communicate over the PubNub network. Create a file and add the following code:

from pubnub.callbacks import SubscribeCallback
from pubnub.enums import PNStatusCategory
from pubnub.pnconfiguration import PNConfiguration
from pubnub.pubnub import PubNub
import time
import os
pnconfig = PNConfiguration()
userId = os.path.basename(__file__)
pnconfig.publish_key = 'demo'
pnconfig.subscribe_key = 'demo'
pnconfig.user_id = userId
pnconfig.ssl = True
pubnub = PubNub(pnconfig)
def my_publish_callback(envelope, status):
  # Check whether request successfully completed or not
  if not status.is_error():
class MySubscribeCallback(SubscribeCallback):
  def presence(self, pubnub, presence):
  def status(self, pubnub, status):
  def message(self, pubnub, message):
    if message.publisher == userId : return
    print ("from device " + message.publisher + ": " + message.message)
## publish a message
while True:
  msg = input("")
  if msg == 'exit': os._exit(1)

Create the file and add the same code as you used for

The code above uses ‘demo’ keys, but you can obtain your custom PubNub keys for free.  

Run both and simultaneously in two different terminal windows


Each client initializes its connection to the PubNub network and subscribes to receive new messages whenever they are published to the ‘chan-1’ channel. You can think of this as sending data over a TCP socket in Python; behind the scenes, PubNub is creating and managing the socket for you and routing your message to all clients who are listening for it. Once the remote client receives the message, the received message is displayed on the command line.

python pubnub

And that’s all there is to it! For more information on developing with PubNub, check out their range of tutorials and demos.  Alternatively, check out the PubNub interactive tour to understand how the platform provides real-time interactivity to applications. PubNub supports TCP and UDP datagram communication, as well as Linux, Unix, and Windows.

More from PubNub

How to Create a Dating App: 7 Steps to Fit Any Design
Insights6 minMar 15, 2023

How to Create a Dating App: 7 Steps to Fit Any Design

There are common underlying technologies for a dating app, and in this post, we’ll talk about the major technologies and designs...

Michael Carroll

Michael Carroll

How to Create a Real-time Public Transportation Schedule App
Build6 minMar 14, 2023

How to Create a Real-time Public Transportation Schedule App

How to use geohashing, JavaScript, Google Maps API, and BART API to build a real-time public transit schedule app.

Michael Carroll

Michael Carroll

How to Create Real-Time Vehicle Location Tracking App
Build2 minMar 9, 2023

How to Create Real-Time Vehicle Location Tracking App

How to track and stream real-time vehicle location on a live-updating map using EON, JavaScript, and the Mapbox API.

Michael Carroll

Michael Carroll

Talk to an expert