Skip to main content

MiniBot 🤖

PyPI version

Your personal AI assistant for Telegram - self-hosted, auditable, and intentionally opinionated.

📖 Full documentation

Top features

  • 🤖 Personal assistant, not SaaS: your chats, memory, and scheduled prompts stay in your instance.
  • 🎯 Opinionated by design: Telegram-centric flow, small tool surface, and explicit config over hidden magic.
  • 🏠 Self-hostable: Dockerfile + docker-compose provided for easy local deployment.
  • 💻 Local console channel for development/testing without Telegram.
  • 💬 Telegram channel with chat/user allowlists, long-polling or webhook modes, and multimodal inputs.
  • 🧠 Provider support via llm-async: openai, openai_responses, openrouter, and more.
  • 🧰 Configurable tools: chat memory, KV notes, HTTP fetch, calculator, datetime, Python execution, Bash, file storage, grep, speech-to-text, and MCP server bridges.
  • ⏰ Scheduled prompts (one-shot, fixed-interval, and cron recurrence) persisted in SQLite.
  • 🤝 Multi-agent orchestration with specialist agent definitions and skill packs.
  • ⚙️ minibot configure: interactive terminal wizard to create or update config.toml.
  • 📊 Structured logfmt logs and a focused async test suite.

Demo

Example: generate images with the python_execute tool and receive them in Telegram.

Generate image with python_execute (1) Generate image with python_execute (2)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

minibot-0.6.0.tar.gz (177.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

minibot-0.6.0-py3-none-any.whl (246.6 kB view details)

Uploaded Python 3

File details

Details for the file minibot-0.6.0.tar.gz.

File metadata

  • Download URL: minibot-0.6.0.tar.gz
  • Upload date:
  • Size: 177.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for minibot-0.6.0.tar.gz
Algorithm Hash digest
SHA256 a952974069ae46146b9221535bbd7708280199cc4d7d9a3b003da4f13ed4cf4e
MD5 146be91b70e3b51c372eab00e597a8e1
BLAKE2b-256 1c3ce10040bb96f0c803d025144c42773a518a05302caacc4df19f43629e2280

See more details on using hashes here.

File details

Details for the file minibot-0.6.0-py3-none-any.whl.

File metadata

  • Download URL: minibot-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 246.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for minibot-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c507e07a3b822244c02844153f3adf23a3a6428c831d45c5d5c099d3f01d313b
MD5 9aea1e98c2065b751c675a9275370c93
BLAKE2b-256 6688e2f04069775aca07e1b6370e9ee14ca45b749890e68a4e951fe042bf653b

See more details on using hashes here.

Release history Release notifications | RSS feed

0.15.0

2 files

0.14.3

2 files

0.14.2

2 files

0.14.1

2 files

0.14.0

2 files

0.13.0

2 files

0.12.0

2 files

0.11.0

2 files

0.10.0

2 files

0.9.0

2 files

0.8.0

2 files

0.7.0

2 files

This release

0.6.0 This release

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.0

2 files

0.1.1

2 files

0.0.9

2 files

0.0.8

2 files

0.0.7

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

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