LocalMessenger: A Lightweight Local Network Instant Messaging Tool Built with Python

LocalMessenger is an open-source lightweight local network instant messaging tool built with Python asyncio and PyNaCl. It focuses on fully localized communication, allowing deployment on local networks or private servers without relying on third-party cloud services. The project, created by Sendgrish32 (who noted using AI assistance due to limited experience), serves as a practical reference for learning network programming and building private communication environments. Key features include user registration, password authentication, and public key encryption infrastructure.

The core design philosophy of LocalMessenger is to create an IM tool that runs on local networks or private servers, eliminating dependence on external services like WeChat or Telegram. This design caters to scenarios such as LAN internal communication (enterprises, schools, families), privacy-sensitive environments (data not passing through external servers), and network programming learning. The author openly mentioned using AI assistance during development, which adds educational value by showing modern developer workflows.

LocalMessenger uses a client-server architecture:

• Server (server.py): Acts as the core hub, handling client connections, user authentication (via JSON file storing username, SHA-256 password hash, and public key), async connection processing (via asyncio), message broadcasting (to all online users), and system notifications (user join/leave).
• Client (client.py): Uses dual coroutines for listening to server messages and sending user inputs (supports "stop" command to exit). It generates PyNaCl key pairs on connection and sends public keys to the server.
• Encryption: Leverages PyNaCl library; while end-to-end encryption (E2E) is not fully implemented yet, the infrastructure (key pair generation, public key storage) is in place.

Deployment steps:

1. Environment Prep: Install Python 3.7+ and dependencies: pip install asyncio pynacl.
2. Server Setup: Clone the project, modify ip_addr in server.py (127.0.0.1 for local test, 0.0.0.0 for LAN, public IP for internet), run python server.py (listens on port 8888 by default).
3. Client Connection: Modify server_ip and server_port in client.py, run python client.py, follow prompts to register/login, and start chatting (use "stop" to exit).
4. User Data: Server auto-creates users.json to store user info (can be backed up/migrated).

Current limitations:

• User Experience: Only command-line interface (CLI), which is less user-friendly for non-technical users.
• Functionality: E2E encryption is not fully implemented (messages are plaintext on the server).
• Stability: Potential bugs exist (author invites community feedback).

Future plans: Add graphical interface (GUI), complete E2E encryption, and improve stability.

LocalMessenger offers great learning value:

• Asyncio Practice: Demonstrates handling concurrent connections with Python async IO.
• Socket Programming: Implements direct TCP-based network communication.
• Security Basics: Shows password hashing (SHA-256) and public key infrastructure setup.
• Protocol Design: Simple text protocol and message routing logic.

It also reflects open-source spirit: sharing imperfect code for others to learn and improve. The author's use of AI assistance highlights modern human-AI collaboration in software development.

LocalMessenger may not become a mainstream IM app, but it proves the core principles of instant messaging are accessible. In an era of growing privacy concerns, a fully controllable local communication tool has unique value. It serves as a great learning resource, prototype for private IM systems, or internal communication solution for small teams. If you're interested in network programming or need a lightweight chat system, it's worth exploring.