Update README.md

README.md

@@ -1,384 +1,119 @@
+---
+title: Telegram File Streamer
+emoji: 🚀
+colorFrom: blue
+colorTo: purple
+sdk: docker
+pinned: false
+license: mit
+---
+
 # 🚀 Telegram Multi-Part File Streamer
 
-A high-performance file upload and streaming service that uses Telegram as a backend storage system. Capable of handling files up to **1TB** with zero-disk buffering, optimized for low-RAM environments like Hugging Face Spaces.
+A high-performance file upload and streaming service that uses Telegram as a backend storage system. Capable of handling files up to **1TB** with zero-disk buffering.
 
 ## ✨ Features
 
-- **🎯 Zero-Disk Buffering**: Direct streaming from HTTP to Telegram without local storage
+- **🎯 Zero-Disk Buffering**: Direct streaming from HTTP to Telegram
 - **📦 Auto-Splitting**: Automatically splits large files into 2GB parts
-- **⚡ Multi-Session Load Balancing**: Rotates between multiple Telegram sessions for maximum bandwidth
-- **📡 Full Range Request Support**: HTTP 206 partial content for seeking in 1TB files
-- **🔄 Parallel Download Support**: Compatible with IDM and multi-threaded downloaders
-- **💾 Low Memory Footprint**: Optimized for <512MB RAM usage even with 1TB files
-- **🛡️ Production Ready**: Comprehensive error handling, retry logic, and logging
-
-## 🏗️ Architecture
-
-```
-┌─────────────┐
-│  Client     │
-│  (Browser/  │
-│   IDM)      │
-└──────┬──────┘
-       │
-       │ HTTP Stream
-       │
-┌──────▼────────────────────────────┐
-│  FastAPI Server                   │
-│  ┌─────────────────────────────┐ │
-│  │  /upload (POST)             │ │
-│  │  - Stream from HTTP         │ │
-│  │  - Auto-split into parts    │ │
-│  │  - Upload to Telegram       │ │
-│  └─────────────────────────────┘ │
-│  ┌─────────────────────────────┐ │
-│  │  /dl/{id} (GET)             │ │
-│  │  - Multi-part concatenation │ │
-│  │  - Range request support    │ │
-│  │  - Session load balancing   │ │
-│  └─────────────────────────────┘ │
-└──────┬────────────────────────────┘
-       │
-       ├──────► Telegram Session 1
-       ├──────► Telegram Session 2
-       └──────► Telegram Session N
-                (Load Balanced)
-       
-       │
-┌──────▼──────┐
-│  MongoDB    │
-│  (Metadata) │
-└─────────────┘
-```
-
-## 📋 Requirements
-
-- Python 3.10+
-- MongoDB (local or Atlas)
-- Telegram API credentials
-- At least 512MB RAM
-
-## 🚀 Quick Start
-
-### 1. Clone and Setup
-
-```bash
-git clone <repository>
-cd telegram-streamer
-pip install -r requirements.txt
-```
-
-### 2. Configure Environment
-
-```bash
-cp .env.template .env
-# Edit .env with your credentials
-```
-
-Required environment variables:
-- `API_ID`: Your Telegram API ID
-- `API_HASH`: Your Telegram API Hash
-- `BOT_TOKEN`: Telegram bot token
-- `MONGO_URI`: MongoDB connection string
-- `SESSION_STRINGS`: (Optional) Comma-separated Pyrogram session strings
-
-### 3. Generate Session Strings (Optional but Recommended)
-
-For multi-session load balancing:
-
-```bash
-python -c "from pyrogram import Client; \
-client = Client('my_session', api_id=YOUR_API_ID, api_hash='YOUR_API_HASH'); \
-client.start(); \
-print(client.export_session_string())"
-```
+- **⚡ Multi-Session Load Balancing**: Maximum bandwidth with session rotation
+- **📡 Range Request Support**: HTTP 206 for seeking in large files
+- **🔄 Parallel Downloads**: IDM and multi-threaded downloader compatible
+- **💾 Low Memory**: Optimized for <512MB RAM usage
 
-Add the output to `SESSION_STRINGS` in your `.env` file.
+## 🔧 Required Secrets
 
-### 4. Run the Application
+This Space requires the following environment variables (add in Settings → Repository secrets):
 
-```bash
-# Development
-uvicorn main:app --reload
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `API_ID` | Telegram API ID | `12345678` |
+| `API_HASH` | Telegram API Hash | `abc123def456...` |
+| `BOT_TOKEN` | Bot Token from @BotFather | `1234567890:ABC...` |
+| `MONGO_URI` | MongoDB connection string | `mongodb+srv://...` |
+| `SESSION_STRINGS` | Session strings (optional) | `BQAB...,BQAC...` |
 
-# Production
-uvicorn main:app --host 0.0.0.0 --port 8000 --workers 1
-```
+### How to Get Credentials:
 
-### 5. Using Docker
+**Telegram API (API_ID & API_HASH):**
+1. Visit https://my.telegram.org/apps
+2. Login and create application
+3. Copy api_id and api_hash
 
-```bash
-# Build
-docker build -t telegram-streamer .
+**Bot Token:**
+1. Search @BotFather on Telegram
+2. Send `/newbot` command
+3. Copy bot token
 
-# Run
-docker run -p 8000:8000 --env-file .env telegram-streamer
-```
+**MongoDB:**
+- Free: MongoDB Atlas (https://www.mongodb.com/cloud/atlas)
+- Create cluster → Get connection string
 
 ## 📡 API Endpoints
 
 ### Upload File
-
-**POST** `/upload?filename=myfile.zip`
-
-Upload a file with zero-disk buffering:
-
 ```bash
-curl -X POST "http://localhost:8000/upload?filename=large_file.zip" \
-  -H "Content-Type: application/octet-stream" \
-  --data-binary "@large_file.zip"
-```
+POST /upload?filename=myfile.zip
 
-Response:
-```json
-{
-  "success": true,
-  "unique_id": "a1b2c3d4e5f6g7h8",
-  "filename": "large_file.zip",
-  "total_size": 1099511627776,
-  "parts": 550,
-  "download_url": "/dl/a1b2c3d4e5f6g7h8"
-}
+curl -X POST "https://YOUR-SPACE.hf.space/upload?filename=file.zip" \
+  -H "Content-Type: application/octet-stream" \
+  --data-binary "@file.zip"
 ```
 
-### Stream/Download File
-
-**GET** `/dl/{unique_id}`
-
-Stream a file with full range request support:
-
+### Download File
 ```bash
-# Full download
-curl "http://localhost:8000/dl/a1b2c3d4e5f6g7h8" -o output.zip
+GET /dl/{unique_id}
 
-# Range request (download bytes 1000000-2000000)
-curl "http://localhost:8000/dl/a1b2c3d4e5f6g7h8" \
-  -H "Range: bytes=1000000-2000000" -o partial.zip
+curl "https://YOUR-SPACE.hf.space/dl/{unique_id}" -o output.zip
 ```
 
 ### Get File Info
-
-**GET** `/info/{unique_id}`
-
 ```bash
-curl "http://localhost:8000/info/a1b2c3d4e5f6g7h8"
+GET /info/{unique_id}
 ```
 
-### Delete File
-
-**DELETE** `/delete/{unique_id}`
-
+### Health Check
 ```bash
-curl -X DELETE "http://localhost:8000/delete/a1b2c3d4e5f6g7h8"
-```
+GET /health
 
-## 🎯 Usage Examples
-
-### Upload with Python
-
-```python
-import requests
-
-url = "http://localhost:8000/upload"
-params = {"filename": "large_dataset.tar.gz"}
-
-with open("large_dataset.tar.gz", "rb") as f:
-    response = requests.post(url, params=params, data=f, stream=True)
-    
-print(response.json())
+curl "https://YOUR-SPACE.hf.space/health"
 ```
 
-### Download with Python
-
-```python
-import requests
-
-unique_id = "a1b2c3d4e5f6g7h8"
-url = f"http://localhost:8000/dl/{unique_id}"
-
-with requests.get(url, stream=True) as r:
-    r.raise_for_status()
-    with open("output.zip", "wb") as f:
-        for chunk in r.iter_content(chunk_size=8192):
-            f.write(chunk)
-```
-
-### Range Request Example
-
-```python
-import requests
-
-unique_id = "a1b2c3d4e5f6g7h8"
-url = f"http://localhost:8000/dl/{unique_id}"
-
-# Download only bytes 1MB to 10MB
-headers = {"Range": "bytes=1048576-10485760"}
-response = requests.get(url, headers=headers)
-
-with open("partial.bin", "wb") as f:
-    f.write(response.content)
-```
-
-## 🔧 Configuration
-
-### Environment Variables
-
-| Variable | Description | Required | Default |
-|----------|-------------|----------|---------|
-| `API_ID` | Telegram API ID | ✅ | - |
-| `API_HASH` | Telegram API Hash | ✅ | - |
-| `BOT_TOKEN` | Telegram Bot Token | ✅ | - |
-| `MONGO_URI` | MongoDB connection string | ✅ | - |
-| `MONGO_DATABASE` | Database name | ❌ | telegram_streamer |
-| `SESSION_STRINGS` | Comma-separated session strings | ❌ | (uses bot only) |
-| `LOG_LEVEL` | Logging level | ❌ | INFO |
-
-### Performance Tuning
-
-**For Maximum Upload Speed:**
-- Add multiple session strings to `SESSION_STRINGS`
-- Each session can handle ~10-15 MB/s upload speed
-- 5 sessions = ~50-75 MB/s combined
-
-**For Maximum Download Speed:**
-- Session rotation automatically balances load
-- Supports unlimited parallel connections
-- Compatible with IDM, aria2c, axel
-
-**Memory Optimization:**
-- Default chunk size: 1MB (adjustable via `CHUNK_SIZE`)
-- RAM usage stays constant regardless of file size
-- Recommended: 512MB RAM minimum
-
-## 🏆 Performance Benchmarks
+## 📊 Performance
 
 | Metric | Value |
 |--------|-------|
 | Max File Size | 1TB+ |
 | Upload Speed | 10-15 MB/s per session |
-| Download Speed | 50-100 MB/s (multi-threaded) |
-| RAM Usage | <512MB (constant) |
-| Concurrent Uploads | Limited by sessions |
-| Concurrent Downloads | Unlimited |
-
-## 🐛 Troubleshooting
+| Download Speed | 50-100 MB/s |
+| RAM Usage | <512MB constant |
 
-### FloodWait Errors
-
-If you encounter `FloodWait` errors:
-1. Add more session strings to `SESSION_STRINGS`
-2. Session rotation will automatically handle flood waits
-3. Consider adding delays between uploads
-
-### MongoDB Connection Issues
-
-```bash
-# Test MongoDB connection
-mongosh "YOUR_MONGO_URI"
-
-# Check if MongoDB is running (local)
-sudo systemctl status mongod
-```
+## ⚠️ Important
 
-### Session Initialization Failures
+- Ensure Telegram TOS compliance
+- Files stored in your Telegram account
+- Add multiple SESSION_STRINGS for better performance
+- MongoDB IP whitelist: 0.0.0.0/0
 
-1. Verify `API_ID` and `API_HASH` are correct
-2. Ensure session strings are valid
-3. Check Telegram API availability
-
-## 🌐 Deployment
-
-### Hugging Face Spaces
-
-1. Create a new Space (Docker type)
-2. Add Secrets in Space Settings:
-   - `API_ID`
-   - `API_HASH`
-   - `BOT_TOKEN`
-   - `MONGO_URI`
-   - `SESSION_STRINGS`
-3. Push code to Space repository
-4. App will auto-deploy
-
-### Railway/Render
-
-1. Connect GitHub repository
-2. Add environment variables
-3. Deploy (automatically detects Dockerfile)
-
-### VPS/Dedicated Server
-
-```bash
-# Using systemd
-sudo nano /etc/systemd/system/telegram-streamer.service
-
-[Unit]
-Description=Telegram Multi-Part File Streamer
-After=network.target
-
-[Service]
-Type=simple
-User=www-data
-WorkingDirectory=/opt/telegram-streamer
-EnvironmentFile=/opt/telegram-streamer/.env
-ExecStart=/usr/bin/uvicorn main:app --host 0.0.0.0 --port 8000
-Restart=always
-
-[Install]
-WantedBy=multi-user.target
-
-# Enable and start
-sudo systemctl enable telegram-streamer
-sudo systemctl start telegram-streamer
-```
-
-## 📊 Monitoring
-
-Check application health:
-
-```bash
-curl http://localhost:8000/health
-```
-
-Response:
-```json
-{
-  "status": "healthy",
-  "sessions": 5,
-  "database": "connected"
-}
-```
-
-## 🔒 Security Considerations
-
-1. **Access Control**: Add authentication middleware for production
-2. **Rate Limiting**: Implement rate limits on upload/download endpoints
-3. **Input Validation**: Validate filenames and parameters
-4. **HTTPS**: Always use HTTPS in production
-5. **Session Security**: Keep session strings private
-
-## 📝 License
-
-MIT License - See LICENSE file for details
-
-## 🤝 Contributing
+## 🐛 Troubleshooting
 
-Contributions are welcome! Please:
-1. Fork the repository
-2. Create a feature branch
-3. Submit a pull request
+**Build Failed:**
+- Check all secrets are set correctly
+- Verify MongoDB URI is valid
 
-## 📞 Support
+**FloodWait Errors:**
+- Add more SESSION_STRINGS
+- Use user sessions instead of bot only
 
-- Issues: GitHub Issues
-- Discussions: GitHub Discussions
+**Out of Memory:**
+- Upgrade Space hardware in Settings
 
-## 🙏 Acknowledgments
+## 📄 License
 
-- Built with [Pyrogram](https://docs.pyrogram.org/)
-- Powered by [FastAPI](https://fastapi.tiangolo.com/)
-- Storage: [MongoDB](https://www.mongodb.com/)
+MIT License
 
 ---
 
-**⚠️ Disclaimer**: This tool uses Telegram as a storage backend. Ensure compliance with Telegram's Terms of Service. Not recommended for storing illegal or copyrighted content.
+**Made with ❤️ for the community**
+
+*Disclaimer: Use responsibly and comply with Telegram's Terms of Service.*