gs-ai/amber-iciAMBER ICI v5: 사건 범위 증거, 에이전트 체인, 하이브리드 검색, 스트리밍 분석, 그래프 및 타임라인 뷰, OCR, 통제된 웹 조사, 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 패널은 비어 있는 상태로 시작하며 두 가지 방법으로 채웁니다:
+ CREATE AGENT — 직접 하나를 정의합니다GENERATE FROM PROMPT — 목표를 설명하면 선택된 로컬 플래너 모델이 에이전트 세트를 작성합니다각 에이전트는 자체 런타임 구성을 저장합니다:
| 필드 | 기본값 | 비고 |
|---|---|---|
| 에이전트 이름 | — | 필수 |
| 에이전트 목적 | — | [AGENT PURPOSE]로 주입됨 |
| 에이전트 시스템 프롬프트 | — | 에이전트의 역할 지시 |
| 선호 로컬 모델 | — | 필수; Ollama에 설치되어 있어야 함 |
| Temperature | 0.35 | 에이전트별 설정, 콘솔의 TEMP pill과 독립적 |
| 최대 출력 토큰 | 0 (자동) | 0은 AMBER의 길이 휴리스틱을 사용 |
| 루프 | 1 | 이 에이전트가 체인 루프당 수행하는 패스 수, 각 패스는 자체 이전 출력을 개선함 |
| 출력 형식 | 일반 텍스트 | JSON은 Ollama의 JSON 모드를 설정하고 길이 확장을 건너뜀 |
| 핸드오프 지시 | — | 다음 순차 에이전트에 [HANDOFF FROM PREVIOUS AGENT]로 전달됨 |
| 실행 모드 | sequential | sequential, parallel, 또는 gated |
| 출력 대상, 메모리 범위, 역할, 도구 접근, 활성화, 비고 | — | ADVANCED 아래에 있음 |
체인 실행. EXEC를 AGENTS로 설정하고 메인 터미널에 프롬프트를 입력한 뒤 SEND를 누릅니다. AMBER는 선택된 모드, 활성화된 에이전트, 각 에이전트의 로컬 모델, AGN 개수, LOOPS 개수를 읽은 후 실행합니다: parallel 에이전트를 동시에 실행한 뒤, 카드 순서대로 sequential 에이전트를 루프당 한 번씩 실행합니다. 각 순차 에이전트는 이전 에이전트의 출력을 [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
필요한 임베딩 모델과 최소 하나의 생성 모델을 가져오세요:
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단계):
npm start # 127.0.0.1:8765, no browser tab
npm run start:browser # same, and opens the browser
python3로 직접 실행하는 것이 가장 이식성이 뛰어난 방법입니다.