AMBER ICI v5: centro di comando investigativo Ollama local-first con evidenze limitate al caso, catene di agenti, retrieval ibrido, analisi in streaming, viste grafo e timeline, OCR, ricerca web controllata e telemetria GPU.
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12061/b3526255ef1a43950d559d01043863d61c0ef36cfbf4e3270caef742cde07d9e.png" alt="Banner dell'interfaccia AMBER ICI" width="1200" /> </p> # AMBER ICI v5 AMBER ICI (AMBER Investigative Command Interface) è un'interfaccia browser local-first per flussi di lavoro investigativi e analitici alimentata da un server locale [Ollama](https://ollama.com/). Include: - Una Console Analyst a modello singolo ed esecuzione Parallela multi-modello - Una catena di agenti definita dall'utente avviata dal pulsante `SEND` del terminale principale - Controllo dell'utente su quali agenti eseguire, quanti, quanti cicli e quale modello locale usi ciascuno - Generazione locale, tramite modelli, di configurazioni di agenti a partire da un obiettivo in linguaggio naturale - Un Archivio semantico persistente basato sugli embedding di Ollama - Recupero frattale di Fibonacci per il contesto dei file attivi - Caricamento di file, accesso in sola lettura a directory collegate, estrazione di testo e OCR - Fetch web opzionale basato su Playwright e ricerca nei registri pubblici, dietro un unico interruttore principale - Viste autonome per grafo delle entità, timeline e vector store - Telemetria locale di token-rate, sessione, GPU/VRAM e temperatura ove disponibile L'inferenza Ollama è limitata dall'interfaccia agli endpoint di loopback (`127.0.0.1`, `localhost` o `::1`). AMBER non include inferenza cloud né telemetria applicativa, e nessuna funzionalità richiede login, chiavi API o account. La pillola `WEB` è l'interruttore principale per tutti gli accessi a Internet: con essa `OFF`, AMBER non effettua alcuna richiesta in uscita di alcun tipo. ## Novità della v5 - Workspace di caso locali con evidenze e recupero dall'Archivio limitati al caso - Identità degli artefatti tramite SHA-256 in streaming, provenienza dell'ingestione, rilevamento dei duplicati e citazioni delle fonti - Recupero deterministico per parole chiave fuso con i risultati esistenti dell'Archivio semantico - Memoria esplicita e limitata, con ambito su sessioni, investigatori, casi, agenti o attività di ragionamento - Template di ruolo investigativo selezionati dall'operatore tramite i modelli Ollama locali installati - Esecuzione degli agenti dal terminale principale con modelli per agente, limiti, formati, passaggi di consegne e controlli dei cicli - Preflight WEB di Playwright, diagnostica di esecuzione visibile, fallback al fetch diretto e caching locale di un'ora - Rilevamento hardware in cache con segnalazione di Metal, CUDA, ROCm, memoria unificata, utilizzo e temperatura - Aggiornamenti in streaming coalescenti per un output lungo e reattivo - Metadati persistiti limitati, contenuto UI generato con escaping, dipendenze Node riproducibili ed esclusioni ampliate per runtime sensibili ## Set di funzionalità attuale ### Console Analyst - Trasmette in streaming una conversazione con un modello Ollama selezionato - Supporta prompt di sistema, modalità output JSON, seed, temperatura e dimensione CTX - Inietta il contesto del file attivo, quello web opzionale e quello della conversazione conservata - Interrompe il lavoro attivo con `STOP` o `Esc` La barra delle pillole della console contiene i controlli di esecuzione: | Pillola | Valori | Scopo | |---|---|---| | `TEMP` / `CTX` / `MEM` / `FMT` / `STREAM` / `SEED` / `SYS` | — | Impostazioni di inferenza in modalità Analyst | | `WEB` | `OFF` (predefinito) / `ON` | Interruttore principale per tutti gli accessi a Internet | | `EXEC` | `ANALYST` (predefinito) / `AGENTS` | Cosa esegue `SEND`: il singolo modello attivo o la catena di agenti | | `AGN` | `0` = tutti | Quanti agenti esegue la catena, presi nell'ordine delle schede | | `LOOPS` | `1`+ | Quante volte la catena si ripete; sincronizzato con il campo `LOOPS` del pannello Agents | ### Parallel - Esegue lo stesso prompt su tutti i modelli selezionati - Trasmette e traccia ogni risposta in modo indipendente - Applica gli stessi controlli CTX e file attivo usati dalla Console Analyst ### Agents — la catena di esecuzione Gli agenti sono definiti dall'utente e costituiscono il percorso di esecuzione principale. Non esiste un elenco di agenti predefinito o fisso; il pannello Agents parte vuoto e lo si popola in due modi: - `+ CREATE AGENT` — definisci un agente manualmente - `GENERATE FROM PROMPT` — descrivi un obiettivo e un modello planner locale selezionato scrive per te l'insieme di agenti Ogni agente memorizza la propria configurazione di runtime: | Campo | Predefinito | Note | |---|---|---| | Nome agente | — | Obbligatorio | | Scopo agente | — | Iniettato come `[AGENT PURPOSE]` | | Prompt di sistema agente | — | L'istruzione di ruolo dell'agente | | Modello locale preferito | — | Obbligatorio; deve essere installato in Ollama | | Temperatura | `0.35` | Per agente, indipendente dalla pillola `TEMP` della console | | Token massimi di output | `0` (auto) | `0` utilizza l'euristica di lunghezza di AMBER | | Cicli | `1` | Passaggi che questo agente esegue per ogni ciclo della catena, ciascuno raffinando il proprio output precedente | | Formato di output | testo semplice | `JSON` imposta la modalità JSON di Ollama e salta l'espansione della lunghezza | | Istruzioni di passaggio | — | Passate all'agente sequenziale successivo come `[HANDOFF FROM PREVIOUS AGENT]` | | Modalità di esecuzione | `sequential` | `sequential`, `parallel` o `gated` | | Destinazione output, ambito memoria, ruolo, accesso agli strumenti, abilitato, note | — | In `ADVANCED` | **Esecuzione della catena.** Imposta `EXEC` su `AGENTS`, digita un prompt nel terminale principale e premi `SEND`. AMBER legge la modalità selezionata, gli agenti abilitati, il modello locale di ciascun agente, il conteggio `AGN` e il conteggio `LOOPS`, quindi esegue: gli agenti `parallel` in modo concorrente, seguiti dagli agenti `sequential` nell'ordine delle schede, una volta per ciclo. Ogni agente sequenziale riceve l'output dell'agente precedente come `[UPSTREAM OUTPUT]` più la nota di passaggio di quell'agente. L'avanzamento e l'output in streaming di ogni agente vengono stampati nel terminale principale, e la risposta finale viene conservata nella cronologia della conversazione. Il pulsante `RUN` del pannello Agents fa la stessa cosa usando il campo `LOOPS` del pannello stesso. In modalità `AGENTS`, `SEND` non richiede un modello attivo nel pannello Models, perché ogni agente porta il proprio. Gli agenti `gated` sono esclusi dalla catena — eseguili singolarmente con il pulsante `RUN` della loro scheda. **I modelli mancanti non vengono mai sostituiti.** Salvare un agente o avviare una catena con un modello che Ollama non possiede stampa nel terminale un blocco con azioni da intraprendere che indica il modello richiesto, i modelli effettivamente installati e il comando `ollama pull <model>` necessario, e l'esecuzione non parte. I set di agenti salvati possono essere memorizzati e ripristinati per nome dal pannello Agents. > La precedente modalità di sequenza di passaggi `PIPELINE` / `CHAIN` è stata ritirata dall'interfaccia. Il suo motore e `state/pipeline_state.json` restano in vigore per compatibilità retroattiva, ma non è più una modalità selezionabile; gli agenti costituiscono la catena di esecuzione. ### Archivio e Memoria - Suddivide in chunk e incorpora i file in coda con `embeddinggemma:latest` - Cerca nell'archivio locale per similarità coseno - Importa ed esporta l'archivio JSON - Aggiunge direttamente all'archivio l'output più recente dell'assistente - Costruisce un indice frattale di Fibonacci nel browser per il recupero delle sorgenti dei file - Offre i profili di recupero `FAST`, `HYBRID` e `DEEP` ### Case Intelligence L'Archivio ora include un confine di caso opzionale senza sostituire il suo flusso di lavoro esistente sull'intero archivio: - `NEW CASE` crea i metadati locali del caso. - `ADD ACTIVE TO CASE` registra i file selezionati come prove, conserva il caricamento grezzo esistente, calcola un'identità SHA-256 in streaming e registra la provenienza dell'acquisizione. - I vettori dell'archivio indicizzati mentre è selezionato un caso portano quell'ID del caso. Le ricerche del caso fondono quei risultati semantici con un fallback deterministico per parole chiave quando entrambi sono disponibili. - `REMEMBER LAST` salva esplicitamente l'output più recente dell'assistente come memoria del caso etichettata. L'output del modello non viene mai promosso silenziosamente a prova o memoria. - `ADD INVESTIGATION ROLES` aggiunge modelli opzionali Director, Researcher, Investigator, Analyst, Documenter e Critic al registro degli agenti definiti dall'utente esistente. Utilizzano il modello locale selezionato dall'operatore e non vengono eseguiti automaticamente. L'intelligence del caso è memorizzata in modo atomico in un unico archivio JSON versionato della libreria standard e utilizza il client Ollama esistente di AMBER. ### Viste Standalone L'intestazione apre questi strumenti in schede separate: - Entity Provenance Graph: `http://127.0.0.1:8765/amber_graph.html` - Timeline: `http://127.0.0.1:8765/amber_timeline.html` - Vector Store manager: `http://127.0.0.1:8765/amber_vectorstore.html` ## Requisiti Runtime principale: - Python 3.10 o versione successiva; il launcher e il backend principale utilizzano solo la libreria standard, quindi non è necessario `pip install` per eseguire AMBER - Ollama installato e in esecuzione localmente - Almeno un modello di generazione Ollama - `embeddinggemma:latest` per l'indicizzazione dell'Archivio e la ricerca semantica Funzionalità opzionali: - Node.js 18+ e npm, oltre alle dipendenze del progetto, per i recuperi web renderizzati in JavaScript e la ricerca nei record - Un browser Chromium di Playwright per queste funzionalità basate sul browser - `ocrmypdf` e Tesseract per l'OCR dei PDF - Tesseract per l'OCR delle immagini - Pillow per convertire le immagini WebP prima dell'OCR quando Tesseract non riesce a leggerle direttamente - `psutil`, `nvidia-smi` o `osx-cpu-temp` per metriche di sistema aggiuntive; le letture non disponibili rimangono semplicemente vuote Tutto quanto sopra è locale. Nessun componente richiede un account, una chiave API o un servizio cloud. ## Installazione ed esecuzione ### 1. Clonare il repository ```bash git clone https://github.com/gs-ai/AMBER-ICI.git cd AMBER-ICI ``` ### 2. Avvia Ollama In un terminale separato: ```bash ollama serve ``` Esegui il pull del modello di embedding richiesto e di almeno un modello di generazione: ```bash ollama pull embeddinggemma:latest ollama pull qwen2.5-coder:7b ``` Il modello di generazione è solo un esempio; AMBER scopre i modelli installati localmente da Ollama. ### 3. Creare l'ambiente Python Il backend principale importa solo la libreria standard di Python, quindi un ambiente virtuale è opzionale per un avvio diretto. Creane comunque uno se vuoi usare gli script npm (che richiamano `venv/bin/python3`) o il supporto opzionale di Pillow: ```bash python3 -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate python3 -m pip install --upgrade pip ``` Non esiste alcun `requirements.txt` perché non è richiesto nulla. Installa gli extra opzionali in quell'ambiente solo se li desideri: ```bash python3 -m pip install Pillow # optional: WebP conversion before OCR ``` Disattivalo con `deactivate`. Se una versione precedente di AMBER ha lasciato pacchetti inutilizzati in `venv/` (ad esempio `camoufox`), questi non vengono importati dal codice attuale e possono essere ignorati o rimossi. ### 4. Avvia l'applicazione principale ```bash python3 files/launch_amber_ici_gui.py ``` AMBER apre automaticamente il browser. Per avviare senza aprire una scheda: ```bash python3 files/launch_amber_ici_gui.py --no-browser ``` Poi apri `http://127.0.0.1:8765/amber_ui.html`. ### 5. Installa le funzionalità web opzionali supportate dal browser Necessario solo se intendi attivare la pillola `WEB`: ```bash npm install # playwright, playwright-extra, stealth plugin npx playwright install chromium # the browser binary itself ``` Verifica che gli helper siano eseguibili — con AMBER in esecuzione, questo riporta i percorsi degli helper, il binario `node` risolto e qualsiasi pacchetto mancante: ```bash curl -s http://127.0.0.1:8765/api/web/status ``` AMBER utilizza l'helper Node/Chromium per le pagine renderizzate in JavaScript, con un recupero HTTP semplice in Python come fallback per gli URL diretti. L'helper per la ricerca dei record richiede Node.js, le dipendenze npm e Chromium; non dispone di un fallback HTTP semplice. ### 6. Installare il supporto OCR opzionale macOS con Homebrew: ```bash brew install ocrmypdf tesseract python3 -m pip install Pillow ``` Ubuntu/Debian: ```bash sudo apt-get update sudo apt-get install -y ocrmypdf tesseract-ocr python3 -m pip install Pillow ``` Pillow è necessario solo per i formati immagine che richiedono una conversione prima che Tesseract possa elaborarli. AMBER continua a funzionare quando una qualsiasi dipendenza OCR opzionale è assente. ### Script di comodo npm Gli script npm forniti avviano AMBER con `venv/bin/python3`, quindi crea prima quell'ambiente (passo 3): ```bash npm start # 127.0.0.1:8765, no browser tab npm run start:browser # same, and opens the browser ``` L'avvio diretto con `python3` è l'opzione più portabile. ### Configurazione completa, dall'inizio alla fine ```bash git clone https://github.com/gs-ai/AMBER-ICI.git cd AMBER-ICI python3 -m venv venv # for the npm scripts npm install # optional: WEB features npx playwright install chromium # optional: WEB features ollama serve & # in its own terminal ollama pull embeddinggemma:latest # required for Archive ollama pull qwen2.5-coder:7b # any generation model npm start # → http://127.0.0.1:8765/amber_ui.html ``` ## Opzioni del Launcher ```bash python3 files/launch_amber_ici_gui.py --help ``` | Flag | Predefinito | Scopo | |---|---:|---| | `--host HOST` | `127.0.0.1` | Indirizzo su cui è in ascolto il server HTTP di AMBER | | `--port PORT` | `8765` | Porta del server HTTP di AMBER | | `--no-browser` | disattivato | Non aprire il browser predefinito | | `--gui PATH` | rilevato automaticamente | Serve un file HTML GUI specifico | | `--version` | — | Stampa la versione di rilascio di AMBER ICI ed esce | L'interfaccia browser accetta intenzionalmente solo URL Ollama di loopback anche se il server AMBER è associato a un'altra interfaccia. ## Flusso di lavoro al primo avvio 1. Verifica che l'endpoint Ollama in alto a destra sia `http://127.0.0.1:11434`. 2. Fai clic su `PING` per caricare i modelli installati localmente. 3. Seleziona un modello nel pannello Models. 4. Inserisci un prompt nella Analyst Console e fai clic su `SEND`. 5. Facoltativamente, carica file o collega una directory, quindi attiva i file per includerli nel contesto. 6. Esegui il pull di `embeddinggemma:latest` prima di indicizzare i file in Archive. Per eseguire invece la catena di agenti: 1. Apri la scheda `AGENTS` nel pannello sinistro. 2. Crea un agente con `+ CREATE AGENT`, oppure descrivi un obiettivo sotto `GENERATE FROM PROMPT`. 3. Imposta `EXEC` su `AGENTS` nella barra delle pillole della console. 4. Imposta `AGN` (quanti agenti; `0` = tutti) e `LOOPS` (quante passate). 5. Digita il prompt nel terminale principale e premi `SEND`. Per consentire ad AMBER di leggere internet, imposta prima la pillola `WEB` su `ON`; è `OFF` per impostazione predefinita. ## Acquisizione dei file I caricamenti sono limitati a 100 MiB per file. Il selettore di file e il percorso drag-and-drop attualmente accettano: - Documenti: `.txt`, `.md`, `.pdf`, `.docx`, `.rtf` - Dati/configurazione: `.csv`, `.xlsx`, `.json`, `.yaml`, `.yml`, `.toml`, `.ini`, `.cfg`, `.conf`, `.xml` - Sorgenti/log: `.py`, `.js`, `.ts`, `.tsx`, `.jsx`, `.html`, `.sql`, `.sh`, `.bash`, `.zsh`, `.log` - Immagini: `.png`, `.jpg`, `.jpeg`, `.bmp`, `.webp`, `.tif`, `.tiff`, `.svg` Comportamento dell'estrazione: - I file di testo semplice, sorgente, configurazione, CSV e RTF vengono decodificati come testo. - I fogli di lavoro XLSX vengono estratti con la libreria standard di Python; le formule e la formattazione complessa non vengono preservate. - Il testo DOCX viene estratto dall'XML del documento; il layout complesso non viene preservato. - L'estrazione PDF tenta prima il testo incorporato e tenta anche l'OCR quando `ocrmypdf` è installato, mantenendo il risultato più utile. - Le immagini raster utilizzano Tesseract OCR quando installato. L'estrazione SVG legge il contenuto incorporato `<text>` e `<tspan>`. I byte grezzi caricati vengono memorizzati in `uploads/blobs/`, il testo estratto in `uploads/texts/` e i metadati in `uploads/manifest.json`. ### Directory collegate `LINK DIRECTORY` espone ad AMBER i file supportati e non nascosti di una directory locale. Il pannello Files tratta le voci collegate come di sola lettura e l'elenco della directory non è ricorsivo. Il percorso selezionato viene memorizzato in `state/linked_dir_state.json`; il contenuto dei file rimane nella sua posizione originale e viene letto solo quando richiesto per il contesto o l'estrazione. Il selettore nativo delle cartelle utilizza Tkinter di Python. Se non è disponibile, l'interfaccia richiede manualmente un percorso. Scollegando la directory si rimuove il collegamento salvato ma non si eliminano i file di origine. Il backend riconosce alcuni formati aggiuntivi di file collegati (`.xls`, `.ods`, `.gif`, `.heic`, `.ico`, `.ppt`, `.pptx` e `.zip`). I formati privi di un estrattore di testo contribuiscono con un'etichetta di metadati anziché con contenuto decodificato. L'estrazione dei formati legacy `.xls` e `.ods` è best-effort e potrebbe segnalare che l'estrazione non è disponibile. ## Comportamento del contesto e della memoria Le opzioni CTX nell'interfaccia sono `2K`, `4K`, `8K`, `16K` e `32K` e si applicano alle chiamate Analyst, Parallel e Agent. - Prima dell'inferenza, `trimMsgsToCtx()` rimuove i messaggi non di sistema più vecchi finché la richiesta non rientra in circa il 90% del budget di contesto selezionato, stimato in quattro caratteri per token. - Il recupero dei file attivi interroga prima l'archivio frattale di Fibonacci, quando popolato, e ripiega sull'assemblaggio piatto del contesto dei file. - Il recupero utilizza fino a profondità 4, larghezza del fascio 2–4 e limiti di risultati dipendenti dal profilo. - Il contesto dei file attivi è limitato in base al profilo di memoria: circa `CTX × 2.6` caratteri in Fast, `CTX × 3.2` in Hybrid e `CTX × 4.0` in Deep. - Il contesto piatto sovradimensionato viene classificato con un punteggio di sovrapposizione delle parole chiave prima dell'iniezione. - L'iniezione nello scratchpad mantiene una coda di circa 8.000–20.000 caratteri ed è ulteriormente limitata dal budget di contesto dei file del profilo attivo. - Gli agenti con memoria completa ricevono gli ultimi sei messaggi della conversazione. La memoria locale utilizza una coda dello scratchpad; `none` disabilita tale richiamo. Queste sono protezioni basate sui caratteri, non conteggi esatti del tokenizer. L'Archivio vettoriale è durevole, ma l'albero di Fibonacci separato è memoria di sessione. Viene costruito per un file quando quel file viene indicizzato durante la sessione di pagina corrente e non viene ricostruito automaticamente da `state/vector_store.json` dopo un ricaricamento; finché non viene ricostruito, il contesto dei file attivi utilizza il fallback piatto. ## Persistenza Il launcher memorizza i dati applicativi durevoli come JSON sotto `state/` utilizzando la sostituzione atomica tramite file temporaneo. Non esiste alcuna migrazione SQLite attiva né dipendenza da database. | Percorso | Contenuti | |---|---| | `state/agents_state.json` | Agenti correnti, inclusi modello, temperatura, limite di token, cicli, formato e handoff di ciascun agente | | `state/agent_sets.json` | Preset di agenti salvati | | `state/agent_run_log.json` | Ultime 100 esecuzioni di agenti: agente, modello, durata, esito e contesto | | `state/pipeline_state.json` | Passaggi di pipeline ritirati, conservati per compatibilità retroattiva | | `state/chain_sets.json` | Preset di catene salvati | | `state/step_run_log.json`, `state/tool_call_log.json`, `state/tool_registry_state.json` | Registrazioni di passaggi, chiamate di strumenti e registro degli strumenti | | `state/chat_history.json` | Ultimi 100 messaggi della conversazione; l'interfaccia riproduce gli ultimi 30 | | `state/scratch.json` | Ultimi 20.000 caratteri dello scratchpad | | `state/memory_profile.json` | Selezione del recupero Fast, Hybrid o Deep | | `state/vector_store.json` | Chunk ed embedding dell'Archivio | | `state/case_intelligence.json` | Metadati del caso, contratti di evidenza e provenienza, memoria esplicita limitata e ricevute di traccia degli agenti; creato alla prima scrittura | | `state/graph_state.json`, `state/timeline_state.json` | Dati di grafo e timeline | | `state/web_cache.json` | Risultati di recupero web diretto con TTL di un'ora | | `state/linked_dir_state.json` | Percorso corrente della directory collegata | | `uploads/manifest.json` | Metadati dei file caricati | Il layout del pannello è memorizzato nel `localStorage` del browser, quindi è specifico del profilo del browser. Le selezioni, le statistiche e l'albero frattale in memoria, validi solo a runtime, si azzerano al caricamento della pagina. Se un file JSON di stato non può essere decodificato, il launcher lo mette in quarantena con il suffisso `.corrupt-<timestamp>.json` e restituisce un valore vuoto in modo che il pannello interessato possa ripristinarsi. ## Accesso Web e Confini di Rete La pillola `WEB` è l'interruttore principale e per impostazione predefinita è su `OFF`. **Con `WEB` disattivato, AMBER non effettua alcuna richiesta in uscita di alcun tipo.** Il controllo è applicato all'interno delle stesse funzioni di recupero, quindi la formulazione del prompt, il contesto dei file iniettato e le chiamate agli strumenti degli agenti (`web_fetch`, `online_records_search`) sono tutti bloccati allo stesso modo. Se un prompt richiede un recupero mentre l'interruttore è disattivato, il terminale lo segnala e la richiesta non viene inviata anziché fallire silenziosamente. Con `WEB` attivo, AMBER controlla prima l'ambiente dell'helper, stampa il percorso dell'helper che utilizzerà e poi risolve la richiesta in questo ordine: 1. Un'istruzione esplicita del sito come "cerca su foxnews.com X" — recupera quel sito, usando un URL di ricerca noto quando l'argomento è specifico. 2. Una richiesta formulata specificamente come "ricerca di registri per/su [persona] in [luogo]" — invoca l'helper dei registri. 3. Un URL esplicito `http://`/`https://` o un dominio nudo riconosciuto nel prompt o nel contesto del file iniettato. 4. Altrimenti, il testo del prompt viene inviato all'endpoint HTML di DuckDuckGo e viene recuperata la pagina dei risultati. Il passo 4 significa che con `WEB` attivo, il testo del prompt può raggiungere un motore di ricerca generico. Disattiva `WEB` per i prompt il cui testo non deve lasciare la macchina. Ogni esito viene riportato nel terminale principale: la modalità selezionata, il percorso dell'helper utilizzato, la richiesta inviata, il motore che l'ha servita (`playwright`, `urllib` o `cache`), la dimensione del contenuto e dove è stato iniettato, oppure un blocco di errore che indica la dipendenza mancante e il comando che la risolve. I recuperi diretti vengono memorizzati nella cache per un'ora in `state/web_cache.json`. La ricerca nei registri interroga queste fonti e restituisce solo le corrispondenze il cui testo della pagina conferma sia il soggetto sia la località richiesta: `casesearch.kscourts.gov`, `doc.ks.gov/offender-search`, `kbi.ks.gov/registeredoffender`, DuckDuckGo e Brave Search. Il comportamento di rete è il seguente: - Scoperta dei modelli, inferenza, embedding e stato dei modelli si connettono solo a un endpoint Ollama in loopback. - Il backend AMBER serve file locali e route API dall'host/porta AMBER configurati. - Con `WEB` attivo, il recupero web tramite Playwright, il suo fallback HTTP Python e la ricerca nei registri effettuano richieste in uscita verso siti selezionati dall'utente, dei provider di ricerca e dei registri pubblici. Con `WEB` disattivato, nessuno di questi viene eseguito. - `GET /api/web/status` è un preflight solo locale; ispeziona il filesystem e il `PATH` e non effettua alcuna richiesta di rete. - Non esiste un endpoint di telemetria AMBER e nessuna funzionalità trasmette credenziali, chiavi o dati di utilizzo. Le pagine recuperate vengono iniettate nel prompt come `[WEB CONTEXT]` e diventano quindi parte della cronologia della conversazione persistita in `state/chat_history.json`; gli agenti il cui target di output è lo scratchpad aggiungono anche a `state/scratch.json`. Il contenuto web in tempo reale finisce nello stato locale del caso. Il launcher invia una Content Security Policy restrittiva, disabilita il framing, imposta `no-referrer`, blocca i permessi sensibili del browser e disabilita la cache HTTP. Il contratto `/api/task/execute` del backend può elencare, leggere, scrivere, aggiungere o creare file all'interno della radice collegata quando viene chiamato esplicitamente. Rifiuta i percorsi che escono da quella radice, i percorsi nascosti, gli strumenti sconosciuti e le sovrascritture non esplicitamente autorizzate. Collega solo una directory i cui contenuti visibili possono essere accessibili e modificati dall'applicazione locale. ## Pannello di Telemetria I contatori di sessione si aggiornano durante l'esecuzione Analyst, Parallel e Agent e includono turni, token di prompt/output, picco della frequenza di token, frequenza media di token e uno sparkline in tempo reale della frequenza di token. La residenza VRAM/modello proviene dall'endpoint locale `/api/ps` di Ollama. Le letture di temperatura/utilizzo sono best-effort: NVIDIA usa `nvidia-smi`, Apple Silicon tenta letture SMC dirette, Linux controlla le zone termiche e strumenti opzionali forniscono fallback. ## Pulizia dei Dati Ferma AMBER prima della pulizia. Reimposta lo stato persistito preservando i file caricati: ```bash rm -f state/*.json ``` Rimuovi i blob caricati, il testo estratto e il relativo manifest: ```bash rm -rf uploads/blobs uploads/texts uploads/manifest.json ``` I file sorgente collegati non vengono mai rimossi da questi comandi. Le directory di stato e di upload vengono ricreate secondo necessità. ## Risoluzione dei problemi ### PING fallisce o non compaiono modelli - Verificare che `ollama serve` sia in esecuzione. - Verificare che l'endpoint dell'interfaccia sia `http://127.0.0.1:11434`. - Eseguire `ollama list` per verificare che sia installato almeno un modello di generazione. ### L'indicizzazione dell'archivio fallisce - Eseguire `ollama pull embeddinggemma:latest`. - Verificare che Ollama sia raggiungibile all'endpoint mostrato nell'interfaccia. - Ispezionare il registro eventi di AMBER per individuare l'endpoint di embedding o il chunk di input che causa l'errore. ### Il recupero web tramite browser o la ricerca nei record fallisce Il terminale indica il problema esatto. Verificare l'ambiente direttamente con AMBER in esecuzione: ```bash curl -s http://127.0.0.1:8765/api/web/status ``` Poi installa tutto ciò che segnala come mancante: ```bash npm install npx playwright install chromium ``` Il recupero diretto dal web può comunque riuscire tramite il suo fallback HTTP semplice. La ricerca dei record richiede Playwright e può fallire quando una fonte cambia il markup, richiede autenticazione/CAPTCHA, blocca l'automazione o non è disponibile. ### Non viene recuperato nulla e il terminale mostra `WEB IS OFF` La pillola `WEB` è su `OFF`, il che blocca per progettazione ogni richiesta in uscita. Impostala su `ON`. ### Un agente non si avvia: `LOCAL MODEL NOT AVAILABLE` Il modello selezionato dall'agente non è installato in Ollama. Il terminale stampa il modello richiesto, i modelli disponibili e la soluzione: ```bash ollama pull <model-name> ollama list ``` AMBER non sostituisce mai silenziosamente un modello diverso. ### `SEND` è disattivato In modalità `ANALYST`, seleziona esattamente un modello nel pannello Models. In modalità `AGENTS`, crea almeno un agente — lì non è necessario alcun modello attivo. ### Il testo del PDF o dell'immagine è mancante - Installa `ocrmypdf` e Tesseract. - Installa Pillow per la conversione WebP se necessario. - Ricarica il file in modo che l'estrazione venga eseguita di nuovo. - Ispeziona il file corrispondente sotto `uploads/texts/`. ### `npm start` non riesce a trovare Python Gli script npm si aspettano `venv/bin/python3`. Esegui `python3 -m venv venv`, oppure avvia direttamente con `python3 files/launch_amber_ici_gui.py`. ### La porta 8765 è già in uso ```bash python3 files/launch_amber_ici_gui.py --port 8877 ``` ## Struttura del progetto ```text AMBER-ICI/ ├── files/ │ ├── amber_graph.html │ ├── amber_timeline.html │ ├── amber_ui.html │ ├── amber_vectorstore.html │ ├── amber_intelligence/ # Standard-library case/evidence/memory service │ ├── autogen_builder.py │ ├── constrained_executor.py │ ├── launch_amber_ici_gui.py │ ├── records_search_playwright.mjs │ └── web_fetch_playwright.mjs ├── image/README/ ├── state/ # created/populated at runtime ├── uploads/ # created/populated at runtime ├── tests/ # Case-intelligence and ICI regression tests ├── package.json ├── spec.json ├── spec.schema.json ├── README.md └── LICENSE ``` ## Licenza MIT. Vedi [LICENSE](https://github.com/gs-ai/amber-ici/blob/main/LICENSE).