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...
Requirements
- Python 3.10 or higher.
- An MTProto Client
- A Telegram API key.
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 py-tgcalls -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.
Release files for py-tgcalls 3.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| py_tgcalls-3.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Release files / py_tgcalls-3.0.0-py3-none-any.whl
| Download URL | py_tgcalls-3.0.0-py3-none-any.whl |
|---|---|
| Size | 85.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c736066f3f79804f6f128231f4adad228e6aefb3418a473e0a52175c0a8baf49
|
|
BLAKE2b-256 checksum How to use checksums |
de94e2a63c588d9caf3198ba9637d0ccff5c19895a9f7d50087f4679492df662
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log