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 and interval recurrence) persisted in SQLite.
- 🤝 Multi-agent orchestration with specialist agent definitions and skill packs.
- 📊 Structured logfmt logs and a focused async test suite.
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
minibot-0.5.0.tar.gz
(175.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.5.0-py3-none-any.whl
(244.3 kB
view details)
File details
Details for the file minibot-0.5.0.tar.gz.
File metadata
- Download URL: minibot-0.5.0.tar.gz
- Upload date:
- Size: 175.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1c10f6bf37286cbda68d32dad18f4e924d371b5adcf84f64f8a36e9636f82b78
|
|
| MD5 |
759437fa280e37e54785a01fadeeb27a
|
|
| BLAKE2b-256 |
2dfdbb43e2a2f8cf975da7a60c773acbdd8fc63fff044bdc0ff42c5ea84f1cfe
|
File details
Details for the file minibot-0.5.0-py3-none-any.whl.
File metadata
- Download URL: minibot-0.5.0-py3-none-any.whl
- Upload date:
- Size: 244.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
34cb7fa3a5a98f22e06339529eeca72db0f4333f55d5f9148cd45bf1aa97371e
|
|
| MD5 |
63bf000189b5159b77cda19d642e9740
|
|
| BLAKE2b-256 |
c25360ff2652bf0eb681717049661fad07421fe5512c4d8e1dc7d4d2cbe90c16
|
