EmberSpark — オープンソースのAIエージェントフレームワーク
EmberSparkは、境界付き自律性を土台に設計された、オープンソースでローカルファーストのAIエージェントランタイムです。Dockerを使えば数分でデプロイできます。Apache 2.0ライセンスで、LangGraphによる実行、BudgetGuardによる制限、ローカルのOllamaを含む4つのLLMプロバイダーに対応します。
“オープンが既定。境界は設計。”
EmberSparkを入手
docker compose upの1コマンドで。Apache 2.0、GitHubで公開されているオープンソースです。
EmberSpark
提供：Veilfire
Dockerで実行
git clone https://github.com/Veilfire/EmberSpark.git
cd EmberSpark
docker compose upフォアグラウンドで実行されます。初回はイメージのビルドに約5〜10分かかります。Web UIはhttp://0.0.0.0:7777です。
認証情報の表示は一度きり
初回起動時、EmberSparkはWeb UIへのサインイン用の認証情報を、一度限りのバナーとしてコンソールに表示します。すぐに保存してください。見逃した場合はdocker compose logs -f sparkで再表示できます。
ライフサイクル
docker compose up -d # background
docker compose logs -f spark # tail logs / re-show credentials
docker compose down # stop, KEEP volumes
docker compose down --volumes # stop + WIPE state永続ボリューム
名前付きボリュームは2つです。認証情報とログ用のspark-state、SQLite・Chroma・成果物用のspark-dataです。バインドアドレスとIP許可リストはdeploy/docker/spark.yamlで設定します。
エージェント型AIに関するリスク告知
エージェント型AIはさまざまな水準の自律性で動作し、見知らぬ利用者に自分のコンピュータ上で作業を許可することに匹敵する固有のリスクを伴います。EmberSparkをダウンロードして使用することにより、お客様はこれらのリスクを認識し、エージェントが行うあらゆる操作について全面的な責任を負うことに同意したものとみなされます。Veilfireはいかなる保証も行わず、自律的なAIの動作に起因する損害について一切の責任を負いません。自律性のレベルはご自身の責任で設定してください。
EmberSparkの違い
多くのオープンソースAIエージェントフレームワークは、安全性を後付けのラベルとして扱います。EmberSparkは安全性を設計上の制約として扱います。
境界付き自律性
既定はクローズドです。すべてのツールが権限、入力、出力、機微度を宣言します。BudgetGuardが反復回数、モデル呼び出し、ツール呼び出し、トークン、実時間、コストに上限を設けます。
必須のOSサンドボックス
ツールの実行はBubblewrap、sandbox-exec、nsjailのいずれかの内部で行われます。ベストエフォートではなく多層防御です。Dockerイメージに同梱されているため、別途インストールや設定を行う必要はありません。
設計からローカルファースト
Ollamaにネイティブ対応しているため、どのクラウドプロバイダーにもデータを送らずにエージェントをエンドツーエンドで実行できます。規制環境、プライバシーに配慮したワークフロー、オフライン利用に適しています。
17種類の組み込みプラグイン
ファイルシステム、HTTP、シェル、SQLite、Web検索、PDFリーダー、Gitなどを備えます。すべて宣言的で、すべてサンドボックス化され、すべてオプトインです。シンプルなPythonインターフェースで独自のプラグインを追加できます。
3層構造のメモリ
タスクメモリ（一時的）、セッションメモリ（SQLite）、長期メモリ（Chromaベクトルストア）の3層です。テナント単位で分離され、ポリシー検査を受け、検索も可能です。
既定で有効なマスキング
detect-secretsとMicrosoft Presidioが、データがLLMプロバイダーに届く前に、エージェントのコンテキストからAPIキー、認証情報、個人情報、固有表現を除去します。
モデルを選ぶ
完全オフラインのエージェントを実現するローカルのOllamaを含む、4つのLLMプロバイダーに対応します。
OpenAI
GPT-4シリーズ、GPT-5シリーズなど
Anthropic
Claude Opus、Sonnet、Haiku
OpenRouter
100以上のモデルへ統一的にアクセス
Ollama (local)
エージェントを完全オフラインで実行。推論にクラウド依存はありません。
Web UIを標準搭載
docker compose upを実行すると、localhost:7777で完全なオペレーターコンソールが起動し、初回のみ生成される認証情報でサインインできます。
スケジューラ
循環検知を備えたcron形式のタスクスケジューリング
チャット
ブラウザからエージェントと対話
コスト追跡
タスク単位の予算とリアルタイムのコストテレメトリ
セキュリティセンター
監査ログの確認、マスキング設定、実行のリプレイ
EmberSparkとVeilfireの関係
EmberSparkとVeilfire Platformは同じ安全性の思想を共有しています。EmberSparkはオープンソースの実証の場であり、プラットフォームはエンタープライズの本番環境に届けるものです。
| 機能 | EmberSpark （オープンソース） | Veilfire Platform （エンタープライズ） |
|---|---|---|
| エージェントランタイム | シングルエージェント、ローカルファースト | Emberによるマルチエージェントフリート |
| サンドボックス | OSレベル（Bubblewrap／sandbox-exec／nsjail） | OS＋コンテナ＋クラスタの分離 |
| ポリシー適用 | サンドボックスとBudgetGuardによる制限 | Lensによるランタイム適用（p95で2ms未満） |
| 安全性評価 | テストによる自前対応 | Insightの5本柱評価フレームワーク |
| 監査証跡 | ローカルのJSONL | KMS署名付きの暗号学的Merkleチェーン |
| コンプライアンス報告 | 自己管理 | EU AI Act、NIST AI RMF、ISO 42001、SOC 2、カナダのAIガバナンス |
| ライセンス | Apache 2.0 | 商用 |
クイックスタートガイド
docker compose upから最初のエージェントタスク実行まで、5つのステップで進めます。
リポジトリをクローンする
EmberSparkのリポジトリを取得し、プロジェクトディレクトリに移動します。
git clone https://github.com/Veilfire/EmberSpark.git
cd EmberSparkDocker Composeで起動する
イメージをビルドし（初回は約5〜10分）、ランタイム、サンドボックス、Web UIを1つのコマンドで立ち上げます。
docker compose up一度限りの認証情報を保存する
初回起動時、EmberSparkは認証情報のバナーをコンソールに表示します。表示は一度きりです。その場でコピーしてください。見逃した場合は次のコマンドで再表示できます：docker compose logs -f spark
# look for the banner in the docker compose output
# format: "DISPLAYED ONCE; save them now"Web UIを開く
オペレーターコンソールは既定で0.0.0.0:7777にバインドされています。ステップ3の認証情報でサインインしてください。
open http://0.0.0.0:7777 # or visit in your browserAIプロバイダーを設定する
Web UIからOpenAI、Anthropic、OpenRouterのAPIキーを追加するか、完全オフラインで推論する場合はローカルのOllamaインスタンスを指定します。その後、同梱のサンプルから最初のエージェントタスクを実行してください。
# in the web UI:
# Settings → Providers → add API key
# Tasks → Run example → weekly-digestプラグイン一覧
すべてのプラグインは、機微度、サンドボックスの要件、権限を宣言します。以下は17種類の組み込みプラグインからの代表的な抜粋です。
| プラグイン | カテゴリ | サンドボックスの注記 |
|---|---|---|
| filesystem | I/O | パス許可リスト、既定は読み取り専用 |
| http | ネットワーク | ドメイン許可リスト、対応時はHMAC |
| shell | 実行 | Bubblewrap／sandbox-execでサンドボックス化 |
| sqlite | ストレージ | タスク単位のDBスコープ |
| web_search | ネットワーク | プロバイダーを差し替え可能 |
| pdf_reader | I/O | ローカルファイルの取り込みのみ |
| git | 実行 | リポジトリ許可リストが必須 |
| 他10件 | 各種 | 完全な一覧はリポジトリを参照 |
次の段階へ進みませんか
EmberSparkは、手元のノートPCで境界付き自律性を実現します。Veilfire Cloudは同じ安全性の思想を本番環境へ持ち込み、ランタイムでの適用、エージェントID、評価、HITL、暗号学的な監査エビデンスを提供します。本番規模でエージェントを統制する段階になったら、EmberSparkからVeilfire Cloud上のEmberへ移行してください。
EmberSparkは今後もオープンソース、Apache 2.0のままです。