darkob

Fast, stable async Python for the Rubika & Shad platforms.
Build bots and userbots that stay up.

Documentation · AI context · PyPI · Issues

pip install darkob

from darkob import Bot, Keyboard

bot = Bot(token="YOUR_BOT_TOKEN")

@bot.on_command("start")
async def start(bot, event):
    await event.reply("Welcome 👋")

@bot.on_new_message()
async def echo(bot, event):
    await event.reply(event.text, inline_keypad=Keyboard().row("Yes", "No"))

bot.run()

Why darkob

A fork of maxrubika, rebuilt so failures are visible and the fast paths are actually fast.

What's inside

Documentation

Full site: manitheferfri.github.io/darkob

Built for AI-assisted development

Most darkob bots are written by an assistant, so the docs are built to be read by a model.

https://manitheferfri.github.io/darkob/llms-full.txt

That single file is the whole thing: hard rules, every guide, and the full API with complete docstrings for all 688 methods — 318 KB, one fetch, no follow-up links.

• llms.txt — curated map
• api.json — every method as JSON
• Every page is also served as raw Markdown: append .md to any URL
• The API reference is generated from the installed package, so it cannot drift from the code

Development

git clone https://github.com/ManiTheFerfri/darkob.git
cd darkob
pip install -e ".[dev]"

pytest --cov=darkob    # 290 tests, no network required
ruff check .           # lint

The suite never opens a socket: HTTP goes through fake transports, and a subprocess test asserts that importing darkob cannot reach the network.

License

MIT. Derived from maxrubika, copyright MEHRAB Farahmand; the original MIT notice is preserved in LICENSE.

Maintained by Mani Keikhosravi.

Not affiliated with Rubika or Shad. Use responsibly and in line with the platforms' terms of service.