{"id":49094060,"url":"https://github.com/rahul-deka/gupsup","last_synced_at":"2026-04-20T19:35:25.404Z","repository":{"id":308721912,"uuid":"1033748064","full_name":"rahul-deka/gupsup","owner":"rahul-deka","description":"Secure terminal chat app","archived":false,"fork":false,"pushed_at":"2025-09-15T10:31:47.000Z","size":74,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-30T23:47:20.596Z","etag":null,"topics":["chat","python","secure","terminal","websocket"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/gupsup/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rahul-deka.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-07T09:33:13.000Z","updated_at":"2025-09-15T10:31:50.000Z","dependencies_parsed_at":"2025-09-01T11:19:23.238Z","dependency_job_id":"8828e6e6-004b-46ca-bbae-1ed1d45e76ad","html_url":"https://github.com/rahul-deka/gupsup","commit_stats":null,"previous_names":["iamrahul21/terminalchat","iamrahul21/gupsup","rahul-deka/gupsup"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rahul-deka/gupsup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahul-deka%2Fgupsup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahul-deka%2Fgupsup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahul-deka%2Fgupsup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahul-deka%2Fgupsup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rahul-deka","download_url":"https://codeload.github.com/rahul-deka/gupsup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahul-deka%2Fgupsup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32062780,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat","python","secure","terminal","websocket"],"created_at":"2026-04-20T19:35:18.523Z","updated_at":"2026-04-20T19:35:25.398Z","avatar_url":"https://github.com/rahul-deka.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# gupsup\n\n\u003cem\u003eA secure terminal-based chat application with image sharing for real-time communication — right from your terminal.\u003c/em\u003e\n\n[![PyPI Downloads](https://static.pepy.tech/personalized-badge/gupsup?period=total\u0026units=NONE\u0026left_color=GREY\u0026right_color=BLUE\u0026left_text=downloads)](https://pepy.tech/projects/gupsup)\n[![PyPI version](https://img.shields.io/pypi/v/gupsup)](https://pypi.org/project/gupsup/)\n[![Python version](https://img.shields.io/pypi/pyversions/gupsup)](https://pypi.org/project/gupsup/)\n![GitHub repo size](https://img.shields.io/github/repo-size/rahul-deka/gupsup?label=size)\n![PyPI - License](https://img.shields.io/pypi/l/gupsup)\n\nLearn more and explore detailed info at [gupsup-cli](https://gupsup-cli.vercel.app/)\n\nLooking for the server? See [gupsup-server](https://github.com/rahul-deka/terminalchat-server)\n\u003c/div\u003e\n\n\n\n## ⚡ Quick Start\n\n```bash\npip install gupsup\ngupsup\n```\n\n[![PyPI](https://img.shields.io/pypi/v/gupsup?label=Install%20from%20PyPI)](https://pypi.org/project/gupsup/)\n\nThat's it! Start chatting instantly.\n\n## Features\n\n- **Zero-friction setup** - Just run `gupsup` and start chatting instantly\n- **End-to-end encryption** - AES-256-GCM encryption with PBKDF2 key derivation\n- **Image sharing** - Send and receive images (PNG, JPG, GIF, BMP, WebP) up to 2MB\n- **Secure channels** - Create private rooms with shareable 6-character codes  \n- **Auto-reconnection** - Handles network issues gracefully with smart retry logic\n- **Cross-platform** - Works seamlessly on Windows, macOS, Linux\n- **No account required** - Completely anonymous, no sign-up needed\n- **Smart image handling** - Automatic format detection, metadata preservation\n\n## Usage\n\n```bash\n# Install once\npip install gupsup\n\n# Run anywhere\ngupsup\n```\n\n### Example Session\n```\ngupsup - Secure Communication Channel\nChannel code (or 'new' to create): new\nChannel created: a4b2c1\nShare code 'a4b2c1' with others to join\nUsername: qwerty\n\nEstablishing connection...\n🟢 Connected to channel: a4b2c1\nCommands:\n  - Type messages to send\n  - '/image \u003cpath\u003e' to send image\n  - '/save [filename]' to save last received image\n  - 'quit' to exit\n\nqwerty: Hello world!\nmrrobot: Hey there!\nqwerty: /image photo.jpg\nProcessing image...\nImage sent: photo.jpg\nalice sent an image:\n   └─ File: vacation.png\n   └─ Type: image/png\n   └─ Size: 245.3KB\n   └─ Use '/save vacation.png' to save this image\nqwerty: /save my_vacation.png\nImage saved to: e:\\downloads\\my_vacation.png\nqwerty: quit\nTerminating session.\n```\n\n## How It Works\n\n1. **Create or join** a secure channel with a 6-character code\n2. **Share the code** with people you want to chat with\n3. **Chat securely** - messages are only sent to your channel\n4. **No persistence** - messages disappear when you disconnect\n\n## Security \u0026 Privacy\n\n- **Military-grade encryption** - AES-256-GCM with authenticated encryption\n- **Secure key derivation** - PBKDF2 with 100,000 iterations and SHA-256\n- **Channel isolation** - Each channel has its own unique encryption key\n- **Zero server knowledge** - Server cannot decrypt messages or images\n- **Ephemeral messaging** - No message storage, everything is real-time only\n- **Complete anonymity** - No accounts, no tracking, no data collection\n- **Perfect forward secrecy** - Unique nonces ensure message security\n\n### Encryption Technical Details\n- **Algorithm**: AES-256-GCM (Galois/Counter Mode)\n- **Key Size**: 256-bit encryption keys\n- **Nonce**: 96-bit random nonce per message\n- **Authentication**: Built-in message authentication\n- **Key Derivation**: PBKDF2-HMAC-SHA256 with 100k iterations\n\n### Development Install\n```bash\n# Clone the repository\ngit clone https://github.com/rahul-deka/gupsup.git\ncd gupsup\n\n# Install in development mode\npip install -e .\n\n# Run the application\ngupsup\n```\n\n### Server Setup (Optional)\n```bash\n# For hosting your own server\ngit clone https://github.com/rahul-deka/gupsup-server.git\ncd gupsup-server\npip install -r requirements.txt\npython main.py\n```\n\n## Available Commands\n\n### Chat Commands\n- **Send message**: Simply type your message and press Enter\n- **Exit**: `quit`, `exit`, `/quit`, or `/exit`\n- **Force quit**: Press `Ctrl+C`\n\n### Image Commands\n- **Send image**: `/image \u003cpath\u003e` \n  - Example: `/image ~/Pictures/photo.jpg`\n  - Example: `/image C:\\Users\\Me\\Desktop\\image.png`\n- **Save received image**: `/save [custom_filename]`\n  - Example: `/save` (uses original filename)\n  - Example: `/save my_photo.jpg` (custom filename)\n\n### Image Support Details\n\n| Feature | Details |\n|---------|---------|\n| **Formats** | PNG, JPG/JPEG, GIF, BMP, WebP |\n| **Size Limit** | 2MB per image (optimized for reliability) |\n| **Encryption** | Full end-to-end encryption like text messages |\n| **Metadata** | Filename, size, and MIME type preserved |\n| **Validation** | Automatic format detection and size checking |\n\n#### Image Usage Examples\n```bash\n# Send images\n/image path/photo.png\n\n# Save received images\n/save                    # Save with original name\n/save my_image.jpg       # Save with custom name\n/save folder/image.png   # Save to specific path\n```\n\n## 🛠️ Troubleshooting\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eConnection Issues\u003c/strong\u003e\u003c/summary\u003e\n\n**Symptoms**: Connection timeouts, frequent disconnects\n- First connection may be slow (server waking up)\n- Retry connection - should be faster on subsequent attempts\n- Check your internet connection\n- Verify the server is accessible\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eImage Problems\u003c/strong\u003e\u003c/summary\u003e\n\n**Large images failing**: \n- Ensure image is under 2MB\n- Use image compression tools if needed\n- Supported formats: PNG, JPG, GIF, BMP, WebP\n\n**Can't save images**:\n- Check file permissions in save directory\n- Ensure sufficient disk space\n- Try saving to a different location\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eEncryption Issues\u003c/strong\u003e\u003c/summary\u003e\n\n**Messages appear garbled**:\n- Ensure all users have the same channel code\n- Verify everyone is using the latest version\n- Try creating a new channel\n\n**Can't see messages**:\n- Confirm you're in the correct channel\n- Check if other users are actually connected\n- Restart the application\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePlatform-Specific Issues\u003c/strong\u003e\u003c/summary\u003e\n\n**Windows**: \n- Use PowerShell or Command Prompt\n- Ensure Python 3.8+ is installed\n\n**macOS/Linux**:\n- Use Terminal application\n- May need to install Python development headers\n- Check file path permissions for images\n\n\u003c/details\u003e\n\n## 📦 Package Information\n\n| Detail | Information |\n|--------|-------------|\n| **Package Name** | `gupsup` on PyPI |\n| **CLI Command** | `gupsup` |\n| **Python Version** | 3.8+ required |\n| **Dependencies** | `websockets\u003e=11.0`, `cryptography\u003e=3.0.0` |\n| **Size** | Ultra-lightweight (~50KB) |\n| **License** | MIT License |\n| **Latest Version** | 1.1.0 (with image support) |\n\n## Architecture\n\n```\n┌─────────────────┐    WebSocket     ┌──────────────────┐    Channel    ┌─────────────────┐\n│  Terminal       │ ←─────────────→  │  FastAPI         │ ←──────────→  │  Channel        │\n│  Client         │  (Encrypted)     │  Server          │   Management  │  Manager        │\n│  (gupsup)       │                  │                  │               │                 │\n└─────────────────┘                  └──────────────────┘               └─────────────────┘\n        ↑                                      ↑\n   AES-256-GCM                         Relay Only\n   Encryption                        (Cannot Decrypt)\n```\n\n### How Messages Flow:\n1. **Client A** encrypts message with channel key\n2. **Server** receives encrypted message (cannot decrypt)\n3. **Server** relays encrypted message to **Client B**\n4. **Client B** decrypts message with same channel key\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Simple. Secure. Terminal-native.**\n\nMIT License - use freely, contribute back. \n\n**[Rahul Deka](https://rahul-deka.vercel.app/)**\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahul-deka%2Fgupsup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frahul-deka%2Fgupsup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahul-deka%2Fgupsup/lists"}