<p align="center">
  <img src="../public/assets/logo.png" width="160" alt="LibreFang Logo" />
</p>

<h1 align="center">LibreFang</h1>
<h3 align="center">自由なエージェントオペレーティングシステム — Libre は自由を意味する</h3>

<p align="center">
  Rust で構築されたオープンソース Agent OS。24 クレート。2,100+ テスト。clippy 警告ゼロ。
</p>

<p align="center">
  <a href="../README.md">English</a> | <a href="README.zh.md">中文</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.es.md">Español</a> | <a href="README.de.md">Deutsch</a> | <a href="README.pl.md">Polski</a> | <a href="README.fr.md">Français</a>
</p>

<p align="center">
  <a href="https://librefang.ai/">ウェブサイト</a> &bull;
  <a href="https://docs.librefang.ai">ドキュメント</a> &bull;
  <a href="../CONTRIBUTING.md">コントリビュート</a> &bull;
  <a href="https://discord.gg/DzTYqAZZmc">Discord</a>
</p>

<p align="center">
  <a href="https://github.com/librefang/librefang/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/librefang/librefang/ci.yml?style=flat-square&label=CI" alt="CI" /></a>
  <img src="https://img.shields.io/badge/language-Rust-orange?style=flat-square" alt="Rust" />
  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="MIT" />
  <img src="https://img.shields.io/github/stars/librefang/librefang?style=flat-square" alt="Stars" />
  <img src="https://img.shields.io/github/v/release/librefang/librefang?style=flat-square" alt="Latest Release" />
  <a href="https://discord.gg/DzTYqAZZmc"><img src="https://img.shields.io/discord/1481633471507071129?style=flat-square&logo=discord&label=Discord" alt="Discord" /></a>
  <a href="https://deepwiki.com/librefang/librefang"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
</p>

---

## LibreFang とは？

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

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

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

<p align="center">
  <img src="../public/assets/dashboard.png" width="800" alt="LibreFang ダッシュボード" />
</p>

## クイックスタート

```bash
# インストール (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
```

<details>
<summary><strong>Homebrew</strong></summary>

```bash
brew tap librefang/tap
brew install librefang              # CLI (stable)
brew install --cask librefang       # Desktop (stable)
# Beta/RC channels also available:
# brew install librefang-beta       # or librefang-rc
# brew install --cask librefang-rc  # or librefang-beta
```

</details>

<details>
<summary><strong>Docker</strong></summary>

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

</details>

<details>
<summary><strong>クラウドデプロイ</strong></summary>

[![Deploy Hub](https://img.shields.io/badge/Deploy%20Hub-000?style=for-the-badge&logo=rocket)](https://deploy.librefang.ai) [![Fly.io](https://img.shields.io/badge/Fly.io-purple?style=for-the-badge&logo=fly.io)](https://deploy.librefang.ai) [![Render](https://img.shields.io/badge/Render-46E3B7?style=for-the-badge&logo=render)](https://render.com/deploy?repo=https://github.com/librefang/librefang) [![Railway](https://img.shields.io/badge/Railway-0B0D0E?style=for-the-badge&logo=railway)](https://railway.app/template/librefang) [![GCP](https://img.shields.io/badge/GCP-4285F4?style=for-the-badge&logo=googlecloud)](../deploy/gcp/README.md)

</details>

## Hands：あなたのために働くエージェント

**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リポジトリで入手できます](https://github.com/librefang/hands).。

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

独自の Hand を作成: `HAND.toml` + システムプロンプト + `SKILL.md` を定義。[ガイド](https://docs.librefang.ai/agent/skills)

## アーキテクチャ

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-migrate           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](https://docs.librefang.ai/architecture/ofp-wire)

## 主な機能

**45 チャネルアダプター** — Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Email、Teams、Google Chat、Feishu、LINE、Mastodon、Bluesky 他。[完全リスト](https://docs.librefang.ai/integrations/channels)

**28 LLM プロバイダー** — Anthropic、Gemini、OpenAI、Groq、DeepSeek、OpenRouter、Ollama 他。インテリジェントルーティング、自動フォールバック、コスト追跡。[詳細](https://docs.librefang.ai/configuration/providers)

**16 セキュリティレイヤー** — WASM サンドボックス、Merkle 監査証跡、テイント追跡、Ed25519 署名、SSRF 保護、シークレットゼロ化他。[詳細](https://docs.librefang.ai/getting-started/comparison#16-security-systems--defense-in-depth)

**OpenAI 互換 API** — ドロップインの `/v1/chat/completions` エンドポイント。140+ REST/WS/SSE エンドポイント。[API リファレンス](https://docs.librefang.ai/integrations/api)

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

```javascript
// 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
# 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
// 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
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 連携、カスタムツール拡張、エージェントパイプライン構築。[詳細](https://docs.librefang.ai/integrations/mcp-a2a)

**A2A プロトコル** — Google Agent-to-Agent プロトコル対応。エージェントシステム間の発見・通信・タスク委譲。[詳細](https://docs.librefang.ai/integrations/mcp-a2a)

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

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

## 開発

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

## 比較

[比較](https://docs.librefang.ai/getting-started/comparison#16-security-systems--defense-in-depth) で OpenClaw、ZeroClaw、CrewAI、AutoGen、LangGraph とのベンチマークと機能比較を確認できます。

## リンク

- [ドキュメント](https://docs.librefang.ai) &bull; [API リファレンス](https://docs.librefang.ai/integrations/api) &bull; [入門ガイド](https://docs.librefang.ai/getting-started) &bull; [トラブルシューティング](https://docs.librefang.ai/operations/troubleshooting)
- [コントリビュート](../CONTRIBUTING.md) &bull; [ガバナンス](../GOVERNANCE.md) &bull; [セキュリティ](../SECURITY.md)
- ディスカッション: [Q&A](https://github.com/librefang/librefang/discussions/categories/q-a) &bull; [ユースケース](https://github.com/librefang/librefang/discussions/categories/show-and-tell) &bull; [機能投票](https://github.com/librefang/librefang/discussions/categories/ideas) &bull; [お知らせ](https://github.com/librefang/librefang/discussions/categories/announcements) &bull; [Discord](https://discord.gg/DzTYqAZZmc)

## コントリビューター

<a href="https://github.com/librefang/librefang/graphs/contributors">
  <img src="../web/public/assets/contributors.svg" alt="Contributors" />
</a>

<p align="center">
  コード、ドキュメント、翻訳、バグ報告など、あらゆる形の貢献を歓迎します。<br/>
  <a href="../CONTRIBUTING.md">コントリビュートガイド</a>を確認して、<a href="https://github.com/librefang/librefang/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22">good first issue</a> から始めましょう！<br/>
  また、新しいコントリビューター向けの役立つ情報が更新されている<a href="https://leszek3737.github.io/librefang-WIki/">非公式wiki</a>もご覧いただけます。
</p>

<p align="center">
  <a href="https://github.com/librefang/librefang/stargazers">
    <img src="../web/public/assets/star-history.svg" alt="Star History" />
  </a>
</p>

---

<p align="center">MIT ライセンス</p>
