gs-ai/amber-iciAMBER ICI v5: ケース単位の証拠管理、エージェントチェーン、ハイブリッド検索、ストリーミング分析、グラフおよびタイムライン表示、OCR、制御されたWebリサーチ、GPUテレメトリを備えた、ローカルファーストのOllama調査コマンドセンター。
AMBER ICI（AMBER Investigative Command Interface）は、ローカルの Ollama サーバーを基盤とする、調査・分析ワークフロー向けのローカルファーストなブラウザインターフェースです。
以下を含みます：
SEND ボタンから駆動されるユーザー定義のエージェントチェーンOllama の推論は、UI によってループバックエンドポイント（127.0.0.1、localhost、または ::1）に制限されています。AMBER にはクラウド推論やアプリケーションテレメトリは含まれておらず、いかなる機能もログイン、API キー、アカウントを必要としません。WEB ピルはすべてのインターネットアクセスに対するマスタースイッチです。これが OFF のとき、AMBER はいかなる種類の外向きリクエストも行いません。
STOP または Esc で実行中の処理を停止コンソールのピルバーには実行コントロールが並びます：
| ピル | 値 | 目的 |
|---|---|---|
TEMP / CTX / MEM / FMT / STREAM / SEED / SYS | — | Analyst モードの推論設定 |
WEB | OFF（デフォルト）/ ON | すべてのインターネットアクセスに対するマスタースイッチ |
EXEC | ANALYST（デフォルト）/ AGENTS | SEND が実行する内容：単一のアクティブモデル、またはエージェントチェーン |
AGN | 0 = すべて | チェーンが実行するエージェント数（カード順に取得） |
LOOPS | 1 以上 | チェーンを繰り返す回数。Agents パネルの LOOPS フィールドと連動 |
エージェントはユーザー定義であり、主要な実行パスです。組み込みまたは固定のエージェントリストは存在しません。Agents パネルは空の状態で開始し、次の 2 つの方法で設定します：
+ CREATE AGENT — 手動で 1 つ定義GENERATE FROM PROMPT — 目的を記述すると、選択したローカルプランナーモデルがエージェントセットを作成各エージェントは独自のランタイム設定を保持します：
| フィールド | デフォルト | 備考 |
|---|---|---|
| エージェント名 | — | 必須 |
| エージェントの目的 | — | [AGENT PURPOSE] として注入される |
| エージェントのシステムプロンプト | — | エージェントの役割指示 |
| 優先ローカルモデル | — | 必須。Ollama にインストールされている必要がある |
| Temperature | 0.35 | エージェントごとに設定。コンソールの TEMP ピルとは独立 |
| 最大出力トークン数 | 0（自動） | 0 の場合は AMBER の長さヒューリスティックを使用 |
| ループ回数 | 1 | このエージェントがチェーンループごとに実行するパス数。各パスで自身の前回出力を改善する |
| 出力形式 | プレーンテキスト | JSON を指定すると Ollama の JSON モードが設定され、長さ拡張がスキップされる |
| ハンドオフ指示 | — | 次の順次エージェントに [HANDOFF FROM PREVIOUS AGENT] として渡される |
| 実行モード | sequential | sequential、parallel、または gated |
| 出力ターゲット、メモリスコープ、役割、ツールアクセス、有効化、備考 | — | ADVANCED の下 |
チェーンの実行。 EXEC を AGENTS に設定し、メインターミナルにプロンプトを入力して SEND を押します。AMBER は選択されたモード、有効なエージェント、各エージェントのローカルモデル、AGN の数、LOOPS の数を読み取り、実行します。まず parallel エージェントが並行して実行され、続いて sequential エージェントがカード順に、ループごとに 1 回実行されます。各順次エージェントは前のエージェントの出力を [UPSTREAM OUTPUT] として受け取り、さらにそのエージェントのハンドオフメモも受け取ります。進捗と各エージェントのストリーミング出力はメインターミナルに表示され、最終的な回答は会話履歴に保持されます。Agents パネルの RUN ボタンも、パネル独自の LOOPS フィールドを使用して同じ処理を行います。
AGENTS モードでは、各エージェントが独自のモデルを持っているため、SEND に Models パネルでのアクティブモデルは必要ありません。gated エージェントはチェーンから除外されます。個別に実行するには、そのカードの RUN ボタンを使用してください。
不足しているモデルが代替されることはありません。 Ollama に存在しないモデルでエージェントを保存したりチェーンを開始したりすると、要求されたモデル名、実際にインストールされているモデル、および必要な ollama pull <model> コマンドを示す実行可能なブロックがターミナルに表示され、実行は開始されません。
保存されたエージェントセットは、Agents パネルから名前で保存および復元できます。
以前の
PIPELINE/CHAINステップシーケンスモードはインターフェースから廃止されました。そのエンジンとstate/pipeline_state.jsonは後方互換性のために残されていますが、選択可能なモードではなくなりました。エージェントが実行チェーンとなります。
embeddinggemma:latest を使用してファイルをチャンク化および埋め込みキューに登録FAST、HYBRID、DEEP の検索プロファイルを提供アーカイブには、既存の全アーカイブワークフローを置き換えることなく、オプションのケース境界が追加されました。
NEW CASE はローカルのケースメタデータを作成します。ADD ACTIVE TO CASE は選択したファイルを証拠として記録し、既存の生アップロードを保持し、ストリーミング SHA-256 識別子を計算し、取り込みの来歴を記録します。REMEMBER LAST は、最新のアシスタント出力をラベル付きのケースメモリとして明示的に保存します。モデル出力が証拠やメモリに暗黙的に昇格されることはありません。ADD INVESTIGATION ROLES は、オプションの Director、Researcher、Investigator、Analyst、Documenter、Critic テンプレートを既存のユーザー定義エージェントレジストリに追加します。これらはオペレーターが選択したローカルモデルを使用し、自動的には実行されません。ケースインテリジェンスは、単一のバージョン管理された標準ライブラリ JSON ストアにアトミックに保存され、AMBER の既存の Ollama クライアントを使用します。
ヘッダーから以下のツールが別タブで開きます。
http://127.0.0.1:8765/amber_graph.htmlhttp://127.0.0.1:8765/amber_timeline.htmlhttp://127.0.0.1:8765/amber_vectorstore.htmlコアランタイム:
pip install は不要ですembeddinggemma:latestオプション機能:
ocrmypdf と Tesseractpsutil、nvidia-smi、または osx-cpu-temp。利用できない値は単に空白のままになります上記はすべてローカルです。どのコンポーネントもアカウント、API キー、クラウドサービスを必要としません。
git clone https://github.com/gs-ai/AMBER-ICI.git
cd AMBER-ICI
別のターミナルで:
ollama serve
必要な埋め込みモデルと少なくとも1つの生成モデルをプルします:
ollama pull embeddinggemma:latest
ollama pull qwen2.5-coder:7b
生成モデルはあくまで一例です。AMBER は Ollama からローカルにインストールされたモデルを検出します。
コアバックエンドは Python 標準ライブラリのみをインポートするため、直接起動する場合は仮想環境は任意です。それでも、npm スクリプト（venv/bin/python3 を呼び出します）やオプションの Pillow サポートを利用したい場合は、仮想環境を作成してください:
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
python3 -m pip install --upgrade pip
requirements.txt は存在しません。必須の依存関係がないためです。オプションの追加パッケージは、必要な場合にのみその環境へインストールしてください:
python3 -m pip install Pillow # optional: WebP conversion before OCR
deactivate で無効化します。以前の AMBER バージョンが venv/ に未使用のパッケージ（例えば camoufox）を残している場合、それらは現在のコードではインポートされないため、無視するか削除できます。
python3 files/launch_amber_ici_gui.py
AMBER はブラウザを自動的に開きます。タブを開かずに起動するには:
python3 files/launch_amber_ici_gui.py --no-browser
次に、http://127.0.0.1:8765/amber_ui.html を開きます。
WEB ピルをオンにする予定がある場合にのみ必要です:
npm install # playwright, playwright-extra, stealth plugin
npx playwright install chromium # the browser binary itself
AMBER を実行した状態で、ヘルパーが実行可能であることを確認します。これにより、ヘルパーのパス、解決された node バイナリ、および不足しているパッケージが報告されます:
curl -s http://127.0.0.1:8765/api/web/status
AMBERはJavaScriptでレンダリングされるページに対してNode/Chromiumヘルパーを使用し、直接URLに対してはプレーンなPython HTTPフェッチをフォールバックとして使用します。records-searchヘルパーはNode.js、npm依存関係、およびChromiumを必要とし、プレーンHTTPのフォールバックはありません。
Homebrewを使用したmacOS:
brew install ocrmypdf tesseract
python3 -m pip install Pillow
Ubuntu/Debian:
sudo apt-get update
sudo apt-get install -y ocrmypdf tesseract-ocr
python3 -m pip install Pillow
Pillowは、Tesseractが処理する前に変換が必要な画像形式にのみ必要です。オプションのOCR依存関係が欠けていても、AMBERは実行を継続します。
提供されているnpmスクリプトはvenv/bin/python3でAMBERを起動するため、まずその環境を作成してください（ステップ3）：