Open-source Agent OS built in Rust. 14 crates. 2,100+ tests. Zero clippy warnings.
English | 中文 | 日本語 | 한국어 | Español | Deutsch | Polski
Website • Docs • Contributing • Discord
LibreFang is an Agent Operating System — a full platform for running autonomous AI agents, built from scratch in Rust. Not a chatbot framework, not a Python wrapper.
Traditional agent frameworks wait for you to type something. LibreFang runs agents that work for you — on schedules, 24/7, monitoring targets, generating leads, managing social media, and reporting to your dashboard.
LibreFang is a community fork of
RightNow-AI/openfangwith open governance and a merge-first PR policy. See GOVERNANCE.md for details.
# Install (Linux/macOS/WSL)
curl -fsSL https://librefang.ai/install.sh | sh
# Or install via Cargo
cargo install --git https://github.com/librefang/librefang librefang-cli
# Start — auto-initializes on first run, dashboard at http://localhost:4545
librefang start
# Or run the setup wizard manually for interactive provider selection
# librefang initHomebrew
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-betaDocker
docker run -p 4545:4545 ghcr.io/librefang/librefangCloud Deploy
Hands are pre-built autonomous capability packages that run independently, on schedules, without prompting. 14 bundled:
| Hand | What It Does |
|---|---|
| Researcher | Deep research — multi-source, credibility scoring (CRAAP), cited reports |
| Collector | OSINT monitoring — change detection, sentiment tracking, knowledge graph |
| Predictor | Superforecasting — calibrated predictions with confidence intervals |
| Strategist | Strategy analysis — market research, competitive intel, business planning |
| Analytics | Data analytics — collection, analysis, visualization, automated reporting |
| Trader | Market intelligence — multi-signal analysis, risk management, portfolio analytics |
| Lead | Prospect discovery — web research, scoring, dedup, qualified lead delivery |
| Autonomous X/Twitter — content creation, scheduling, approval queue | |
| Reddit manager — subreddit monitoring, posting, engagement tracking | |
| LinkedIn manager — content creation, networking, professional engagement | |
| Clip | YouTube to vertical shorts — cuts best moments, captions, voice-over |
| Browser | Web automation — Playwright-based, mandatory purchase approval gate |
| API Tester | API testing — endpoint discovery, validation, load testing, regression detection |
| DevOps | DevOps automation — CI/CD, infrastructure monitoring, incident response |
librefang hand activate researcher # Starts working immediately
librefang hand status researcher # Check progress
librefang hand list # See all HandsBuild your own: define a HAND.toml + system prompt + SKILL.md. Guide
14 Rust crates, modular kernel design.
librefang-kernel Orchestration, workflows, metering, RBAC, scheduler, budget
librefang-runtime Agent loop, 3 LLM drivers, 53 tools, WASM sandbox, MCP, A2A
librefang-api 140+ REST/WS/SSE endpoints, OpenAI-compatible API, dashboard
librefang-channels 40 messaging adapters with rate limiting, DM/group policies
librefang-memory SQLite persistence, vector embeddings, sessions, compaction
librefang-types Core types, taint tracking, Ed25519 signing, model catalog
librefang-skills 60 bundled skills, SKILL.md parser, FangHub marketplace
librefang-hands 14 autonomous Hands, HAND.toml parser, lifecycle management
librefang-extensions 25 MCP templates, AES-256-GCM vault, OAuth2 PKCE
librefang-wire OFP P2P protocol, HMAC-SHA256 mutual auth
librefang-cli CLI, daemon management, TUI dashboard, MCP server mode
librefang-desktop Tauri 2.0 native app (tray, notifications, shortcuts)
librefang-migrate OpenClaw, LangChain, AutoGPT migration engine
xtask Build automation
40 Channel Adapters — Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, Teams, Google Chat, Feishu, LINE, Mastodon, Bluesky, and 26 more. Full list
28 LLM Providers — Anthropic, Gemini, OpenAI, Groq, DeepSeek, OpenRouter, Ollama, Alibaba Coding Plan, and 20 more. Intelligent routing, automatic fallback, cost tracking. Details
16 Security Layers — WASM sandbox, Merkle audit trail, taint tracking, Ed25519 signing, SSRF protection, secret zeroization, and more. Details
OpenAI-Compatible API — Drop-in /v1/chat/completions endpoint. 140+ REST/WS/SSE endpoints. API Reference
Client SDKs — Full REST client with streaming support.
// 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 Support — Built-in MCP client and server. Connect to IDEs, extend with custom tools, compose agent pipelines. Details
A2A Protocol — Google Agent-to-Agent protocol support. Discover, communicate, and delegate tasks across agent systems. Details
Desktop App — Tauri 2.0 native app with system tray, notifications, and global shortcuts.
OpenClaw Migration — librefang migrate --from openclaw imports agents, history, skills, and config.
cargo build --workspace --lib # Build
cargo test --workspace # 2,100+ tests
cargo clippy --workspace --all-targets -- -D warnings # Zero warnings
cargo fmt --all -- --check # Format checkSee Comparison for benchmarks and feature-by-feature comparison vs OpenClaw, ZeroClaw, CrewAI, AutoGen, and LangGraph.
- Documentation • API Reference • Getting Started • Troubleshooting
- Contributing • Governance • Security
- Discussions: Q&A • Use Cases • Feature Votes • Announcements • Discord
We welcome contributions of all kinds — code, docs, translations, bug reports.
Check the Contributing Guide and pick a good first issue to get started!
You can also visit the unofficial wiki, which is updated with helpful information for new contributors.
MIT License