
sausheong/felix
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Felix — однобинарный шлюз агента AI. Многопользовательский LLM, постоянная память, MCP-клиент, работает полностью на вашем оборудовании
Обзор
Автономный шлюз агента ИИ, написанный на Go. Одиночный двоичный код, с низкой памятью, работает полностью на вашей собственной машине. Felix подключает вас (через CLI или веб-чат) к LLM — Claude, GPT, Gemini, Qwen, Ollama или любой OpenAI-совместимой конечной точке — и позволяет агентам выполнять задачи на вашем оборудовании с использованием фиксированного реестра инструментов в процессе плюс любое количество удаленных MCP-серверов. 1.Один двоичный файл, один каталог состояния, не требуется сетевая зависимость. LLM может быть локальным. Векторный индекс находится в процессе. Граф знаний — это файл SQLite. Нет ни облака Феликса, ни учетной записи Феликса, ни бэкэнда Феликса, который кто-либо мог бы отключить. 2.Долгосрочные агенты касаются файлов, выкладываются, разговаривают с нечеткими API и накапливают состояние при перезапуске. Каждый внешний звонок имеет тайм-аут. У каждой очереди есть кепка. Каждый ресурс на вызов имеет парную очистку. Состояние на диске заживает на следующей нагрузке. 3.Установка по умолчанию — никаких правок конфигурации, никаких ключей API, никаких vim — должна просто работать.
Обзор (машинный перевод)
Автономный шлюз агента ИИ, написанный на Go. Одиночный двоичный код, с низкой памятью, работает полностью на вашей собственной машине.
Felix подключает вас (через CLI или веб-чат) к LLM — Claude, GPT, Gemini, Qwen, Ollama или любой OpenAI-совместимой конечной точке — и позволяет агентам выполнять задачи на вашем оборудовании с использованием фиксированного реестра инструментов в процессе плюс любое количество удаленных MCP-серверов.
Философия дизайна
- ** Самодостаточный. ** Один двоичный файл, один каталог состояния, не требуется сетевая зависимость. LLM может быть локальным. Векторный индекс находится в процессе. Граф знаний — это файл SQLite. Нет ни облака Феликса, ни учетной записи Феликса, ни бэкэнда Феликса, который кто-либо мог бы отключить.
- ** Рост** Долгосрочные агенты касаются файлов, выкладываются, разговаривают с нечеткими API и накапливают состояние при перезапуске. Каждый внешний звонок имеет тайм-аут. У каждой очереди есть кепка. Каждый ресурс на вызов имеет парную очистку. Состояние на диске заживает на следующей нагрузке.
- ** Используется из коробки нетехническими людьми. ** Установка по умолчанию — нет правок конфигурации, нет ключей API, нет
vim— должна просто работать. Расширенная конфигурация может быть настолько сложной, насколько это необходимо, но она не должна быть на пути по умолчанию. - ** Безопасность по умолчанию.
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
Felix
A self-hosted AI agent gateway written in Go. Single binary, low memory, runs entirely on your own machine.
Felix connects you (via CLI or web chat) to LLMs — Claude, GPT, Gemini, Qwen, Ollama, or any OpenAI-compatible endpoint — and lets agents execute tasks on your hardware using a fixed registry of in-process tools plus any number of remote MCP servers.
Design philosophy
- Self-sufficient. One binary, one directory of state, no required network dependency. The LLM can be local. The vector index is in-process. The knowledge graph is a SQLite file. There is no Felix cloud, no Felix account, no Felix backend that anyone could turn off.
- Robust. Long-running agents touch files, shell out, talk to flaky APIs, and accumulate state across restarts. Every external call has a timeout. Every queue has a cap. Every per-call resource has a paired cleanup. On-disk state heals itself on the next load.
- Usable out of the box by non-technical people. The default install — no config edits, no API keys, no
vim— must just work. Advanced configuration can be as complex as it needs to be, but it must not be in the way of the default path. - Secure by default. An agent that can read files, run shell commands, and make web requests is genuinely powerful — defaults have to protect users who won’t read the security docs. Felix binds to localhost only, ships the bash tool in allowlist mode rather than full shell access, blocks web requests to internal IP ranges and cloud metadata endpoints, contains file access to each agent’s workspace with symlink resolution, and writes config and session files with owner-only permissions. You can relax any of it deliberately; you don’t have to opt out of it.
Features
Interfaces
- Single binary, no runtime dependencies. Download and run.
- macOS / Windows system tray app that runs the gateway in the background and serves a web chat at
http://127.0.0.1:18789/chat. felix chatCLI that auto-detects a running gateway and shares its session, memory, and MCP state — start in the browser, continue in the terminal.- WebSocket JSON-RPC 2.0 control plane for programmatic access.
Models
- Claude, GPT, Gemini, Qwen, Ollama, LM Studio, DeepSeek, or any OpenAI-compatible API.
- Bundled Ollama runtime so you can run agents with no API key. Downloads
gemma4on first startup if no other models are available. - Per-agent extended reasoning (
off|low|medium|high) mapped to Claude thinking budgets, OpenAIreasoning_effort, GeminiThinkingConfig, and Qwenenable_thinking. - Context-window auto-detection from the model identifier (handles proxy prefixes correctly), with a per-agent
contextWindowoverride for unusual fine-tunes. - Cross-provider tool portability: JSON Schema fields one provider rejects (Gemini drops
anyOf/oneOf/format; OpenAI drops$ref/definitions) are stripped at the provider boundary.
Memory & knowledge
Установка
uvx mcp-server-filesystem /Users/me/projects