robbot

🤖 robbot is a Matrix bot focused on a small runtime surface, static named OpenAI-compatible backends, and optional MCP-backed search/crawling.

It is configured with a fixed list of named backends such as openrouter, ollama, or cerebras, and users can switch between those backend names at runtime with !bai model <backend-name>. Backends can also opt into named MCP servers for URL search and crawling.

🌟 Features

• static named backends defined in config as { name, api_key?, model, url }
• optional shared MCP server registry with explicit per-backend tool access
• explicit small-model tool-result summarization before MCP output is replayed to the main assistant
• OpenAI-compatible API focus with /v1/chat/completions and /v1/models
• text-first conversations in Matrix rooms and threads
• room-level backend switching plus thread-local backend overrides
• support for image inputs plus built-in PDF handling: direct text extraction, bounded OCR fallback, then page-image fallback
• encrypted Matrix communication and persisted room/global state

🚀 Getting Started

• For playbook installation, see Setting up robbot
• For local runs and hacking, see development documentation
• For runtime behavior, see usage and configuration

📚 Documentation

See the bot's documentation for the rest of the docs tree.

📜 Changes

See CHANGELOG.md for historical changes inherited from the fork and newer robbot-specific work.