velora-chat 1.1.0

Simple file sharing and chat over TCP sockets

Velora

Simple file sharing and chat over TCP sockets

A lightweight Python library for peer-to-peer file sharing and real-time chat. Zero external dependencies - pure Python using only the standard library.

Features

• 💬 Real-time text chat over TCP
• 📁 File sharing (any file type, up to 1GB)
• 🌐 Multiple connection modes (local, IP-based, global with ngrok)
• 🔧 Zero dependencies - pure Python
• ⚡ One-command file sharing
• 📦 Easy CLI and programmatic usage

Installation

pip install velora-chat

Quick Start

Start a chat server

velora server

Join a chat

velora chat

Share a file

velora share /path/to/file.pdf
velora share document.pdf 192.168.1.100:5003

Command Line Interface

Chat

# Interactive chat client
velora chat

# Connect to specific server
velora chat --host 192.168.1.100 --port 5003 --name "Your Name"

Server

velora server --host 0.0.0.0 --port 5003

File Sharing

# Local sharing
velora share document.pdf

# Remote sharing
velora share document.pdf 192.168.1.100:5003

# Share via ngrok
velora share document.pdf 0.tcp.ngrok.io:12345

Python API

import velora

# Start a server
server = velora.VeloraServer(host="0.0.0.0", port=5003)
server.start()

# Connect and send messages
client = velora.VeloraClient()
client.connect("127.0.0.1", 5003)
client.send_message("Hello!")

# Quick file sharing
velora.quick_share("/path/to/file.pdf", "192.168.1.100:5003", "YourName")

Connection Modes

Local Network: Connect devices on the same network

velora chat  # Choose option 1

IP-based: Connect across networks using IP addresses

velora chat --host 192.168.1.100

Global (ngrok): Share globally using ngrok tunneling

velora chat  # Choose option 3

In-Chat Commands

• Type any text to send a message
• /file /path/to/file.pdf - Share a file
• /quit - Exit the chat

Requirements

• Python 3.7+
• No external dependencies
• Port 5003 (default) or custom port

File Sharing Details

• Formats: Any file type
• Size limit: Up to 1GB
• Download location: ~/Downloads
• Duplicate handling: Automatic renaming

Documentation

For complete documentation, examples, and contribution guidelines, visit:

GitHub Repository

Links

• 📖 Full Documentation
• 🐛 Issue Tracker
• 💬 Discussions

License

MIT License - see LICENSE for details.

Security Notice

Designed for trusted networks and personal use. For production environments, consider adding authentication, encryption, input validation, and rate limiting.

---

Made with ❤️ by Pavan Sai Tanguturi