Documentazione di Presentia

Presentia si usa soprattutto dalla dashboard: crea una presentazione da un prompt, un documento, un dataset o del markdown; rifiniscila nell’editor (con un assistente IA); esporta in PPTX o PDF. Questa pagina copre le funzionalità proprie del fork e l’API; l’editor di tutti i giorni funziona come ti aspetteresti dal suo upstream.

Da markdown a presentazione (modalità Gamma)

La pagina Markdown ha un editor completo — barra degli strumenti, anteprima live che mostra esattamente come il tuo testo si divide in card, contatore delle card, drag & drop — più selettori di template, lingua, fonte/stile delle immagini ed esportazione. Ogni sezione separata da --- o dai titoli #/## diventa una card.

`text_mode`	Cosa succede
`preserve`	Il tuo testo entra nella presentazione alla lettera — l’IA sceglie solo i layout e genera le immagini.
`condense`	L’IA riassume ogni card mantenendone la struttura.
`generate`	L’IA riscrive ed espande ogni card.

La stessa potenza è disponibile via API:

curl -X POST http://localhost:5001/api/v1/ppt/presentation/generate-from-markdown \
  -H "Content-Type: application/json" \
  -d '{
        "markdown": "# Q3 Review\nIntro...\n\n---\n\n## Results\n- Revenue up 20%",
        "text_mode": "preserve",
        "template": "general",
        "export_as": "pptx"
      }'

Grafici da dati reali

POST /api/v1/ppt/presentation/generate-from-data costruisce una presentazione da un dataset CSV, TSV o JSON (multipart: file, più content, n_slides, language, template, instructions, export_as). La protezione anti-allucinazione controlla ogni cifra dei grafici sul dataset — solo valori esatti o aggregati esatti di colonna (somma, media, minimo, massimo, conteggio). I numeri sbagliati ricevono un nuovo tentativo con feedback e vengono rifiutati se il modello insiste.

curl -X POST http://localhost:5001/api/v1/ppt/presentation/generate-from-data \
  -F "file=@monthly_summary.csv" \
  -F "content=Monthly reconciliation report" \
  -F "n_slides=6" -F "language=English" -F "export_as=pdf"

I dataset sono attesi già aggregati; il tetto di righe è DATASET_MAX_ROWS (predefinito 200). Il template predefinito è Report, che include i layout con grafici.

Costi e modelli

Due pagine della dashboard che l’upstream non ha:

Models — il catalogo dei modelli di testo e immagine con punti di qualità curati, prezzo combinato per milione di token, disponibilità calcolata dalle tue chiavi e badge di raccomandazione. Clicca una card per cambiare; con una chiave OpenRouter quasi tutto si accende in un colpo solo.
Costs — card riassuntive (chiamate, token in entrata/uscita, costo stimato) e dettaglio per presentazione per fase, diapositiva e modello, più una tabella di confronto tra provider. I prezzi vengono da un catalogo versionato nel repository, quindi lo storico dei costi è verificabile.

Integrazione con la Suite Escriba

Presentia funziona standalone — senza nessuna di queste variabili si comporta esattamente come il Presenton originale. Ogni integrazione è opt-in e indipendente; il docker-compose.yml del repository include blocchi di servizio commentati per tutte.

Escriba — parsing dei documenti con OCR. ESCRIBA_ENABLED=true + ESCRIBA_URL delegano la conversione documento → markdown a un servizio Escriba (PDF scansionati, pagine ruotate, immagini, oltre 20 formati). Se Escriba è giù o fallisce su un file, Presentia ripiega automaticamente sui propri parser locali.
Anonimal — anonimizzazione delle PII prima dell’LLM. ANONIMAL_ENABLED=true + ANONIMAL_URL anonimizzano i prompt dell’utente e il testo estratto dai documenti prima che viaggino verso il provider dell’LLM. Fail-closed: se il servizio non risponde, la generazione si ferma con un errore chiaro invece di inviare PII grezze. Il testo originale non lascia mai il tuo host.
Searchgirl — ricerca web privata. WEB_SEARCH_PROVIDER=searchgirl + SEARCHGIRL_BASE_URL ancorano le generazioni attraverso la tua stessa istanza di metaricerca invece di un’API di terze parti (con un token Bearer opzionale).

Template, temi e lingue

Famiglie di template integrate (General, Modern, Standard, Swift, Report con grafici, Institucional in es-AR), template personalizzati generati dal tuo stesso PPTX, un editor di temi completo (colori, font, logo) e style_instructions per template che modellano il tono di scrittura. Tutta l’interfaccia è disponibile in 7 lingue — English, Español, Français, Português, Italiano, 中文, 日本語 — commutabili dalla barra laterale e ricordate per browser.

Sviluppo

docker compose up -d --build development   # hot reload per entrambi i server
cd servers/fastapi && python -m pytest tests/unit   # il fork aggiunge oltre 100 test unitari

Vedi su GitHub