Skip to main content

pyvibe

Python client library for Vibe Messenger (vibegram.chat). MTProto over WebSocket with Vibe's custom authentication scheme.

About the Author

(درباره سازنده: علی، توسعه‌دهنده پایتون. این پروژه در محیط 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)

Source distribution for vibegram 1.3.0
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)

Table of built distributions (wheels) for vibegram 1.3.0
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page