Self-hosted Telegram-first AI assistant with async tooling, memory, and scheduling.
Project description
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.
Release history Release notifications | RSS feed
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.4.0.tar.gz
(161.8 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.4.0-py3-none-any.whl
(228.5 kB
view details)
File details
Details for the file minibot-0.4.0.tar.gz.
File metadata
- Download URL: minibot-0.4.0.tar.gz
- Upload date:
- Size: 161.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cc8b96acf0ff92581d1700e50c7636190a7926e704978cac4d27f3e0aebf5789
|
|
| MD5 |
b06d5eb802534a1d4c0548c6abde8d00
|
|
| BLAKE2b-256 |
ecb8d4a6ce702884dcc965b4f00a2b3507e874574f38f0365b77395c12e8e981
|
File details
Details for the file minibot-0.4.0-py3-none-any.whl.
File metadata
- Download URL: minibot-0.4.0-py3-none-any.whl
- Upload date:
- Size: 228.5 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 |
da101a9c2cd4f4d9ba11db8fa973e4f08d5215a8340790b79a0d93e323e4d850
|
|
| MD5 |
c6e31835ba355503436dc22d8cc1a7ab
|
|
| BLAKE2b-256 |
675329ffce6ff4703017553b239497121f551b9d943d140f9ceeca316b666fbf
|
