Documentazione

Under the hood

Come funziona ABChat sotto il cofano. Per chi vuole capire, non solo usare.

01 Struttura del brain

Un brain è una cartella di file. Niente database proprietari, niente formati chiusi. File markdown con un header YAML (frontmatter) che li rende cercabili e collegabili.

~/brain/
brain/
├── boot/          # Chi sei, chi è l'utente, cosa puoi fare
├── wiki/          # Database: persone, aziende, progetti
│   ├── people/    # mario-rossi.md, anna-verdi.md ...
│   ├── companies/ # acme-srl.md, studio-bianchi.md ...
│   └── projects/  # nome-progetto/index.md
├── diary/         # Log temporale: cosa è successo quando
│   └── 2026/      # 2026-03-25-call-con-mario.md
├── todo/          # Task aperti
├── inbox/         # Roba in arrivo da processare
├── public/        # File pubblicati (siti, report)
└── storage/       # Cache, db, file temporanei

02 Frontmatter YAML

Ogni file nel brain ha un header YAML. Sembra semplice — ed è il punto. Con meno di 10.000 file (copre il 99% degli utenti), grep + cat sono più veloci di qualsiasi database.

wiki/people/mario-rossi.md
---
type: person
company: rossi-srl
role: CEO
email: mario@rossi-srl.it
tags:
  - cliente
  - verbania
---

Mario Rossi, CEO di Rossi Srl.
Incontrato alla fiera di Milano 2025.
Preferisce comunicare via WhatsApp.

03 Wiki = database relazionale di file

wiki/ funziona come un database relazionale, ma fatto di file leggibili da un umano. Le relazioni sono nei frontmatter: un progetto linka le persone coinvolte, un'azienda linka i suoi dipendenti.

L'AI legge questi file come contesto prima di ogni risposta. Sa chi è il tuo cliente, qual è lo stato del progetto, chi hai sentito l'ultima volta — senza che tu glielo dica.

04 Diary = log temporale

diary/ è il log di tutto ciò che succede: sessioni di lavoro, call, decisioni, email inviate. Ogni file ha una data e dei tag che lo collegano ai progetti e alle persone coinvolte.

"Cosa abbiamo detto a Mario sulla deadline?" → l'AI cerca nel diary, trova la call del 15 marzo, e ti dà la risposta con il contesto. Zero ricerca manuale.

05 Skill: l'AI che fa cose

Le skill sono comandi installabili nel brain. Non prompt — codice che l'AI esegue. Mandare email, creare fatture, pubblicare su social, fare deploy: azioni reali nel mondo reale.

📧

Email

Legge, compone, invia email. Con il tuo tono, non quello di un robot.

📊

Report

Genera report HTML pubblicabili con un link condivisibile.

💰

Fatture

Crea fatture su FatturaInCloud, consulta scadenze e pagamenti.

📱

Messaggistica

Telegram, WhatsApp, Discord — rispondi da ovunque.

🌐

Deploy

Pubblica siti, gestisci server, monitora uptime.

📅

Calendario

Legge e crea eventi su Google Calendar.

06 Infrastruttura

Container Docker isolati

Ogni utente gira nel suo container Docker. Il tuo brain, i tuoi file, i tuoi processi sono completamente separati da quelli degli altri utenti. Nessuna contaminazione possibile.

Terminale nel browser (WebSSH)

Accesso diretto al tuo brain via terminale nel browser. Parli con l'AI in un'interfaccia da riga di comando — potente per chi sa cosa sta facendo, con autocomplete e history.

Chat semplificata (dChat)

Per chi preferisce un'interfaccia più familiare: chat in stile WhatsApp con tutte le funzionalità del brain dietro. Scrivi in linguaggio naturale, l'AI fa il resto.

Server europeo

Infrastruttura Hetzner in Germania. I tuoi dati non escono dall'Europa. Backup giornalieri, monitoraggio 24/7.

07 Link utili