MeroBot - Personal AI Assistant
Personal AI assistant with 8 built-in tools, multi-LLM support, and Telegram messaging integration.
The problem
Building a robust personal AI assistant requires integrating multiple components: LLM providers, communication channels, tool execution, and maintaining conversation context, all while ensuring security, extensibility, and performance.
The result
Developed a fully functional AI assistant with 8 built-in tools, supporting multiple LLM providers and Telegram integration, demonstrating expertise in async Python development, API design, and agent-based architectures.
How it works
MeroBot is a comprehensive AI assistant that bridges communication channels (currently Telegram) with large language models through an async-first message-bus architecture. The system implements an iterative agent loop where the LLM can chain up to 10 tool calls per message, enabling sophisticated multi-step reasoning and task execution.
Key technical achievements include:
- Modular Architecture: Clean separation of concerns with dedicated layers for agents, communication handlers, LLM providers, and tools
- Tool Ecosystem: 8 built-in tools covering file operations, web search/scraping, code execution, database queries, and sub-agent delegation
- Provider Flexibility: Pluggable LLM backend supporting OpenAI-compatible APIs, LiteLLM (100+ providers), and direct HTTP implementations
- Security & Sandboxing: All file and code operations confined to a configurable workspace directory
- Async Design: Full asyncio implementation with message queues for scalable, non-blocking operations
- Extensibility: Well-documented ABCs and interfaces for adding new channels, providers, and tools
Tech stack
- Python 3.12+
- python-telegram-bot
- httpx
- BeautifulSoup4
- LiteLLM
- loguru
- python-dotenv
- ai-tools-executor
Tags
- Python
- Asyncio
- Telegram Bot API
- LLM Integration
- Tool Calling
- Web Scraping
- Code Execution
- SQLite
- Message Bus Architecture
- API Design
- Sandboxing
- HTTP Clients
- JSON Schema Validation