Rust で構築されたオープンソース Agent OS。24 クレート。2,100+ テスト。clippy 警告ゼロ。

English | 中文 | 日本語 | 한국어 | Español | Deutsch | Polski | Français | Українська

ウェブサイト • ドキュメント • コントリビュート • Discord

LibreFang は エージェントオペレーティングシステム — Rust でゼロから構築された、自律型 AI エージェントを実行するための完全なプラットフォームです。チャットボットフレームワークでも、Python ラッパーでもありません。

従来のエージェントフレームワークは入力を待ちます。LibreFang はあなたのために働くエージェントを実行します — スケジュールに従い、24時間365日、ターゲットの監視、リード生成、ソーシャルメディア管理、ダッシュボードへのレポートを行います。

LibreFang は RightNow-AI/openfang のコミュニティフォークで、オープンガバナンスとマージファーストの PR ポリシーを採用しています。詳細は GOVERNANCE.md を参照。

# インストール (Linux/macOS/WSL)
curl -fsSL https://librefang.ai/install.sh | sh

# または Cargo でインストール
cargo install --git https://github.com/librefang/librefang librefang-cli

# 起動 — 初回実行時に自動初期化されます。ダッシュボードは http://localhost:4545
librefang start

# または、セットアップウィザードを手動で実行して、対話式でプロバイダーを選択します
# librefang init

brew install librefang              # CLI (stable) — 公式 homebrew-core

brew tap librefang/tap
brew install --cask librefang       # Desktop (stable)
# Beta/RC チャンネル：
# brew install librefang-beta       # または librefang-rc
# brew install --cask librefang-rc  # または librefang-beta

# LibreFang パッケージ署名鍵をインポートし、ローカルで信頼する
curl -fsSL https://packages.librefang.ai/librefang.gpg -o /tmp/librefang.gpg
sudo pacman-key --add /tmp/librefang.gpg
sudo pacman-key --finger 2C325B0F88706ED99C45E216DD09DC7D3E70E1E9
sudo pacman-key --lsign-key 2C325B0F88706ED99C45E216DD09DC7D3E70E1E9

[librefang]
Server = https://packages.librefang.ai/arch/$arch

sudo pacman -Syu librefang-bin

sudo pacman -Syu librefang-desktop-bin

docker run -p 4545:4545 ghcr.io/librefang/librefang

Hands は、プロンプトなしでスケジュールに従って独立して実行される、自律的な機能パッケージです。各Handは、HAND.tomlマニフェスト、システムプロンプト、および設定された環境からロードされるオプションのSKILL.mdファイルによって定義されます hands_dir。

Handの定義例（Researcher、Collector、Predictor、Strategist、Analytics、Trader、Lead、Twitter、Reddit、LinkedIn、Clip、Browser、API Tester、DevOps）は、コミュニティのHandsリポジトリで入手できます.。

# コミュニティのHandをインストールしてから：
librefang hand activate researcher   # すぐに作業開始
librefang hand status researcher     # 進捗確認
librefang hand list                  # 全 Hands を表示

独自の Hand を作成: HAND.toml + システムプロンプト + SKILL.md を定義。ガイド

24 の Rust クレート + xtask、モジュラーカーネル設計。

librefang-kernel            オーケストレーション、ワークフロー、計量、RBAC、スケジューラ、予算
librefang-runtime           エージェントループ、ツール実行、WASM サンドボックス、MCP、A2A
librefang-api               140+ REST/WS/SSE エンドポイント、OpenAI 互換 API、ダッシュボード
librefang-channels          45 メッセージングアダプター、レート制限、DM/グループポリシー
librefang-memory            SQLite 永続化、ベクトル埋め込み、セッション、圧縮
librefang-types             コア型、テイント追跡、Ed25519 署名、モデルカタログ
librefang-skills            60 バンドルスキル、SKILL.md パーサー、FangHub マーケットプレイス
librefang-hands             自律 Hands、HAND.toml パーサー、ライフサイクル管理
librefang-extensions        25 MCP テンプレート、AES-256-GCM ボールト、OAuth2 PKCE
librefang-wire              OFP P2P プロトコル、HMAC-SHA256 相互認証
librefang-cli               CLI、デーモン管理、TUI ダッシュボード、MCP サーバーモード
librefang-desktop           Tauri 2.0 ネイティブアプリ（トレイ、通知、ショートカット）
librefang-import            OpenClaw、LangChain、AutoGPT インポート/マイグレーションエンジン
librefang-http              共有HTTPクライアントビルダー、プロキシ、TLSフォールバック
librefang-testing           テストインフラ：モックカーネル、モックLLMドライバー、APIルートテストユーティリティ
librefang-telemetry         向けのOpenTelemetry + Prometheusメトリクス計装
librefang-llm-driver        向けのLLMドライバーtraitおよび共有型
librefang-llm-drivers       traitを実装する具体的なLLMプロバイダードライバー（anthropic、openai、geminiなど）
librefang-runtime-mcp       ランタイム向けのMCP（Model Context Protocol）クライアント
librefang-kernel-handle     カーネルへのインプロセス呼び出し元のためのKernelHandle trait
librefang-kernel-router     カーネル向けのHand/Templateルーティングエンジン
librefang-kernel-metering   カーネル向けのコスト計量、クォータ適用
xtask                       ビルド自動化

OFP wire は plaintext-by-design です。 HMAC-SHA256 相互認証 + メッセージごとの HMAC + nonceリプレイ攻撃対策により、アクティブ な攻撃者はカバーされますが、フレームの内容は 暗号化されません。クロスネットワークのフェデレーションを行う場合は、プライベート オーバーレイ（WireGuard、Tailscale、SSHトンネル）またはサービスメッシュのmTLSレイヤーの背後でOFPを実行してください。 詳細: docs.librefang.ai/architecture/ofp-wire

45 チャネルアダプター — Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Email、Teams、Google Chat、Feishu、LINE、Mastodon、Bluesky 他。完全リスト

28 LLM プロバイダー — Anthropic、Gemini、OpenAI、Groq、DeepSeek、OpenRouter、Ollama 他。インテリジェントルーティング、自動フォールバック、コスト追跡。詳細

16 セキュリティレイヤー — WASM サンドボックス、Merkle 監査証跡、テイント追跡、Ed25519 署名、SSRF 保護、シークレットゼロ化他。詳細

OpenAI 互換 API — ドロップインの /v1/chat/completions エンドポイント。140+ REST/WS/SSE エンドポイント。API リファレンス

クライアント SDK — ストリーミング対応の完全な REST クライアント。

// JavaScript/TypeScript
npm install @librefang/sdk
const { LibreFang } = require("@librefang/sdk");
const client = new LibreFang("http://localhost:4545");
const agent = await client.agents.create({ template: "assistant" });
const reply = await client.agents.message(agent.id, "Hello!");

# Python
pip install librefang
from librefang import Client
client = Client("http://localhost:4545")
agent = client.agents.create(template="assistant")
reply = client.agents.message(agent["id"], "Hello!")

// Rust
cargo add librefang
use librefang::LibreFang;
let client = LibreFang::new("http://localhost:4545");
let agent = client.agents().create(CreateAgentRequest { template: Some("assistant".into()), .. }).await?;

// Go
go get github.com/librefang/librefang/sdk/go
import "github.com/librefang/librefang/sdk/go"
client := librefang.New("http://localhost:4545")
agent, _ := client.Agents.Create(map[string]interface{}{"template": "assistant"})

MCP サポート — MCP クライアントとサーバーを内蔵。IDE 連携、カスタムツール拡張、エージェントパイプライン構築。詳細

A2A プロトコル — Google Agent-to-Agent プロトコル対応。エージェントシステム間の発見・通信・タスク委譲。詳細

デスクトップアプリ — Tauri 2.0 ネイティブアプリ。システムトレイ、通知、グローバルショートカット。

OpenClaw マイグレーション — librefang migrate --from openclaw でエージェント、履歴、スキル、設定をインポート。

cargo build --workspace --lib                            # ビルド
cargo test --workspace                                   # 2,100+ テスト
cargo clippy --workspace --all-targets -- -D warnings    # 警告ゼロ
cargo fmt --all -- --check                               # フォーマットチェック

比較 で OpenClaw、ZeroClaw、CrewAI、AutoGen、LangGraph とのベンチマークと機能比較を確認できます。

• ドキュメント • API リファレンス • 入門ガイド • トラブルシューティング
• コントリビュート • ガバナンス • セキュリティ
• ディスカッション: Q&A • ユースケース • 機能投票 • お知らせ • Discord

コード、ドキュメント、翻訳、バグ報告など、あらゆる形の貢献を歓迎します。
コントリビュートガイドを確認して、good first issue から始めましょう！
また、新しいコントリビューター向けの役立つ情報が更新されている非公式wikiもご覧いただけます。

MIT ライセンス