MiniBot 🤖
Your personal AI assistant for Telegram - self-hosted, auditable, and intentionally opinionated.
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 updateconfig.toml. - 📊 Structured logfmt logs and a focused async test suite.
Demo
Example: generate images with the python_execute tool and receive them in Telegram.
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)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
minibot-0.6.0-py3-none-any.whl
(246.6 kB
view details)
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a952974069ae46146b9221535bbd7708280199cc4d7d9a3b003da4f13ed4cf4e
|
|
| MD5 |
146be91b70e3b51c372eab00e597a8e1
|
|
| BLAKE2b-256 |
1c3ce10040bb96f0c803d025144c42773a518a05302caacc4df19f43629e2280
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c507e07a3b822244c02844153f3adf23a3a6428c831d45c5d5c099d3f01d313b
|
|
| MD5 |
9aea1e98c2065b751c675a9275370c93
|
|
| BLAKE2b-256 |
6688e2f04069775aca07e1b6370e9ee14ca45b749890e68a4e951fe042bf653b
|