<p align="center">
<img src="https://github.com/TgCaller/TgCaller/raw/main/assets/file_00000000b92c61f988c7c26e569da392_1_optimized_50.png" alt="TgCaller Banner" width="720">
</p>
<h1 align="center">TgCaller</h1>
<div align="center">
<p align="center">
<a href="https://pypi.org/project/tgcaller/">
<img src="https://img.shields.io/pypi/v/tgcaller?style=for-the-badge" alt="PyPI Version">
</a>
<a href="https://www.python.org/">
<img src="https://img.shields.io/badge/Python-3.8%2B-3776ab?style=for-the-badge&logo=python&logoColor=white" alt="Python Version">
</a>
<a href="https://github.com/tgcaller/TgCaller/blob/main/LICENSE">
<img src="https://img.shields.io/badge/License-MIT-00d4aa?style=for-the-badge" alt="License">
</a>
<a href="https://pypi.org/project/tgcaller/">
<img src="https://img.shields.io/pypi/dm/tgcaller?style=for-the-badge&color=blue" alt="Downloads">
</a>
<a href="https://github.com/TgCaller/TgCaller/stargazers">
<img src="https://img.shields.io/github/stars/TgCaller/TgCaller?style=for-the-badge&logo=github" alt="GitHub Stars">
</a>
<a href="https://github.com/TgCaller/TgCaller/network/members">
<img src="https://img.shields.io/github/forks/TgCaller/TgCaller?style=for-the-badge&logo=github" alt="GitHub Forks">
</a>
</p>
</div>
**Modern, Fast, and Reliable Telegram Group Calls Library**
*Built for developers who need a simple yet powerful solution for Telegram voice and video calls*
[**Documentation**](https://tgcaller.github.io/TgCaller/) • [**Examples**](https://github.com/tgcaller/tgcaller/tree/main/examples) • [**Community**](https://t.me/TgCallerOfficial) • [**Issues**](https://github.com/tgcaller/tgcaller/issues)
---
</div>
---
## Why TgCaller?
**TgCaller** is a next-generation Telegram group call engine — built for speed, reliability, and developer-first simplicity.
It delivers the performance you need, without the complexity you don’t.
---
### ✦ Fast & Lightweight
Engineered for optimal performance with minimal system usage. No bloat. No overhead.
### ✦ Easy to Use
A developer-friendly API that feels intuitive from the very first line of code.
### ✦ Stable by Default
Automatic reconnection, intelligent error handling, and smooth session management — all built-in.
### ✦ High-Quality Streaming
Stream crystal-clear audio and HD video seamlessly in Telegram group calls.
### ✦ Plugin-Based Architecture
Extend and customize core features effortlessly with a modular plugin system.
### ✦ Fully Documented
Complete guides, real-world examples, and full API references to support every stage of development.
### ✦ Built-In Power Tools
Includes advanced capabilities like YouTube streaming, Whisper transcription, and media filters — ready to go.
---
> TgCaller isn’t just simple to adopt — it’s designed to grow with your vision.
---
## **Quick Start**
### **Installation**
```bash
# Install from PyPI
pip install tgcaller
# Install with video support
pip install tgcaller[media]
# Install with all features
pip install tgcaller[all]
```
### **Verify Installation**
```bash
# Test installation
tgcaller test
# Check system info
tgcaller info
```
**Expected Output:**
```
Testing TgCaller installation...
Pyrogram imported successfully
TgCaller types imported successfully
TgCaller installation test completed successfully!
```
### **Basic Usage**
```python
import asyncio
from pyrogram import Client
from tgcaller import TgCaller
# Initialize
app = Client("my_session", api_id=API_ID, api_hash=API_HASH)
caller = TgCaller(app)
@caller.on_stream_end
async def on_stream_end(client, update):
print(f"Stream ended in {update.chat_id}")
async def main():
await caller.start()
# Join voice call
await caller.join_call(-1001234567890)
# Play audio
await caller.play(-1001234567890, "song.mp3")
# Play video
await caller.play(-1001234567890, "video.mp4")
if __name__ == "__main__":
asyncio.run(main())
```
---
## **Audio Features**
```python
from tgcaller import AudioConfig
# High-quality audio
audio_config = AudioConfig(
bitrate=128000, # 128 kbps
sample_rate=48000, # 48 kHz
channels=2, # Stereo
noise_suppression=True, # Clean audio
echo_cancellation=True # No echo
)
await caller.play(chat_id, "audio.mp3", audio_config=audio_config)
```
## **Video Features**
```python
from tgcaller import VideoConfig
# HD video streaming
video_config = VideoConfig(
width=1920,
height=1080,
fps=30,
bitrate=2000000, # 2 Mbps
codec="h264"
)
await caller.play(chat_id, "video.mp4", video_config=video_config)
```
---
## **Advanced Features**
### ** Bridged Calls**
Connect multiple chats for conference calls:
```python
from tgcaller.advanced import BridgedCallManager
bridge_manager = BridgedCallManager(caller)
await bridge_manager.create_bridge("conference", [chat1, chat2, chat3])
```
### ** Microphone Streaming**
Stream live microphone input:
```python
from tgcaller.advanced import MicrophoneStreamer
mic_streamer = MicrophoneStreamer(caller, chat_id)
await mic_streamer.start_streaming()
```
### ** Screen Sharing**
Share your screen in video calls:
```python
from tgcaller.advanced import ScreenShareStreamer
screen_streamer = ScreenShareStreamer(caller, chat_id)
await screen_streamer.start_streaming(monitor_index=1)
```
### ** YouTube Integration**
Stream YouTube videos directly:
```python
from tgcaller.advanced import YouTubeStreamer
youtube = YouTubeStreamer(caller)
await youtube.play_youtube_url(chat_id, "https://youtube.com/watch?v=...")
```
### ** Speech Transcription**
Real-time speech-to-text with Whisper:
```python
from tgcaller.advanced import WhisperTranscription
transcriber = WhisperTranscription("base")
await transcriber.start_transcription()
```
### ** Audio/Video Filters**
Apply real-time effects:
```python
from tgcaller.advanced import AudioFilters, VideoFilters
audio_filters = AudioFilters()
video_filters = VideoFilters()
# Add echo effect
filtered_audio = audio_filters.apply_echo(audio_data, delay=0.3)
# Add blur effect
filtered_video = video_filters.apply_blur(video_frame, kernel_size=15)
```
### ** Custom API**
Extend with REST API:
```python
from tgcaller.advanced import CustomAPIHandler
api = CustomAPIHandler(caller, port=8080)
await api.start_server()
# Now you can control via HTTP:
# POST /play {"chat_id": -1001234567890, "source": "song.mp3"}
```
---
## **CLI Tool**
TgCaller comes with a built-in CLI tool for testing and management:
```bash
# Show help
tgcaller --help
# Test installation
tgcaller test --api-id YOUR_API_ID --api-hash YOUR_API_HASH
# Show system information
tgcaller info
```
**CLI Commands:**
- `tgcaller test` - Test TgCaller installation
- `tgcaller info` - Show system information
- `tgcaller --version` - Show version
---
## **Examples**
### **Music Bot**
```python
from tgcaller import TgCaller
from pyrogram import Client, filters
app = Client("music_bot")
caller = TgCaller(app)
@app.on_message(filters.command("play"))
async def play_music(client, message):
if len(message.command) < 2:
return await message.reply("Usage: /play <song_name>")
song = message.command[1]
# Join call if not already joined
if not caller.is_connected(message.chat.id):
await caller.join_call(message.chat.id)
# Play song
await caller.play(message.chat.id, f"music/{song}.mp3")
await message.reply(f" Playing: {song}")
@caller.on_stream_end
async def next_song(client, update):
# Auto-play next song logic here
pass
app.run()
```
### **Advanced Conference Bot**
```python
from tgcaller.advanced import BridgedCallManager, WhisperTranscription
# Create conference bridge
bridge_manager = BridgedCallManager(caller)
await bridge_manager.create_bridge("meeting", [chat1, chat2, chat3])
# Add real-time transcription
transcriber = WhisperTranscription("base")
await transcriber.start_transcription()
```
---
## **Docker Support**
```dockerfile
FROM python:3.11-slim
# Install system dependencies
RUN apt-get update && apt-get install -y \
ffmpeg \
libopus-dev \
&& rm -rf /var/lib/apt/lists/*
# Install TgCaller
RUN pip install tgcaller[all]
# Copy your bot
COPY . /app
WORKDIR /app
CMD ["python", "bot.py"]
```
**Docker Compose:**
```yaml
version: '3.8'
services:
tgcaller-bot:
build: .
environment:
- API_ID=${API_ID}
- API_HASH=${API_HASH}
- BOT_TOKEN=${BOT_TOKEN}
volumes:
- ./downloads:/app/downloads
ports:
- "8080:8080"
```
---
## **Performance**
| Feature | TgCaller | pytgcalls | Improvement |
|---------|----------|-----------|-------------|
| **Connection Time** | ~1s | ~3s | 3x faster |
| **Memory Usage** | 80MB | 150MB | 47% less |
| **CPU Usage** | Low | High | 60% less |
| **Error Rate** | <2% | ~8% | 4x more reliable |
| **Features** | 25+ | 10 | 2.5x more |
---
## **Advanced Configuration**
### **FFmpeg Parameters**
```python
from tgcaller import TgCaller
caller = TgCaller(app, ffmpeg_parameters={
'before_options': '-re',
'options': '-vn -preset ultrafast'
})
```
### **Multiple Clients**
```python
# Manage multiple Telegram accounts
clients = [Client(f"session_{i}") for i in range(5)]
callers = [TgCaller(client) for client in clients]
# Start all
for caller in callers:
await caller.start()
```
### **P2P Calls**
```python
from tgcaller.advanced import P2PCallManager
p2p = P2PCallManager(caller)
await p2p.create_direct_call(user1_id, user2_id)
```
---
## **Dependencies**
**Core Dependencies:**
- `pyrogram>=2.0.106` - Telegram client
- `aiortc>=1.6.0` - WebRTC support
- `aiofiles>=23.1.0` - Async file operations
- `aiohttp>=3.8.4` - HTTP client
**Media Processing:**
- `ffmpeg-python>=0.2.0` - Media processing
- `numpy>=1.24.0` - Audio/video arrays
- `opencv-python>=4.7.0` - Video processing
**Audio Processing:**
- `pyaudio>=0.2.11` - Audio I/O
- `soundfile>=0.12.1` - Audio file handling
**Advanced Features:**
- `openai-whisper` - Speech transcription
- `yt-dlp>=2023.6.22` - YouTube downloading
- `mss` - Screen capture
**Optional:**
- `TgCrypto` - For faster Pyrogram performance
---
## **Development**
### **Setup**
```bash
git clone https://github.com/tgcaller/tgcaller.git
cd tgcaller
# Create virtual environment
python -m venv venv
source venv/bin/activate
# Install in development mode
pip install -e ".[dev]"
# Run tests
pytest tests/ -v
```
### **Testing**
```bash
# Run all tests
pytest
# Test with coverage
pytest --cov=tgcaller tests/
# Test installation
tgcaller test
```
### **Contributing**
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request
---
## **Documentation**
- **[API Reference](https://tgcaller.readthedocs.io/api)** - Complete API documentation
- **[Examples](https://github.com/tgcaller/tgcaller/tree/main/examples)** - Code examples and tutorials
- **[Migration Guide](https://tgcaller.readthedocs.io/migration)** - Migrate from pytgcalls
- **[Plugin Development](https://tgcaller.readthedocs.io/plugins)** - Create custom plugins
- **[Advanced Features](https://tgcaller.readthedocs.io/advanced)** - Professional features guide
---
## **Community**
- **[Telegram Group](https://t.me/tgcaller_support)** - Get help and discuss
- **[GitHub Discussions](https://github.com/tgcaller/tgcaller/discussions)** - Feature requests and ideas
- **[GitHub Issues](https://github.com/tgcaller/tgcaller/issues)** - Bug reports
---
## **License**
This project is licensed under the MIT License - see the [LICENSE](https://github.com/tgcaller/tgcaller/blob/main/LICENSE) file for details.
---
## 💖 Sponsor
<p align="center">
<a href="https://jhoommusic.com" target="_blank">
<img src="https://github.com/TgCaller/TgCaller/raw/main/assets/Designer%20(16).jpeg" alt="Jhoommusic Banner" width="100%">
</a>
<br>
<i>Crafted with ❤️ by Jhoommusic — blending community spirit with professional-grade audio & video streaming for Telegram bots.</i>
</p>
Raw data
{
"_id": null,
"home_page": null,
"name": "tgcaller",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "TgCaller Team <team@tgcaller.dev>",
"keywords": "telegram, calls, voip, streaming, audio, video, pytgcalls, alternative, modern, fast, reliable, screen-sharing, transcription, youtube, microphone, bridged-calls, filters, advanced",
"author": null,
"author_email": "TgCaller Team <team@tgcaller.dev>",
"download_url": "https://files.pythonhosted.org/packages/0f/b6/5ad4ec6693ccff8d445a3f236f07aaec5e1bc5054f489951f2855d8b44e3/tgcaller-1.0.3.tar.gz",
"platform": null,
"description": "\n<p align=\"center\">\n <img src=\"https://github.com/TgCaller/TgCaller/raw/main/assets/file_00000000b92c61f988c7c26e569da392_1_optimized_50.png\" alt=\"TgCaller Banner\" width=\"720\">\n</p>\n\n<h1 align=\"center\">TgCaller</h1>\n\n<div align=\"center\">\n\n<p align=\"center\">\n <a href=\"https://pypi.org/project/tgcaller/\">\n <img src=\"https://img.shields.io/pypi/v/tgcaller?style=for-the-badge\" alt=\"PyPI Version\">\n </a>\n <a href=\"https://www.python.org/\">\n <img src=\"https://img.shields.io/badge/Python-3.8%2B-3776ab?style=for-the-badge&logo=python&logoColor=white\" alt=\"Python Version\">\n </a>\n <a href=\"https://github.com/tgcaller/TgCaller/blob/main/LICENSE\">\n <img src=\"https://img.shields.io/badge/License-MIT-00d4aa?style=for-the-badge\" alt=\"License\">\n </a>\n <a href=\"https://pypi.org/project/tgcaller/\">\n <img src=\"https://img.shields.io/pypi/dm/tgcaller?style=for-the-badge&color=blue\" alt=\"Downloads\">\n </a>\n <a href=\"https://github.com/TgCaller/TgCaller/stargazers\">\n <img src=\"https://img.shields.io/github/stars/TgCaller/TgCaller?style=for-the-badge&logo=github\" alt=\"GitHub Stars\">\n </a>\n <a href=\"https://github.com/TgCaller/TgCaller/network/members\">\n <img src=\"https://img.shields.io/github/forks/TgCaller/TgCaller?style=for-the-badge&logo=github\" alt=\"GitHub Forks\">\n </a>\n</p>\n\n</div>\n\n\n**Modern, Fast, and Reliable Telegram Group Calls Library**\n\n*Built for developers who need a simple yet powerful solution for Telegram voice and video calls*\n\n[**Documentation**](https://tgcaller.github.io/TgCaller/) \u2022 [**Examples**](https://github.com/tgcaller/tgcaller/tree/main/examples) \u2022 [**Community**](https://t.me/TgCallerOfficial) \u2022 [**Issues**](https://github.com/tgcaller/tgcaller/issues)\n\n---\n\n</div>\n\n---\n\n\n## Why TgCaller?\n\n**TgCaller** is a next-generation Telegram group call engine \u2014 built for speed, reliability, and developer-first simplicity. \nIt delivers the performance you need, without the complexity you don\u2019t.\n\n---\n\n### \u2726 Fast & Lightweight \nEngineered for optimal performance with minimal system usage. No bloat. No overhead.\n\n### \u2726 Easy to Use \nA developer-friendly API that feels intuitive from the very first line of code.\n\n### \u2726 Stable by Default \nAutomatic reconnection, intelligent error handling, and smooth session management \u2014 all built-in.\n\n### \u2726 High-Quality Streaming \nStream crystal-clear audio and HD video seamlessly in Telegram group calls.\n\n### \u2726 Plugin-Based Architecture \nExtend and customize core features effortlessly with a modular plugin system.\n\n### \u2726 Fully Documented \nComplete guides, real-world examples, and full API references to support every stage of development.\n\n### \u2726 Built-In Power Tools \nIncludes advanced capabilities like YouTube streaming, Whisper transcription, and media filters \u2014 ready to go.\n\n---\n\n> TgCaller isn\u2019t just simple to adopt \u2014 it\u2019s designed to grow with your vision.\n\n---\n\n## **Quick Start**\n\n### **Installation**\n\n```bash\n# Install from PyPI\npip install tgcaller\n\n# Install with video support\npip install tgcaller[media]\n\n# Install with all features\npip install tgcaller[all]\n```\n\n### **Verify Installation**\n\n```bash\n# Test installation\ntgcaller test\n\n# Check system info\ntgcaller info\n```\n\n**Expected Output:**\n```\n Testing TgCaller installation...\n Pyrogram imported successfully\n TgCaller types imported successfully\n TgCaller installation test completed successfully!\n```\n\n### **Basic Usage**\n\n```python\nimport asyncio\nfrom pyrogram import Client\nfrom tgcaller import TgCaller\n\n# Initialize\napp = Client(\"my_session\", api_id=API_ID, api_hash=API_HASH)\ncaller = TgCaller(app)\n\n@caller.on_stream_end\nasync def on_stream_end(client, update):\n print(f\"Stream ended in {update.chat_id}\")\n\nasync def main():\n await caller.start()\n \n # Join voice call\n await caller.join_call(-1001234567890)\n \n # Play audio\n await caller.play(-1001234567890, \"song.mp3\")\n \n # Play video\n await caller.play(-1001234567890, \"video.mp4\")\n\nif __name__ == \"__main__\":\n asyncio.run(main())\n```\n\n---\n\n## **Audio Features**\n\n```python\nfrom tgcaller import AudioConfig\n\n# High-quality audio\naudio_config = AudioConfig(\n bitrate=128000, # 128 kbps\n sample_rate=48000, # 48 kHz\n channels=2, # Stereo\n noise_suppression=True, # Clean audio\n echo_cancellation=True # No echo\n)\n\nawait caller.play(chat_id, \"audio.mp3\", audio_config=audio_config)\n```\n\n## **Video Features**\n\n```python\nfrom tgcaller import VideoConfig\n\n# HD video streaming\nvideo_config = VideoConfig(\n width=1920,\n height=1080,\n fps=30,\n bitrate=2000000, # 2 Mbps\n codec=\"h264\"\n)\n\nawait caller.play(chat_id, \"video.mp4\", video_config=video_config)\n```\n\n---\n\n## **Advanced Features**\n\n### ** Bridged Calls**\nConnect multiple chats for conference calls:\n\n```python\nfrom tgcaller.advanced import BridgedCallManager\n\nbridge_manager = BridgedCallManager(caller)\nawait bridge_manager.create_bridge(\"conference\", [chat1, chat2, chat3])\n```\n\n### ** Microphone Streaming**\nStream live microphone input:\n\n```python\nfrom tgcaller.advanced import MicrophoneStreamer\n\nmic_streamer = MicrophoneStreamer(caller, chat_id)\nawait mic_streamer.start_streaming()\n```\n\n### ** Screen Sharing**\nShare your screen in video calls:\n\n```python\nfrom tgcaller.advanced import ScreenShareStreamer\n\nscreen_streamer = ScreenShareStreamer(caller, chat_id)\nawait screen_streamer.start_streaming(monitor_index=1)\n```\n\n### ** YouTube Integration**\nStream YouTube videos directly:\n\n```python\nfrom tgcaller.advanced import YouTubeStreamer\n\nyoutube = YouTubeStreamer(caller)\nawait youtube.play_youtube_url(chat_id, \"https://youtube.com/watch?v=...\")\n```\n\n### ** Speech Transcription**\nReal-time speech-to-text with Whisper:\n\n```python\nfrom tgcaller.advanced import WhisperTranscription\n\ntranscriber = WhisperTranscription(\"base\")\nawait transcriber.start_transcription()\n```\n\n### ** Audio/Video Filters**\nApply real-time effects:\n\n```python\nfrom tgcaller.advanced import AudioFilters, VideoFilters\n\naudio_filters = AudioFilters()\nvideo_filters = VideoFilters()\n\n# Add echo effect\nfiltered_audio = audio_filters.apply_echo(audio_data, delay=0.3)\n\n# Add blur effect\nfiltered_video = video_filters.apply_blur(video_frame, kernel_size=15)\n```\n\n### ** Custom API**\nExtend with REST API:\n\n```python\nfrom tgcaller.advanced import CustomAPIHandler\n\napi = CustomAPIHandler(caller, port=8080)\nawait api.start_server()\n\n# Now you can control via HTTP:\n# POST /play {\"chat_id\": -1001234567890, \"source\": \"song.mp3\"}\n```\n\n---\n\n## **CLI Tool**\n\nTgCaller comes with a built-in CLI tool for testing and management:\n\n```bash\n# Show help\ntgcaller --help\n\n# Test installation\ntgcaller test --api-id YOUR_API_ID --api-hash YOUR_API_HASH\n\n# Show system information\ntgcaller info\n```\n\n**CLI Commands:**\n- `tgcaller test` - Test TgCaller installation\n- `tgcaller info` - Show system information\n- `tgcaller --version` - Show version\n\n---\n\n## **Examples**\n\n### **Music Bot**\n\n```python\nfrom tgcaller import TgCaller\nfrom pyrogram import Client, filters\n\napp = Client(\"music_bot\")\ncaller = TgCaller(app)\n\n@app.on_message(filters.command(\"play\"))\nasync def play_music(client, message):\n if len(message.command) < 2:\n return await message.reply(\"Usage: /play <song_name>\")\n \n song = message.command[1]\n \n # Join call if not already joined\n if not caller.is_connected(message.chat.id):\n await caller.join_call(message.chat.id)\n \n # Play song\n await caller.play(message.chat.id, f\"music/{song}.mp3\")\n await message.reply(f\" Playing: {song}\")\n\n@caller.on_stream_end\nasync def next_song(client, update):\n # Auto-play next song logic here\n pass\n\napp.run()\n```\n\n### **Advanced Conference Bot**\n\n```python\nfrom tgcaller.advanced import BridgedCallManager, WhisperTranscription\n\n# Create conference bridge\nbridge_manager = BridgedCallManager(caller)\nawait bridge_manager.create_bridge(\"meeting\", [chat1, chat2, chat3])\n\n# Add real-time transcription\ntranscriber = WhisperTranscription(\"base\")\nawait transcriber.start_transcription()\n```\n\n---\n\n## **Docker Support**\n\n```dockerfile\nFROM python:3.11-slim\n\n# Install system dependencies\nRUN apt-get update && apt-get install -y \\\n ffmpeg \\\n libopus-dev \\\n && rm -rf /var/lib/apt/lists/*\n\n# Install TgCaller\nRUN pip install tgcaller[all]\n\n# Copy your bot\nCOPY . /app\nWORKDIR /app\n\nCMD [\"python\", \"bot.py\"]\n```\n\n**Docker Compose:**\n\n```yaml\nversion: '3.8'\nservices:\n tgcaller-bot:\n build: .\n environment:\n - API_ID=${API_ID}\n - API_HASH=${API_HASH}\n - BOT_TOKEN=${BOT_TOKEN}\n volumes:\n - ./downloads:/app/downloads\n ports:\n - \"8080:8080\"\n```\n\n---\n\n## **Performance**\n\n| Feature | TgCaller | pytgcalls | Improvement |\n|---------|----------|-----------|-------------|\n| **Connection Time** | ~1s | ~3s | 3x faster |\n| **Memory Usage** | 80MB | 150MB | 47% less |\n| **CPU Usage** | Low | High | 60% less |\n| **Error Rate** | <2% | ~8% | 4x more reliable |\n| **Features** | 25+ | 10 | 2.5x more |\n\n---\n\n## **Advanced Configuration**\n\n### **FFmpeg Parameters**\n\n```python\nfrom tgcaller import TgCaller\n\ncaller = TgCaller(app, ffmpeg_parameters={\n 'before_options': '-re',\n 'options': '-vn -preset ultrafast'\n})\n```\n\n### **Multiple Clients**\n\n```python\n# Manage multiple Telegram accounts\nclients = [Client(f\"session_{i}\") for i in range(5)]\ncallers = [TgCaller(client) for client in clients]\n\n# Start all\nfor caller in callers:\n await caller.start()\n```\n\n### **P2P Calls**\n\n```python\nfrom tgcaller.advanced import P2PCallManager\n\np2p = P2PCallManager(caller)\nawait p2p.create_direct_call(user1_id, user2_id)\n```\n\n---\n\n## **Dependencies**\n\n**Core Dependencies:**\n- `pyrogram>=2.0.106` - Telegram client\n- `aiortc>=1.6.0` - WebRTC support\n- `aiofiles>=23.1.0` - Async file operations\n- `aiohttp>=3.8.4` - HTTP client\n\n**Media Processing:**\n- `ffmpeg-python>=0.2.0` - Media processing\n- `numpy>=1.24.0` - Audio/video arrays\n- `opencv-python>=4.7.0` - Video processing\n\n**Audio Processing:**\n- `pyaudio>=0.2.11` - Audio I/O\n- `soundfile>=0.12.1` - Audio file handling\n\n**Advanced Features:**\n- `openai-whisper` - Speech transcription\n- `yt-dlp>=2023.6.22` - YouTube downloading\n- `mss` - Screen capture\n\n**Optional:**\n- `TgCrypto` - For faster Pyrogram performance\n\n---\n\n## **Development**\n\n### **Setup**\n\n```bash\ngit clone https://github.com/tgcaller/tgcaller.git\ncd tgcaller\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate\n\n# Install in development mode\npip install -e \".[dev]\"\n\n# Run tests\npytest tests/ -v\n```\n\n### **Testing**\n\n```bash\n# Run all tests\npytest\n\n# Test with coverage\npytest --cov=tgcaller tests/\n\n# Test installation\ntgcaller test\n```\n\n### **Contributing**\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests\n5. Submit a pull request\n\n---\n\n## **Documentation**\n\n- **[API Reference](https://tgcaller.readthedocs.io/api)** - Complete API documentation\n- **[Examples](https://github.com/tgcaller/tgcaller/tree/main/examples)** - Code examples and tutorials\n- **[Migration Guide](https://tgcaller.readthedocs.io/migration)** - Migrate from pytgcalls\n- **[Plugin Development](https://tgcaller.readthedocs.io/plugins)** - Create custom plugins\n- **[Advanced Features](https://tgcaller.readthedocs.io/advanced)** - Professional features guide\n\n---\n\n## **Community**\n\n- **[Telegram Group](https://t.me/tgcaller_support)** - Get help and discuss\n- **[GitHub Discussions](https://github.com/tgcaller/tgcaller/discussions)** - Feature requests and ideas\n- **[GitHub Issues](https://github.com/tgcaller/tgcaller/issues)** - Bug reports\n\n---\n\n## **License**\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/tgcaller/tgcaller/blob/main/LICENSE) file for details.\n\n---\n## \ud83d\udc96 Sponsor\n\n<p align=\"center\">\n <a href=\"https://jhoommusic.com\" target=\"_blank\">\n <img src=\"https://github.com/TgCaller/TgCaller/raw/main/assets/Designer%20(16).jpeg\" alt=\"Jhoommusic Banner\" width=\"100%\">\n </a>\n <br>\n <i>Crafted with \u2764\ufe0f by Jhoommusic \u2014 blending community spirit with professional-grade audio & video streaming for Telegram bots.</i>\n</p>\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Modern, fast, and reliable Telegram group calls library with advanced features",
"version": "1.0.3",
"project_urls": {
"Community": "https://t.me/TgCallerOfficial",
"Documentation": "https://tgcaller.github.io/TgCaller/",
"Homepage": "https://github.com/tgcaller/tgcaller",
"Issues": "https://github.com/tgcaller/tgcaller/issues",
"Repository": "https://github.com/tgcaller/tgcaller"
},
"split_keywords": [
"telegram",
" calls",
" voip",
" streaming",
" audio",
" video",
" pytgcalls",
" alternative",
" modern",
" fast",
" reliable",
" screen-sharing",
" transcription",
" youtube",
" microphone",
" bridged-calls",
" filters",
" advanced"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1e642c0d7c46710a459d723cb4a36a5cc425ce0f21221aec3679f5e65dd37b95",
"md5": "802c795f95a0daae1bd65e358665d2d3",
"sha256": "a26d1388641354784217189444fb06b10158f664d29476ee4a72abf75010631c"
},
"downloads": -1,
"filename": "tgcaller-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "802c795f95a0daae1bd65e358665d2d3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 45855,
"upload_time": "2025-07-20T03:12:19",
"upload_time_iso_8601": "2025-07-20T03:12:19.276903Z",
"url": "https://files.pythonhosted.org/packages/1e/64/2c0d7c46710a459d723cb4a36a5cc425ce0f21221aec3679f5e65dd37b95/tgcaller-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0fb65ad4ec6693ccff8d445a3f236f07aaec5e1bc5054f489951f2855d8b44e3",
"md5": "ff1d3e60a46ffd3c6f4b3b5641d57556",
"sha256": "7733345035551f06453c72e2e11c66f1e407a0a3cee0573bff7032dad52fb00e"
},
"downloads": -1,
"filename": "tgcaller-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "ff1d3e60a46ffd3c6f4b3b5641d57556",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 87849,
"upload_time": "2025-07-20T03:12:20",
"upload_time_iso_8601": "2025-07-20T03:12:20.697321Z",
"url": "https://files.pythonhosted.org/packages/0f/b6/5ad4ec6693ccff8d445a3f236f07aaec5e1bc5054f489951f2855d8b44e3/tgcaller-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-20 03:12:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tgcaller",
"github_project": "tgcaller",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pyrogram",
"specs": [
[
">=",
"2.0.106"
]
]
},
{
"name": "aiortc",
"specs": [
[
">=",
"1.6.0"
]
]
},
{
"name": "aiofiles",
"specs": [
[
">=",
"23.1.0"
]
]
},
{
"name": "aiohttp",
"specs": [
[
">=",
"3.8.4"
]
]
},
{
"name": "ffmpeg-python",
"specs": [
[
">=",
"0.2.0"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.24.0"
]
]
},
{
"name": "pyaudio",
"specs": [
[
">=",
"0.2.11"
]
]
},
{
"name": "soundfile",
"specs": [
[
">=",
"0.12.1"
]
]
},
{
"name": "opencv-python",
"specs": [
[
">=",
"4.7.0"
]
]
},
{
"name": "imageio",
"specs": [
[
">=",
"2.28.0"
]
]
},
{
"name": "mss",
"specs": [
[
">=",
"9.0.1"
]
]
},
{
"name": "yt-dlp",
"specs": [
[
">=",
"2023.6.22"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.31.0"
]
]
},
{
"name": "openai-whisper",
"specs": [
[
">=",
"20231117"
]
]
},
{
"name": "asyncio-throttle",
"specs": [
[
">=",
"1.0.2"
]
]
},
{
"name": "uvloop",
"specs": [
[
">=",
"0.17.0"
]
]
},
{
"name": "loguru",
"specs": [
[
">=",
"0.7.0"
]
]
},
{
"name": "psutil",
"specs": [
[
">=",
"5.9.5"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"1.10.8"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
">=",
"1.0.0"
]
]
},
{
"name": "aiohttp",
"specs": [
[
">=",
"3.8.4"
]
]
},
{
"name": "rich",
"specs": [
[
">=",
"13.0.0"
]
]
},
{
"name": "pyfiglet",
"specs": [
[
">=",
"0.8.0"
]
]
},
{
"name": "colorama",
"specs": [
[
">=",
"0.4.6"
]
]
},
{
"name": "black",
"specs": [
[
">=",
"23.3.0"
]
]
},
{
"name": "isort",
"specs": [
[
">=",
"5.12.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"7.3.1"
]
]
},
{
"name": "pytest-asyncio",
"specs": [
[
">=",
"0.21.0"
]
]
}
],
"lcname": "tgcaller"
}
JSON
