anthraleia-pytgcalls 1.0.2

Yet Another Async client API for the Telegram Calls.

A simple and elegant client that allows you to make group voice calls quickly and easily.
Examples • Documentation • PyPi • Channel • Chat

PyTgCalls

This project allows making Telegram call using MtProto and WebRTC, this is possible thanks to the power of NTgCalls library and @evgeny-nadymov

Example Usage

from pytgcalls import PyTgCalls
from pytgcalls import idle
...
chat_id = -1001185324811
app = PyTgCalls(client)
app.start()
app.play(
    chat_id,
    'http://docs.evostream.com/sample_content/assets/sintel1m720p.mp4',
)
idle()

Features

• Prebuilt wheels for macOS, Linux and Windows.
• Supporting all type of MTProto libraries: Pyrogram, Telethon and Hydrogram.
• Work with voice chats in channels and chats.
• Join as channels or chats.
• Mute/unmute, pause/resume, stop/play, volume control and more...
• 🆕 Advanced Memory Management: Automatic memory leak prevention and monitoring
• 🆕 Cache Optimization: Intelligent cache cleanup and management
• 🆕 Resource Cleanup: Proper shutdown and resource management

Memory Management Features

PyTgCalls now includes advanced memory management to prevent memory leaks:

# Initialize with memory management
call_py = PyTgCalls(
    app,
    enable_memory_manager=True,  # Enable automatic memory management
    memory_cleanup_interval=300,  # Cleanup every 5 minutes
    cache_duration=3600,  # Cache duration 1 hour
)

# Monitor memory usage
stats = call_py.get_memory_stats()
print(f"Memory Usage: {stats['usage']['rss_mb']:.1f} MB")

# Force cleanup
await call_py.force_cleanup()

# Proper shutdown
await call_py.shutdown()

For detailed memory management documentation, see MEMORY_MANAGEMENT.md.

Requirements

• Python 3.9 or higher.
• An MTProto Client
• A Telegram API key.
• Optional: psutil for memory monitoring features

How to install?

Here's how to install the PyTgCalls lib, the commands are given below:

# With Git
pip install git+https://github.com/pytgcalls/pytgcalls -U

# With PyPi (Recommended)
pip install anthraleia-pytgcalls -U

# With memory monitoring features
pip install "anthraleia-pytgcalls[memory-monitoring]" -U

Key Contributors

• @Laky-64 (DevOps Engineer, Software Architect):
  • Played a crucial role in developing PyTgCalls being an ex developer of pyservercall and of tgcallsjs.
  • Automation with GitHub Actions
• @kuogi (Senior UI/UX designer, Documenter):
  • As a Senior UI/UX Designer, Kuogi has significantly improved the user interface of our documentation, making it more visually appealing and user-friendly.
  • Played a key role in writing and structuring our documentation, ensuring that it is clear, informative, and accessible to all users.
• @vrumger (Senior Node.js Developer, Software Architect):
  • Has made important fixes and enhancements to the WebRTC component of the library, improving its stability and performance.
  • Main developer of TgCallsJS
• @alemidev (Senior Python Developer):
  • Has made important fixes and enhancements to the async part of the library

Junior Developers

• @TuriOG (Junior Python Developer):
  • Currently working on integrating NTgCalls into PyTgCalls, an important step in expanding the functionality and usability of the library.

Special Thanks

• @evgeny-nadymov: A heartfelt thank you to Evgeny Nadymov for graciously allowing us to use their code from telegram-react. His contribution has been pivotal to the success of this project.