Skip to main content

pyvibe

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

API Modes

This library provides two ways to interact with Vibe Messenger:

  1. MTProto (User & Legacy Bot): High-level client wrapping Telethon (userapi.VibeClient and botapi.VibeBot). Fully reverse-engineered protocol over WebSocket.
  2. HTTP Bot API (botapi.VibeBotHTTP): A Telegram-compatible HTTP Bot API client. Highly recommended for creating bots, fully supporting inline buttons, file uploads, and webhooks. See botapi/README.md for details.

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.5.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.5.1
File Size Uploaded Provenance Actions
vibegram-1.5.1.tar.gz 53.8 kB Without provenance Details for vibegram-1.5.1.tar.gz

Built distribution (wheel)

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

Total release size: 118.4 kB

Release files / vibegram-1.5.1.tar.gz

Download URL vibegram-1.5.1.tar.gz
Size 53.8 kB
Tags Source
SHA-256 checksum
How to use checksums
abdce9b9b1e5de655be594caea305470d275a6d78485ee2468d533b7719dc213
BLAKE2b-256 checksum
How to use checksums
25481a71e4c82265718f5f69513a67077a7547a01d29243857c731b749021eee
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.5.1-py3-none-any.whl

Download URL vibegram-1.5.1-py3-none-any.whl
Size 64.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
00e2bbdeaca9e2b073d58dcc35c5302860a0973b45a102c3aaffd6def0c7694d
BLAKE2b-256 checksum
How to use checksums
097b5b87cedd80eb5ec54f4a55d7d7b5195748797f22118787cefdb2b60ac69d
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.5.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