xiaomaolv is a high-performance AI gateway written in Rust. You can plug in OpenAI-compatible providers, connect channels like Telegram or HTTP, and run a production-ready bot service quickly.

Can I run it locally without public webhook setup?

Yes. Telegram polling mode is enabled by default, so you can run and test on localhost without exposing a public URL.

How does memory work?

By default it uses SQLite-only memory. If you need hybrid retrieval, it also supports a SQLite + zvec sidecar mode.

Is xiaomaolv extensible?

Yes. It has plugin-style extension points for Provider, Channel, and Memory so you can register your own runtime integrations.

product / rust telegram ai agent

Xiaomaolv: Self-Hosted Rust Telegram AI Agent

A self-hosted Rust Telegram AI agent for practical deployments. Connect MiniMax or an OpenAI-compatible provider, add MCP tools and SQLite memory, then run locally with polling.

View on GitHub Read Quick Start

Provider Abstraction

MiniMax / OpenAI / Compatible

Channel Modes

Telegram Polling + Webhook

Memory

SQLite + Hybrid Sidecar

Why This Gateway Feels Different

Rust Performance

Built for low-latency message routing and predictable runtime behavior.

Streaming UX

Telegram replies stream incrementally so users see answers earlier.

Safety-First Defaults

Polling mode works locally and avoids webhook friction during setup.

Flexible Memory

Start with SQLite-only, then switch to hybrid memory when needed.

Plugin Extensions

Custom provider and channel registries let you evolve architecture safely.

MVP in One Command

Run MiniMax + Telegram with a script and ship a real integration quickly.

Provider Layer

Plug any OpenAI-compatible endpoint into a unified provider interface without touching channel logic.

Channel Layer

Route messages through HTTP or Telegram with polling/webhook runtime modes and streaming output support.

Memory Layer

Keep it simple with SQLite-only memory, then scale retrieval strategy with a zvec sidecar when your use case grows.

Quick Start Flow

The recommended setup is MiniMax + Telegram. Configure two environment variables, run one script, and start chatting with your bot.

$ cp .env.realtest.example .env.realtest

$ # Fill MINIMAX_API_KEY + TELEGRAM_BOT_TOKEN

$ ./scripts/run_mvp_minimax_telegram.sh

$ curl -sS http://127.0.0.1:8080/health

related workflows

Git Commit AnalyzerLocal AI Conventional Commit message generator powered by llama.cpp and GGUF models, with no API key BeejsOpen-source JavaScript and TypeScript runtime built with Rust and V8, with a focused v0.1 CLI and compatibility layer

official links

Official links

Use these canonical links for citations, installation, source review, privacy checks, and support.

Website GitHub README Support

FAQ

Build Bot Infrastructure at Gateway Speed

If you want a practical and extensible Rust foundation for AI channels, xiaomaolv is ready to be your control plane.

Star on GitHub Explore More Tools