pyvibe
Python client library for Vibe Messenger (vibegram.chat). MTProto over WebSocket with Vibe's custom authentication scheme.
About the Author
- Name: Ali VEX
- Email: lyrdaadhrpyk802@gmail.com
- GitHub: lyrdaadhrpyk802-ux
- Jabber: @UserBoT
(درباره سازنده: علی، توسعهدهنده پایتون. این پروژه در محیط Termux اندروید بدون روت توسعه یافته است.)
Project Status
- 852 high-level methods available directly on VibeClient.
- Full passthrough to 875 Telethon TL requests (raw API).
- Verified end-to-end: Login, Messaging, Media, Stories, Forums, JSON Backups.
(وضعیت پروژه: کتابخانه به صورت کامل روی سرور Vibe تست شده است. احراز هویت اختصاصی Vibe، ارسال و دریافت مدیا، استوری، فروم و بکاپگیری کاملاً عملیاتی هستند.)
Installation
cd pyvibe pip install -e .
Quick Start
import asyncio from userapi import VibeClient
async def main(): c = VibeClient() await c.connect()
if not await c.is_authorized():
phone = input("Phone: ")
await c.request_code(phone)
code = input("OTP: ")
await c.sign_in(phone, code)
me = await c.get_me()
print(f"Logged in as {me.first_name}")
await c.send_message("me", "Hello from pyvibe")
await c.disconnect()
asyncio.run(main())
Documentation
- ARCHITECTURE.md - Technical details of transport and auth.
- VIBE_COMPAT.md - Feature support matrix.
- examples/ - 11 guided examples with Persian comments.
Development Notes (Project Origin)
This library was entirely conceived, reverse-engineered, and developed on an Android device using Termux, without access to a traditional PC or root privileges.
The challenge involved analyzing captured network traffic to reverse-engineer Vibe's custom authentication scheme (RSA and obfuscated2), successfully implementing it in Python, and wrapping it around the Telethon framework to provide over 850 high-level methods.
This project proves that a complete, production-ready SDK can be built entirely from a mobile environment.
یادداشت توسعه: این کتابخانه به طور کامل روی یک گوشی اندروید (در محیط Termux و بدون روت) و بدون دسترسی به کامپیوتر نوشته شده است. چالش اصلی، مهندسی معکوس الگوریتم احراز هویت اختصاصی سرور وایب بود که با تحلیل ترافیک شبکه انجام شد. این پروژه اثبات میکند که میتوان یک کتابخانه حرفهای و کامل را تنها با یک گوشی موبایل توسعه داد.
License
MIT License
Metadata
Release files for vibegram 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| vibegram-1.3.0.tar.gz | 38.7 kB | Without provenance | Details for vibegram-1.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| vibegram-1.3.0-py3-none-any.whl | Python 3 | none | any | Details for vibegram-1.3.0-py3-none-any.whl |
Total release size: 88.1 kB
Release files / vibegram-1.3.0.tar.gz
| Download URL | vibegram-1.3.0.tar.gz |
|---|---|
| Size | 38.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b050d075c9136112fc57ec09fdd5e625c8770dec79ba4b6670c3a3a841d1abf1
|
|
BLAKE2b-256 checksum How to use checksums |
2dd43892747f29b00e017982c1d08e782507eb1d2eea5f1210a1c39eeff7c02e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.10
|
Release files / vibegram-1.3.0-py3-none-any.whl
| Download URL | vibegram-1.3.0-py3-none-any.whl |
|---|---|
| Size | 49.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3792664bb930b6425e8e5d4f442842c38a955fabf20956e0eba293184f3cbafa
|
|
BLAKE2b-256 checksum How to use checksums |
3e3ceb148f9d0ed770552d5acee6b0a5f791e21f588767b36c9851b17d0ad9ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.10
|
Security for vibegram 1.3.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.