SF

sausheong/felix

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

51 stars 14 forks 品質 51 トレンド 17

Felix — 単一バイナリAIエージェントゲートウェイ。 複数のprovider LLM、永続的な記憶、MCP の顧客、あなたのハードウェアで完全に動く

概要

囲碁に書かれているセルフホスト型のAIエージェントゲートウェイ。シングルバイナリ、低メモリ、自分のマシン上で完全に実行します。 Felix は、CLI または Web チャット経由で LLM に接続します。Claude、GPT、Gemini、Qwen、Ollama、または OpenAI 互換エンドポイントに接続します。また、エージェントは、処理中のツールの固定レジストリとリモート MCP サーバーの任意の数を使用して、ハードウェア上のタスクを実行できます。 1. 1つのバイナリ、状態の1つのディレクトリ、必要なネットワーク依存関係なし。 LLMはローカルにすることができます。 ベクターインデックスはインプロセスです。 ナレッジグラフはSQLiteファイルです。 Felixクラウドはありません。Felixアカウントはありません。Felixは誰がオフにすることができます。 2。 長時間実行するエージェントは、ファイルをタッチし、シェルアウトし、フラキーなAPIに話し、再起動中に状態を蓄積します。 外部呼び出しにはタイムアウトがあります。 すべてのキューにはキャップがあります。 パーコールリソースごとにペアリングされたクリーンアップがあります。 オンディスク状態は、次の負荷で自分自身を癒します。 3. デフォルトインストール — config の編集、API キー、vim なし — は動作しません.

概要(AI 翻訳)

囲碁に書かれているセルフホスト型のAIエージェントゲートウェイ。シングルバイナリ、低メモリ、自分のマシン上で完全に実行します。

Felix は、CLI または Web チャット経由で LLM に接続します。Claude、GPT、Gemini、Qwen、Ollama、または OpenAI 互換エンドポイントに接続します。また、エージェントは、処理中のツールの固定レジストリとリモート MCP サーバーの任意の数を使用して、ハードウェア上のタスクを実行できます。

デザイン哲学

  1. 自己十分。 1つのバイナリ、状態の1つのディレクトリ、必要なネットワーク依存関係なし。 LLMはローカルにすることができます。 ベクターインデックスはインプロセスです。 ナレッジグラフはSQLiteファイルです。 Felixクラウドはありません。Felixアカウントはありません。Felixは誰がオフにすることができます。 2。ロバスト。 長時間実行するエージェントのタッチファイル、シェルアウト、フルキーな API を話し、再起動中に状態を蓄積します。 外部呼び出しにはタイムアウトがあります。 すべてのキューにはキャップがあります。 パーコールリソースごとにペアリングされたクリーンアップがあります。 オンディスク状態は、次の負荷で自分自身を癒します。 3。 非技術的な人々によって箱から使用可能。 デフォルトインストール — config の編集、API キーなし、 [vim] なし — のみ動作しなければなりません。 アドバンストコンフィギュレーションは、必要に応じて複雑にすることができますが、デフォルトパスの方法ではなければいけません。 4。**デフォルトでセキュア.

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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

  1. 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.
  2. 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.
  3. 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.
  4. 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 chat CLI 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 gemma4 on first startup if no other models are available.
  • Per-agent extended reasoning (off|low|medium|high) mapped to Claude thinking budgets, OpenAI reasoning_effort, Gemini ThinkingConfig, and Qwen enable_thinking.
  • Context-window auto-detection from the model identifier (handles proxy prefixes correctly), with a per-agent contextWindow override 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

GitHub で README 全文を見る

インストール

uvx mcp-server-filesystem /Users/me/projects
MCP 初心者?mcpskill.org のガイドから始めましょう →