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.
Quick start
pip install minibot
# add extras as needed, e.g.: pip install "minibot[mcp,stt,rabbitmq]"
minibot configure # interactive wizard, writes config.toml
minibot # start the daemon
Extras: mcp (MCP server tools), stt (speech-to-text via faster-whisper), rabbitmq (RabbitMQ task
queue backend — not needed with the default sqlite backend).
No Telegram bot yet? Run minibot console instead of minibot to chat with it in your terminal.
Docker
cp config.example.toml config.toml
# edit config.toml (or run `minibot configure` in a venv first)
docker compose up -d
docker-compose.yml builds the minibot image and starts Qdrant alongside it (used by the RAG tool);
the RabbitMQ service is commented out and only needed if you set [tasks].backend = "rabbitmq".
Demo
Example: generate images with the python_execute tool and receive them in Telegram.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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
File details
Details for the file minibot-0.10.0.tar.gz.
File metadata
- Download URL: minibot-0.10.0.tar.gz
- Upload date:
- Size: 199.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aa09431edab79b58066a85b8c187b9cc1e2de57defb2e594a0fd5cc1d833f737
|
|
| MD5 |
480943718ecea4ed5bf0eec742c26b13
|
|
| BLAKE2b-256 |
e7f9b4f717c4e7a11330905a2cf415928be3f3431bca583bd90ad80d0105c769
|
File details
Details for the file minibot-0.10.0-py3-none-any.whl.
File metadata
- Download URL: minibot-0.10.0-py3-none-any.whl
- Upload date:
- Size: 283.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 |
67ae81894fe36fdd59ee43322935affd8fc647a20513f743eef6f8a484852200
|
|
| MD5 |
f56e95338af2919ac63680e19e3fc357
|
|
| BLAKE2b-256 |
cc40a20e0d4d25c7b2513d2019a11b0fe4e28a9232818b8c71f6418e3619abb5
|
