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.4.1

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.4.1
File Size Uploaded Provenance Actions
vibegram-1.4.1.tar.gz 39.5 kB Without provenance Details for vibegram-1.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for vibegram 1.4.1
File Interpreter ABI Platform Actions
vibegram-1.4.1-py3-none-any.whl Python 3 none any Details for vibegram-1.4.1-py3-none-any.whl

Total release size: 89.7 kB

Release files / vibegram-1.4.1.tar.gz

Download URL vibegram-1.4.1.tar.gz
Size 39.5 kB
Tags Source
SHA-256 checksum
How to use checksums
9b4e8abf3dbe206232f9d7d09eb0f948b4f2cd73f3bd3256e4ae3298c231d724
BLAKE2b-256 checksum
How to use checksums
8e9533007d7d93e3bf6165dc8603ed716c0101e6661fd65234595e90abbfc9f6
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.4.1-py3-none-any.whl

Download URL vibegram-1.4.1-py3-none-any.whl
Size 50.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
73f6e21007755eb3ae8b22a3ba5417844d0d54f51459f1c4c471b9b969ba9c37
BLAKE2b-256 checksum
How to use checksums
592e049e7ba7c56d49d279b6867d0df9b6c561428ea7d9745a5b53a1b65330b7
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.4.1

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