convez.ai
MCP ServerAutomaçãoAvançado
chinkan

RustFox — Assistente IA para Telegram

chinkan/RustFox

Assistente IA agentic self-hosted em Rust para Telegram com MCP e RAG

Ver no GitHub
BomPluginScore · de 0 a 100

Assistente IA self-hosted em Rust que roda nativamente no Telegram com integração a LLMs via OpenRouter, ferramentas sandboxed (execução de comandos, I/O de arquivos, web search), memória persistente com RAG e suporte a MCP servers. Permite agendamento de tarefas, skills customizáveis e sub-agentes isolados com zero-trust verification.

Instalação

$npx convez-ai chinkan/RustFox

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
12
Forks
4
Acompanhando
0
Saúde
57%
Último commit
há 2 dias
Versão
v1.0.9
Issues abertas
25
Contribuidores
6

Casos de uso

  • Automação de tarefas recorrentes via Telegram com agendamento cron
  • Pesquisa e análise de informações com acesso a ferramentas MCP (Brave Search, GitHub, Filesystem)
  • Assistência produtiva com contexto persistente e memória vetorial RAG

Veredito

RustFox é uma solução robusta e well-architected para quem quer um assistente IA agentic self-hosted integrado ao Telegram. Excelente para DevOps e engenheiros que precisam de automação com contexto, mas requer conhecimento técnico (Rust, deployment, APIs). Código limpo, documentação clara, forte suporte a extensões via MCP e skills.

README

A tradução para o português deste README ainda está na fila.

RustFox — Telegram AI Assistant

CI MIT License Buy Me a Coffee GitHub Sponsors

What is RustFox?

An open-source, self-hosted Telegram AI assistant written in Rust. It solves a simple problem: most AI assistants are locked inside proprietary chat UIs with no access to your files, tools, or schedule. RustFox lives in Telegram — your everyday messaging app — and acts as a full agentic AI teammate.

Why RustFox?

Drop a file, ask a question, schedule a task — RustFox handles it. Powered by OpenRouter LLM (Kimi K2.6), it runs an agentic loop: receive your message, call sandboxed tools (file I/O, command execution, web search via MCP), and loop until done. It remembers context via SQLite + vector RAG, runs skills and sub-agents, and even verifies its own work.

Self-hosted, no cloud dependency. Single binary. Setup wizard. Runs as systemd/launchd service. cargo install and you're running in 2 minutes.

Star the repo ⭐, fork to contribute, or open an issue for feedback.

docs: README.md · GUIDE.md · ARCHITECTURE.md


Features

🤖 AI AgentOpenRouter LLM (default: moonshotai/kimi-k2.6), agentic loop with tool calling, configurable max iterations
🔧 Built-in ToolsFile read/write, command execution, file sending, task scheduling — all sandboxed
🧩 MCP ServersConnect any MCP-compatible server (Git, Brave Search, GitHub, Filesystem, Threads…)
🧠 Persistent MemorySQLite-backed conversation history, vector embedding search (hybrid + FTS5), RAG
🧬 Skills & AgentsFolder-based skill instructions auto-loaded at startup; subagent skills with own model and tool whitelist
🤝 Agent LayerIsolated agentic mini-loops in agents/ with own model/tools; invoke_agent, spawn_agents, zero-trust verifier
🔄 Task SchedulingCron and one-shot task scheduler with SQLite persistence
📦 Self-HostingSingle binary, 2-min setup wizard, background service (systemd/launchd/Windows Service)

→ Full feature reference: docs/GUIDE.md


Quick Start

1. Install

Option A — Download a release (recommended)

Download from the Releases page:

tar xzf rustfox-*.tar.gz

Option B — Build from source

cargo install --path . --locked

2. Configure

# Browser wizard
./rustfox --setup

# Or terminal wizard
./rustfox --setup --cli

The wizard guides you through: Telegram bot token, allowed user IDs, OpenRouter API key, model, and optional MCP tools.

3. Run

rustfox
# or with a custom config:
rustfox --config /path/to/config.toml

4. (Optional) Background service

rustfox --service install   # Linux (systemd), macOS (launchd), or Windows
rustfox --service status

Configuration

SettingDescription
telegram.bot_tokenTelegram Bot API token (from @BotFather)
telegram.allowed_user_idsComma-separated user IDs allowed to use the bot
openrouter.api_keyOpenRouter API key (openrouter.ai/keys)
openrouter.modelLLM model ID (default: moonshotai/kimi-k2.6)
sandbox.allowed_directoryDirectory for sandboxed file/command operations
mcp_serversList of MCP servers to connect (see GUIDE.md)

→ Full configuration reference: docs/GUIDE.md


Quick Tool Overview

ToolDescription
read_file / write_fileRead and write files within the sandbox
send_fileSend a file from the sandbox to the current chat
execute_commandRun shell commands within the sandbox
schedule_taskSchedule recurring (cron) or one-shot tasks
invoke_agentRun a predefined agent from the agents/ directory

→ Full tool reference: docs/GUIDE.md


Architecture

RustFox runs an agentic loop: user message → LLM (OpenRouter) → tool calls → execute → loop until final response. Tools dispatch to built-in functions, MCP servers, or skill/agent directories.

→ Full architecture with source tree and data flow: docs/ARCHITECTURE.md


Contributing

MIT License. See CONTRIBUTING.md for how to open issues and submit PRs.

Support

Buy Me a Coffee GitHub Sponsors

Ver o original no GitHub

Bom para

Relacionados