EulerAgent

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

Human-in-the-Loop(HITL)承認に基づく安全なエージェントフレームワーク。すべてのアクションがログに記録され、監査され、承認を経ます。長期記憶とRAGによりセッションを超えてコンテキストを維持します。

Open Source

主要機能

安全性、記憶、オーケストレーション -- EulerAgentの3つの柱

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ベースのワークフロー(12の正規パターン)
  • Graph Orchestrator:LangGraphベースの並列実行(実験的)
  • 動的タスク分解: --dynamic オプション
  • 判定ノードと品質ループ:出力品質の自動評価と反復

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

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

テンプレート 用途
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で始める お問い合わせ