ohdearquant/lionagi

lionagi – 권한 있는 다중 에이전트 오케스트레이션 프레임워크

무엇인가요 – lionagi는 Python 라이브러리(및 함께 제공되는 li CLI)로, LLM 기반 에이전트 워크플로우를 구축하고 실행하며 관리할 수 있게 해줍니다. 각 에이전트(또는 모델)를 일급 구성 요소로 간주하여 간단한 패턴(단일 호출, 병렬 팬아웃, 전체 DAG)으로 연결할 수 있으며, 모든 상태는 타입 지정, 검사 가능, 디스크에 지속됩니다.

왜 중요한가요 – 많은 "프레임워크"가 프롬프트 조립과 실행 루프를 숨기지만, lionagi는 루프 전체를 완전히 당신의 소유로 제공합니다:

타입 지정된 상태 – 대화는 Pydantic 모델의 컬렉션으로, 구조화된 출력을 직접 요청할 수 있습니다.
내구성 있는 실행 – 모든 실행은 ~/.lionagi/runs/에 저장되며, 나중에 재개, 모니터링, 스케줄링이 가능합니다.
거버넌스 – 내장된 권한 정책, 가드 훅, 사전된 git 작업 트리로 실수로 파괴적인 동작을 방지합니다.
하이브리드 제공자 – CLI는 모델 전용 CLI(Claude Code, Codex, Pi)를 하위 프로세스로 실행하거나, 일반 환경 키를 사용해 API 제공자(OpenAI, Anthropic, Ollama 등)를 호출할 수 있습니다.
웹 UI (Lion Studio) – 클라이언트 사이드 대시보드(lion-studio.khive.ai)는 로컬 데몬에 연결되어 실행을 시각적으로 검사하고, 스케줄링 및 플레이북 관리를 가능하게 합니다.

핵심 개념

용어	의미
Branch	고유한 메시지 기록, 도구, 모델 설정을 가진 단일 대화 스레드. 주요 Python 진입점(`Branch`).
Session	여러 Branch를 조율하며, 그들 사이에서 DAG 워크플로우를 실행합니다.
flow	오케스트레이터가 전문 에이전트의 종속성 그래프를 구축하는 CLI 명령(`li o flow`).
team	에이전트 간 메시징을 위한 지속적 인보크(`li team`).
operate	도구를 실행하고 ReAct 추론을 강제하며, 타입 지정된 결과를 반환하는 고수준 호출(`branch.operate`).
persist	모든 실행을 자동으로 저장하며, `li agent -r <branch-id>`로 재개 가능합니다.

일반적인 사용법

# 설치
pip install lionagi

# 단일 CLI 호출
li agent claude/sonnet "관찰자 패턴을 3문장으로 설명해줘"

# 합성 포함 병렬 팬아웃
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는 명확한 상태, 재현 가능한 실행, 내장된 거버넌스를 갖춘 프로덕션 준비된 오픈소스 툴킷입니다. Python 코드 또는 강력한 CLI를 통해 누구나 LLM 에이전트를 오케스트레이션할 수 있습니다.

ohdearquant/lionagi

lionagi – 권한 있는 다중 에이전트 오케스트레이션 프레임워크

관련