EulerAgent

ローカルファースト CLI エージェントフレームワーク

8 段階ステートマシン(RUN_CREATED → CONTEXT → PLAN → PROPOSE → APPROVE → EXECUTE → RESULT → FINALIZED)、Pattern/Graph オーケストレータ、RAG パイプライン、長期記憶(SQLite)、MCP 統合、プラグインシステムを備えた、人間の承認(HITL)に基づくローカルファーストのエージェントフレームワークです。検証を LLM ではなくコードで実行する決定論的ゲートノードkind: shell)の上で、自ら書き・テストし・修正する自己修復型コーディングエージェントcode.dev_loop.v2)を提供します。30 以上の CLI コマンド、65 個のフィクスチャ。

Open Source

主要機能

8 段階ステートマシン、記憶、オーケストレーション、MCP、プラグイン -- EulerAgent の中核軸

Human-in-the-Loop セキュリティ

  • Deny-All セキュリティモデル:すべてのツールがデフォルトでブロック、明示的な許可が必要
  • 人間の承認必須:高リスクアクション(ファイル書き込み、シェル実行、外部呼び出し)は必ず人間の承認が必要
  • 8段階ステートマシン: CREATE → CONTEXT → PLAN → PROPOSE → APPROVE → EXECUTE → RESULT → FINALIZE
  • 完全な監査証跡:Audit Trailですべてのアクションを記録

長期記憶 & RAG

  • SQLiteベース:会話履歴とベクトル検索
  • 自動コンテキスト抽出:ユーザーの好みとプロジェクトコンテキストを自動学習
  • ハイブリッドRAG:ローカルナレッジベース + ウェブ検索
  • MCP検索プロバイダー:Brave、Tavilyなどを統合

ワークフローオーケストレーション

  • Pattern Orchestrator:YAML ベースのワークフロー — LLM · 判定(judge) · 決定論的 shell ゲートノード(12 個の正規パターン、5 個の組み込み)
  • 決定論的ゲートノード NEW検証を LLM なしでコードとして実行 — exit_code / success_condition DSL で分岐(認知=LLM、決定論=コードを分離)
  • 自己修復型コーディングエージェント NEW code.dev_loop.v2 — explore → plan → write → syntax/symbol ゲート → test → judge → fix ループを自律実行
  • Graph Orchestrator:LangGraph ベースの並列実行(実験的)

エージェントテンプレート

用途に合ったテンプレートでエージェントを素早く作成

テンプレート 用途
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をマスター

韓国語版チュートリアル | English Tutorials

チュートリアルは近日公開予定です。

インストールと始め方

EulerAgentをインストールして最初のエージェントを実行

インストール

pip install euleragent

# Ollamaモデルのダウンロード
ollama pull qwen3:32b

# ワークスペースの初期化
euleragent init

要件

  • Python 3.11+
  • Ollama(またはOpenAI/Gemini APIキー)

設定例

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で始める お問い合わせ