Aiuto e documentazione

Tutto,
indicizzato.

Trova il documento giusto per la tua domanda — raggruppato per quello che stai facendo, non per come si chiama il sistema. I rimandi puntano ai documenti più profondi che già esistono (riferimento API, catalogo funzionalità, pagine di settore, risoluzione dei problemi), non a duplicati.

Installazione e primo avvio

Mettere in piedi la piattaforma.

Iniziare

Installa in cinque minuti — server Linux, workstation macOS o cluster multi-nodo. Tre percorsi di piattaforma coperti.

Primo avvio

Da `dnf install` completo al cluster funzionante — registrazione admin, licenza, prima KB, prima chat.

Installazione edge

Installazione single-node su Raspberry Pi, Intel NUC o NVIDIA Jetson. Funzionamento offline con store-and-forward verso un cluster centrale.

Risoluzione problemi di installazione (EN)

Nove modalità di fallimento comuni (GPG fail, conflitti di porta, conflitti admin, Gatekeeper, firma licenza) con soluzioni.

Operazioni del cluster

Gestire la piattaforma giorno per giorno.

Aggiornamenti rolling (§70)

Aggiornamenti RPM su tutto il cluster orchestrati dal controller. Drain → installazione → riavvio per nodo. Riferimento: api-reference.md §19 (EN).

Backup e DR (§40)

Snapshot locali dello stato del cluster — controller, vettori, memoria, configurazioni. Verifica + ripristino per snapshot. Riferimento: api-reference.md §18 (EN).

PKI e ACME (§39)

CA interna più emissione e rinnovo Let's Encrypt tramite certbot. Generazione, deploy, rotazione. Push cluster-wide dal master. Riferimento: features §13.4 (EN).

Migrazione 4.x → 5.0 (§85)

Percorre un'alberatura dati 4.x (vettori / memoria / agente / comm / scienza) e la rigioca sulla superficie syscall di 5.0.

Replica (§29)

Replica rsync-over-SSH reale fra data worker. Archivio vettoriale, memoria a matrice, tenant di file storage. Autenticazione con chiave SSH.

Webhook (§75)

Publisher di eventi in uscita con firma HMAC-SHA256. Le consegne fallite si autodisattivano oltre soglia. Riferimento: per gli sviluppatori (EN).

Export OTLP (§90)

Exporter OpenTelemetry — span, contatori, istogrammi. Disattivato per impostazione predefinita; opt-in admin. Normalizzazione path a bassa cardinalità integrata.

Registro di audit

Log a catena hash di ogni decisione assistita dall'IA. Documentazione difendibile per le revisioni di conformità. Riferimento: features §13.5 (EN).

Dashboard del cluster

Il controller serve le dashboard di panoramica, gestione swarm, operazioni cluster e knowledge browser. Accesso su /dashboard.

Chat shell

Usare la chat.

Provider di modelli (EN)

Ogni modello nel selettore mostra un piccolo badge colorato che identifica il backend che lo serve — Ollama, OpenAI, Eldric Inferenced, vLLM, llama.cpp e gli altri. Verde per i locali al cluster, colori del brand per gli esterni. Lo stesso badge appare su ogni messaggio dell'assistente.

Mostra dettagli query strumento

Impostazioni chat → Inferenza → attiva Mostra dettagli query strumento. Quando è attivo, ogni chiamata a uno strumento mostra un riepilogo a una riga di ciò che è stato interrogato (base di conoscenza, fonte scientifica, ricerca web, ecc.) sopra il risultato. Attivo per impostazione predefinita; disattiva per una trascrizione più densa.

Inferenza con memoria intelligente (EN)

Opt-in per richiesta tramite smart_memory: true o per tenant via toggle admin. Il modello consulta la tua memoria associativa al confine del prompt; le risposte restano ancorate ai tuoi dati senza una chiamata di retrieval separata.

I temi seguono l'utente

Le impostazioni del tema per utente si sincronizzano fra tutti i client (GUI Mac, iOS, iPad, web) tramite il controller. Le impostazioni seguono l'utente, non il dispositivo.

Notifiche

Le attività lunghe degli agenti compaiono come notifiche in-app con progresso e ritorno con un tocco. Apple Push instrada agli avvisi su schermata bloccata di iOS e iPad.

Eldric su iPad (EN)

Compositore fluttuante, Apple Pencil + Scribble, ingest drag-and-drop da File / Foto / Mail, multi-finestra via Stage Manager. TestFlight oggi; App Store prossimamente.

Sviluppo

Costruire su Eldric.

Per gli sviluppatori — panoramica (EN)

API compatibile con OpenAI, creazione di plugin, webhook, agenti — sostituto drop-in per il tooling OpenAI.

api-endpoints (EN)

Superficie di endpoint completa — Edge, Controller, Router, Data, Agent, Media, Comm, Science, Training, IoT, Swarm, NOVA, xLSTM, operazioni del cluster.

api-public (EN)

Solo gli endpoint raggiungibili dall'Edge — una riga per endpoint. Il punto di partenza per le integrazioni esterne.

Creazione di plugin (§80)

Cinque tipi di plugin: Tool, Filter, Pipe, Action, Widget. Python o JS. Manifest + valves + codice principale. Marketplace su /api/v1/marketplace/catalog.

Agent Builder + Generator

Agent Builder usa il ragionamento LLM per progettare agenti nuovi; Agent Generator usa template di dominio per una produzione deterministica di massa. Entrambi scrivono in agents/<nome>/.

Subscriber di webhook

Iscriviti su /api/v1/webhooks/subscriptions. Firma HMAC-SHA256 su ogni POST in uscita. Autodisattivazione su consegne fallite.

Lavorare con i dati

RAG, training, conoscenza.

Usare RAG (EN)

Il come fare lato cliente — carica documenti, poni domande ancorate, leggi le citazioni, gestisci le basi di conoscenza. RAG è attivo per impostazione predefinita in 5.0.

Architettura RAG (EN)

Sotto il cofano — Controller → Inferenced (embeddings via GGUF) → Data Worker (archivio vettoriale). Configurabile tramite ELDRIC_EMBED_BACKEND_URL.

Strategie di chunking (EN)

Chunking contestuale con upload intelligente — predefiniti diversi per tipo di contenuto (PDF, codice, CSV, audio, video, sensori). Suggerimento → anteprima → conferma.

RAG on demand (EN)

La cascata a quattro livelli (ENRN → EMM → RAG → live) e il loop di ritenzione (cerca → accetta → ingerisci → arricchisci → sogna → addestra). Più intelligente con l'uso.

Classificazione personalizzata (EN)

Insegna al router le tue classi di intent. Percorso A classificatore overlay (con esempi etichettati); percorso B fallback LLM (con la tua tassonomia). Pro+.

Memoria a matrice (mLSTM)

Memoria associativa gerarchica — dominio → progetto → run. Aggiornamenti via prodotto esterno + recall matrice-vettore. Formato .emm v3 portabile. Riferimento: api-reference.md §7 (EN).

Pipeline di training

Sei backend (Unsloth, Axolotl, TRL, DeepSpeed, MLX, llama.cpp), otto metodi (LoRA, QLoRA, SFT, DPO, RLHF, PPO, fine-tune completo, distillazione). Riferimento: api-reference.md §13 (EN).

Distillazione (§50)

Distillazione di conoscenza modello → EMM. Fonte vettoriale → coppie Q&A da LLM → associazioni in memoria a matrice. Esecuzione sincrona via /api/v1/distill/run.

Apprendimento federato (§44)

Orchestrazione a round — il controller fa broadcast ai partecipanti, i worker addestrano localmente, gli shard aggregano. Riferimento: features §9.5 (EN).

Per tipo di worker

Andare in profondità su un componente specifico.

Edge gateway

Terminazione TLS, autenticazione, rate limit, webchat integrata, host plugin. Porta 443/80. Riferimento: api-reference.md §1-3 (EN).

Controller

Orchestrazione del cluster, licenze, push topologia, operazioni del cluster. Porta 8880. Riferimento: api-reference.md §18-19 (EN).

Router

Routing intelligente delle richieste — otto strategie di bilanciamento, classificazione di intent, rilevamento di tema, decisioni assistite da IA. Porta 8881.

Worker (inferenza)

Più backend: Ollama, vLLM, TGI, Triton, OpenAI-compatibile, llama.cpp. Porta 8890.

Cloud Worker

Gateway cloud multi-backend — Ollama Cloud, OpenAI, Anthropic, xAI, Groq, DeepSpeed, altri. Porta 8889.

Data Worker

File storage, NFS, database, vettori/RAG, memoria a matrice. Multi-tenant con quote. Porta 8892.

Agent Worker

RAG agentico, orchestrazione multi-agente, decomposizione di query, generazione di dati di training. Porta 8893.

Media Worker

STT (Whisper, OpenAI), TTS (Piper, ElevenLabs, OpenAI), analisi audio, elaborazione video, chat vocale. Porta 8894.

Worker di comunicazione

Email, SMS, WhatsApp, Signal, Teams, XMPP, VoIP. Risposta automatica con IA. Porta 8895.

Worker scientifico

Source Registry (§43) — 16 categorie, 28 fonti integrate. Bioinformatica, farma, CRISPR, LIMS. Porta 8897.

Worker di training

Sei backend, otto metodi, catene di training, ragionamento latente. Inventario GPU + multi-GPU. Porta 8898.

Worker di inferenza (nativo)

Caricamento diretto GGUF / xLSTM senza Ollama / vLLM. Decoding speculativo, batching continuo, pipeline parallelism. Porta 8883.

Worker IoT

IoT consumer (Netatmo, HomeKit, Matter) + protocolli industriali (OPC-UA, Modbus, MQTT Sparkplug B). Porta 8891.

Swarm

Orchestrazione multi-agente con sei tipi di topologia (gerarchica, P2P, ad anello, a stella, a maglia, ibrida). Porte 8885-8887.

NOVA (sperimentale)

Sistema di obiettivi, tri-memoria, ragionamento, meta-learner, auto-modifica in sandbox. Porta 8899. Disattivato per impostazione predefinita.

Conformità e sicurezza

Cosa supportiamo esplicitamente.

Isolamento multi-tenant

Confine per tenant su storage, KB, agenti, progetti. Accesso fra tenant negato al gateway. Tenant guard documentato in features §16.1 (EN).

RBAC

Quattro ruoli — Viewer, Developer, Admin, SuperAdmin. Superficie API con gating per capacità. Assegnazione per tenant.

Registro di audit

Log a catena hash di ogni decisione assistita dall'IA. Documentazione difendibile per revisioni HIPAA / GDPR / 21 CFR Part 11.

Modalità di conformità

Flag di conformità GLP e FDA 21 CFR Part 11 sul worker scientifico. Tracciatura di audit conforme ai requisiti IRB.

Deployment air-gap

Stack on-premises completo senza dipendenze esterne. I worker cloud e l'apprendimento federato sono facoltativi.

Licenze

File di licenza firmati con Ed25519. Tier Free, Standard, Professional, Enterprise. Vincolo hardware facoltativo. E-mail licenze: license@core.at.

Per settore

Sedici pagine di settore.

Pattern di carico, supporto alla conformità e forma di deployment per ogni settore. Ogni pagina ha una griglia di carichi, una riga di conformità e una dichiarazione di ambito onesta.

Salute e scienze della vita: sanità (EN), farma (EN), genomica (EN), CRISPR (EN), neuroscienze (EN)
Finanza e legale: banche (EN), assicurazioni (EN), trading (EN), legale (EN)
Industria e mobilità: manifattura intelligente (EN), automotive (EN), robotica (EN), logistica (EN)
Scienza e ricerca: spazio (EN), clima (EN), materiali (EN)
Risoluzione dei problemi e supporto

Quando qualcosa va storto.

Cataloghi di riferimento

I due grandi documenti.