OpenFang

Giới thiệu

OpenFang không chỉ là một framework chatbot đơn thuần mà tự định vị là một ‘Hệ điều hành cho Agent’ (Agent Operating System). Dự án này giải quyết vấn đề của các AI agent thụ động (chỉ phản hồi khi được hỏi) bằng cách cung cấp kiến trúc ‘Hands’ - các agent tự chủ hoạt động theo lịch trình (24/7). Ứng dụng thực tế bao gồm tự động hóa quy trình sales (Lead generation), thu thập thông tin tình báo (OSINT), quản lý mạng xã hội, và sản xuất nội dung video ngắn, tất cả được đóng gói trong một file binary duy nhất viết bằng Rust với hiệu năng cao và bảo mật chặt chẽ.

Tính năng chính

Kiến trúc Hands: Các agent được đóng gói sẵn (như Clip, Lead, Collector) để chạy tự động theo lịch trình mà không cần sự can thiệp của con người.
Hiệu năng cao (Rust): Viết hoàn toàn bằng Rust, biên dịch thành một file binary duy nhất (~32MB), khởi động cực nhanh (180ms) và tốn ít tài nguyên.
Bảo mật đa lớp: Tích hợp 16 hệ thống bảo mật, bao gồm WASM sandbox để cô lập code thực thi, kiểm toán log qua Merkle hash-chain.
Kết nối đa kênh: Hỗ trợ sẵn 40 channel adapters (Discord, Slack, Telegram, WhatsApp, v.v.) để agent tương tác trực tiếp với người dùng.
Hỗ trợ LLM đa dạng: Tương thích với 27 nhà cung cấp LLM (OpenAI, Anthropic, Google…) và các mô hình local (Ollama).

Hướng dẫn cài đặt Local (macOS)

Cách đơn giản nhất để cài đặt OpenFang trên macOS là sử dụng script cài đặt tự động:

Cài đặt qua Terminal:

curl -fsSL https://openfang.sh/install | sh

Cấu hình API Key: Thiết lập các biến môi trường cho LLM provider mà bạn muốn sử dụng (ví dụ: OpenAI hoặc Anthropic).
```
export OPENAI_API_KEY=sk-proj-...
# Hoặc
export ANTHROPIC_API_KEY=sk-ant-...
```
Khởi động Daemon: Chạy dịch vụ nền của OpenFang:
```
openfang start
```
Sau đó truy cập Dashboard tại http://localhost:4200.

Hướng dẫn Docker

Bạn có thể chạy OpenFang trong môi trường Docker để đảm bảo sự cô lập. Dưới đây là Dockerfile cơ bản để build từ source nếu chưa có image chính thức:

# Build stage
FROM rust:latest as builder
WORKDIR /usr/src/openfang
COPY . .
RUN cargo install --path crates/openfang-cli

# Runtime stage
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y ca-certificates && rm -rf /var/lib/apt/lists/*
COPY --from=builder /usr/local/cargo/bin/openfang /usr/local/bin/openfang

EXPOSE 4200
CMD ["openfang", "start"]

Cách chạy:

docker build -t openfang .
docker run -d -p 4200:4200 -e OPENAI_API_KEY=your_key_here openfang

Ví dụ Code (Example Code)

OpenFang hoạt động dựa trên cấu hình (Configuration-driven) thay vì viết script gọi hàm. Dưới đây là ví dụ về file cấu hình HAND.toml để định nghĩa một Agent tự động tìm kiếm tin tức (Researcher):

# HAND.toml - Định nghĩa một 'Hand' (Agent)
[hand]
name = "daily-tech-news"
role = "Researcher"
schedule = "0 8 * * *"  # Chạy vào 8:00 sáng mỗi ngày

[llm]
provider = "anthropic"
model = "claude-3-5-sonnet-20240620"

[channels]
# Gửi báo cáo kết quả về Telegram
telegram = { chat_id = "-100123456789" }

[instructions]
system_prompt = """
Bạn là một chuyên gia phân tích công nghệ.
Nhiệm vụ: Tìm kiếm 5 tin tức AI quan trọng nhất trong 24h qua.
Tóm tắt ngắn gọn và gửi báo cáo.
"""

Sau khi lưu file, bạn kích hoạt Hand này bằng lệnh:

openfang spawn --config HAND.toml

Sources

Github Page

https://github.com/RightNow-AI/openfang

Tags: github