usepr/eva

何を解決するか

EVAは、スクリプトの作成、テストケースの生成、シェルコマンドの実行、データ分析などの技術的タスクを自動化するための軽量なAIエージェントです。複雑なエージェントフレームワークの代替として、高ポータビリティ・低オーバーヘッドを実現し、単一のPythonファイルとして機能するエージェントを簡単にデプロイできるように設計されています。

動作方法

EVAは、OpenAI API形式をサポートする任意のLLM（vLLMやOllamaを介したローカルモデル、またはDeepSeekやOpenAIなどのクラウドAPI）に接続する単一のPythonスクリプト（eva.py）として動作します。現在のディレクトリにスコープされたセッション履歴を維持しており、同じフォルダ内で再起動してもコンテキストを記憶します。また、EVA.mdという設定ファイルを使って、エージェントのキャラクター、設定、スキルを定義しています。

対象ユーザー

ターミナルベースの自動化やシェル実行に迅速かつポータブルなAIアシスタントが必要な開発者やシステム管理者向けに設計されています。複雑なインストールプロセスを必要としません。

特徴

• 単一ファイルアーキテクチャ：エージェント全体が1つのeva.pyファイルに収容されており、簡単に「貼り付けて実行」できるデプロイが可能。
• ディレクトリスコープセッション：作業ディレクトリに基づいて自動的に会話履歴を永続化・再開。
• セキュリティレビュー：デフォルトでは、書き込み/実行コマンドに対してユーザーの確認を要求しますが、特定のフラグで無効化可能です。
• ローカルモデル対応：OpenAI互換APIと互換性があり、完全にローカルでの実行が可能。
• ゴールモード：特定の目標が達成されるまでループするための-gフラグを備えています。