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.7.0.tar.gz
(181.9 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.7.0-py3-none-any.whl
(254.6 kB
view details)
File details
Details for the file minibot-0.7.0.tar.gz.
File metadata
- Download URL: minibot-0.7.0.tar.gz
- Upload date:
- Size: 181.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
53076be4a20ac9c73ac0c3a990ba9455473d048f7ec1cb28138b3eb289b2d21f
|
|
| MD5 |
c220eeee7910256c7d030cdc1677555f
|
|
| BLAKE2b-256 |
62326baf7415d63b2dde4214a1946617b3d282e798bd30cebf6dbe62a80ee372
|
File details
Details for the file minibot-0.7.0-py3-none-any.whl.
File metadata
- Download URL: minibot-0.7.0-py3-none-any.whl
- Upload date:
- Size: 254.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 |
95bce0a69475c0332913ce92a861e1a08f50e632bd0e2bc86736bf2b41b7651b
|
|
| MD5 |
7326c99a7905464a4fcc4016b573bb83
|
|
| BLAKE2b-256 |
50838844b91438fbec3d4e67243785cb101ffb639cbb9dc42f52fab24235a4b4
|