ohdearquant/lionagi

lionagi – 受控的多智能體編排框架

是什麼 – lionagi 是一個 Python 庫（以及配套的 li CLI），讓你能夠建構、執行與管理由 LLM 驅動的智能體工作流程。它將每個智能體（或模型）視為一等公民元件，可透過簡單模式（單次呼叫、平行扇出或完整 DAG）串接，同時保持所有狀態為類型化、可檢視且持久化於磁碟上。

為何重要 – 與許多隱藏提示組合與執行迴圈的「框架」不同，lionagi 讓你完全掌控該迴圈：

類型化狀態 – 對話是 Pydantic 模型的集合，因此可直接請求結構化輸出。
持久化執行 – 每次執行都會儲存在 ~/.lionagi/runs/ 中；可後續恢復、監控或排程。
治理機制 – 內建權限策略、保護鈎子與沙箱化 git 工作樹，防止意外的破壞性操作。
混合提供者 – CLI 可以以子行程方式啟動模型專用 CLI（Claude Code、Codex、Pi）或使用標準環境金鑰呼叫 API 提供者（OpenAI、Anthropic、Ollama 等）。
Web UI（Lion Studio） – 一個客戶端儀表板（lion-studio.khive.ai）連接到本地守護程序，用於視覺化執行檢查、排程與劇本管理。

核心概念

語彙	含義
Branch	擁有自己訊息歷程、工具與模型設定的單一對話線程。主要 Python 進入點（`Branch`）。
Session	協調多個 Branch；在它們之間執行 DAG 工作流程。
flow	協調器建構專家智能體依賴圖的 CLI 命令（`li o flow`）。
team	智能體間訊息傳遞的持久收件箱（`li team`）。
operate	高階呼叫（`branch.operate`），執行工具、強制 ReAct 推理並回傳類型化結果。
persist	自動儲存每次執行；透過 `li agent -r <branch-id>` 恢復。

典型用法

# 安裝
pip install lionagi

# 一次性 CLI 呼叫
li agent claude/sonnet "用三句話解釋觀察者模式"

# 帶合成的平行扇出
li o fanout claude/sonnet "識別這個程式碼庫中的程式碼臭味" -n 3 --with-synthesis

# DAG 協調流程
li o flow claude/sonnet "審計認證模組的安全問題" --cwd .

# Python API – 類型化結構化輸出
from pydantic import BaseModel
from lionagi import Branch
import asyncio

class Assessment(BaseModel):
    risk: str
    reasons: list[str]

async def main():
    b = Branch(chat_model="codex/gpt-5.5", system="你是一個謹慎的審查者。")
    result = await b.operate(
        instruction="評估在此倉儲中啟用自動合併的風險。",
        response_format=Assessment,
    )
    print(result.risk, result.reasons)

asyncio.run(main())

執行 UI

li studio               # 啟動本地守護程序 + 開啟托管 UI
li studio --docker      # 自包含 Docker 影像
li studio --no-frontend # 僅 API，無 UI

UI 完全為客戶端端；你的資料永遠不會離開機器。

可擴展性 – 選用擴展（透過 lionagi[extra] 安裝）可新增 PDF/HTML 讀取、PostgreSQL 持久化、Ollama 本地模型、豐富終端輸出、圖形可視化等功能。

資源

文件：https://ohdearquant.github.io/lionagi/
與 LangChain / LangGraph 的對比：https://ohdearquant.github.io/lionagi/comparison/
Discord 社群：https://discord.gg/JDj9ENhUE8
PyPI 套件：https://pypi.org/project/lionagi/

總結 – lionagi 是一個生產就緒的開源工具包，適用於任何希望以清晰狀態、可重現執行與內建治理方式編排 LLM 智能體的人，無論是透過 Python 程式碼還是強大的 CLI。

ohdearquant/lionagi

lionagi – 受控的多智能體編排框架

相關