Librefang
LibreFang is an open-source agent operating system written in Rust. Live demo: https://flyio.librefang.ai
Install / Use
/learn @librefang/LibrefangREADME
What is LibreFang?
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.
<p align="center"> <img src="public/assets/dashboard.png" width="800" alt="LibreFang Dashboard" /> </p>LibreFang is a community fork of
RightNow-AI/openfangwith open governance and a merge-first PR policy. See GOVERNANCE.md for details.
Quick Start
# 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 init
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
docker run -p 4545:4545 ghcr.io/librefang/librefang
Hands: Agents That Work for You
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 | | Twitter | Autonomous X/Twitter — content creation, scheduling, approval queue | | Reddit | Reddit manager — subreddit monitoring, posting, engagement tracking | | LinkedIn | 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 Hands
Build your own: define a HAND.toml + system prompt + SKILL.md. Guide
Architecture
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
Key Features
40 Channel Adapters — Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, Teams, Google Chat, Feishu, LINE, Mastodon, Bluesky, and 26 more. Full list
27 LLM Providers — Anthropic, Gemini, OpenAI, Groq, DeepSeek, OpenRouter, Ollama, 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.
Development
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 check
Comparison
See docs/comparison.md for benchmarks and feature-by-feature comparison vs OpenClaw, ZeroClaw, CrewAI, AutoGen, and LangGraph.
Links
- Documentation • API Reference • Getting Started • Troubleshooting
- Contributing • Governance • Security
- Discussions: [Q&A](https://github.com/librefang/librefang/discussions/categories/q
