홈 > 제품 > EulerAgent

EulerAgent

결정론적 CLI 에이전트 프레임워크

8단계 상태 머신(RUN_CREATED → CONTEXT → PLAN → PROPOSE → APPROVE → EXECUTE → RESULT → FINALIZED), Pattern/Graph 오케스트레이터, RAG 파이프라인, 장기 기억(SQLite), MCP 통합, 플러그인 시스템을 갖춘 인간 승인(HITL) 기반 로컬 우선 에이전트 프레임워크입니다. 30+ CLI 명령, 65개 픽스처.

Open Source

주요 기능

8단계 상태 머신, 기억, 오케스트레이션, MCP, 플러그인 -- EulerAgent의 핵심 축

Human-in-the-Loop 보안

  • Deny-All 보안 모델: 모든 도구가 기본 차단, 명시적 허용 필요
  • 인간 승인 필수: 고위험 행동(파일 쓰기, 셸 실행, 외부 호출)은 반드시 인간 승인
  • 8단계 상태 머신: RUN_CREATED → CONTEXT → PLAN → PROPOSE → APPROVE → EXECUTE → RESULT → FINALIZED
  • 완전한 감사 추적: Audit Trail로 모든 행동 기록

장기 기억 & RAG

  • SQLite 기반: 대화 이력 및 벡터 검색
  • 자동 맥락 추출: 사용자 선호도 및 프로젝트 맥락 자동 학습
  • 하이브리드 RAG: 로컬 지식베이스 + 웹 검색
  • MCP 검색 프로바이더: Brave, Tavily 등 통합

워크플로우 오케스트레이션

  • Pattern Orchestrator: YAML 기반 워크플로우 (12개 정규 패턴 + Pattern v2)
  • Graph Orchestrator: LangGraph 기반 병렬 실행 (실험적)
  • 플러그인 시스템: 도구 확장, 커스텀 프로바이더, 65개 픽스처
  • 판정 노드 및 품질 루프: 출력 품질 자동 평가 및 반복

에이전트 템플릿

용도에 맞는 템플릿으로 빠르게 에이전트를 생성하세요

템플릿 용도
personal-assistant 범용 개인 비서
marketing-expert 마케팅 콘텐츠 작성
code-assistant 코드 작성 및 디버깅
ops-assistant 운영 및 인프라 관리

CLI 퀵스타트

명령 한 줄로 에이전트를 생성하고 실행합니다

# 워크스페이스 초기화
euleragent init

# 에이전트 생성
euleragent new my-assistant --template personal-assistant

# Plan 모드로 실행 (제안 후 승인)
euleragent run my-assistant --task "프로젝트 요약 작성" --mode plan

# Execute 모드로 실행 (저위험 자동 실행)
euleragent run my-assistant --task "코드 리팩토링" --mode execute

# 승인 관리
euleragent approve list
euleragent approve accept <id> --actor "user:name" --execute

# 대화형 채팅 (장기 기억 활성)
euleragent chat my-assistant --project default --continue

CLI 레퍼런스

EulerAgent의 전체 명령어 체계

핵심 명령어

명령어 설명
euleragent init 워크스페이스 초기화
euleragent new 템플릿에서 에이전트 생성
euleragent run 에이전트 실행 (plan/execute 모드)
euleragent chat 대화형 채팅 세션
euleragent logs 실행 감사 로그 조회
euleragent doctor 시스템 상태 점검

승인 관리

명령어 설명
euleragent approve list 대기 중 승인 목록
euleragent approve show <id> 승인 상세 정보
euleragent approve accept <id> 승인 수락 및 실행
euleragent approve reject <id> 승인 거부
euleragent approve accept-all 일괄 승인

지식베이스 (RAG)

명령어 설명
euleragent rag init 지식베이스 초기화
euleragent rag add --path ./docs/ 문서 추가
euleragent rag query --q "검색어" 지식베이스 검색
euleragent rag status KB 상태 확인

기억 관리

명령어 설명
euleragent memory status 기억 저장소 통계
euleragent memory search --q "검색어" 과거 대화 검색

워크플로우 & 패턴

명령어 설명
euleragent workflow show <run-id> 워크플로우 구조 및 상태
euleragent workflow resume <run-id> 워크플로우 재개
euleragent pattern list 사용 가능한 패턴 목록
euleragent pattern run <pattern> <agent> 패턴 기반 워크플로우 실행

MCP 관리

명령어 설명
euleragent mcp sync MCP 서버 카탈로그 동기화
euleragent mcp show 현재 MCP 상태

플러그인 관리

명령어 설명
euleragent plugin list 설치된 플러그인 목록
euleragent plugin install <name> 플러그인 설치
euleragent plugin info <name> 플러그인 상세 정보

튜토리얼

단계별 가이드로 EulerAgent를 마스터하세요

튜토리얼은 공개 예정입니다.

설치 및 시작하기

EulerAgent를 설치하고 첫 번째 에이전트를 실행하세요

설치

pip install euleragent

# Ollama 모델 다운로드
ollama pull qwen3:32b

# 워크스페이스 초기화
euleragent init

요구 사항

  • Python 3.11+
  • Ollama (또는 OpenAI/Gemini API 키)

GitHub

eulerwa/euleragent

설정 예시

workspace.yaml로 에이전트 환경을 선언적으로 구성합니다

workspace.yaml

llm_profiles: local: provider: ollama model: qwen3:32b openai: provider: openai model: gpt-4o-mini is_external: true default_llm_profile: local memory: enabled: true mcp: enabled: true

EulerAgent로 안전한 AI 에이전트를 시작하세요

오픈 소스, 인간 승인 기반, 로컬 우선 실행.

GitHub에서 시작하기 문의하기