Panoramica
SacredTexts AI è un'applicazione web progressiva (PWA) che utilizza l'intelligenza artificiale per analizzare e visualizzare le connessioni tra i testi sacri delle principali tradizioni religiose mondiali.
Analisi AI Avanzata
Utilizza Google Gemini per estrarre temi, concetti e riferimenti incrociati dai testi sacri.
Visualizzazione a Grafo
Rappresentazione interattiva delle connessioni tra concetti con simulazione fisica.
Export
Esporta in JSON-LD e RDF/Turtle per interoperabilità con strumenti di ricerca.
PWA Installabile
Installabile come app nativa su qualsiasi dispositivo, con supporto offline per la cronologia.
Come Iniziare
Configurazione Iniziale
Ottieni una API Key Gemini
Vai su Google AI Studio, accedi con il tuo account Google e crea una nuova API key gratuita.
Configura l'Applicazione
Clicca sull'icona ingranaggio (⚙️) nella barra superiore, incolla la tua API key nel campo dedicato e salva le impostazioni.
Seleziona un Testo
Scegli un testo di esempio dal menu a tendina oppure incolla direttamente un passo da qualsiasi testo sacro nel campo di testo.
Avvia l'Analisi
Clicca il pulsante "Analizza con AI" e attendi che l'intelligenza artificiale elabori il testo. I risultati appariranno nel grafo e nel pannello laterale.
Attiva l'Audio (Opzionale)
Clicca sul pulsante volume nell'header del grafo per attivare la sonificazione generativa. Usa il selettore preset per scegliere tra 5 atmosfere sonore (1, 2, 3, 4, 5).
Suggerimento
Installa l'applicazione come PWA per un'esperienza migliore! Su Chrome, clicca l'icona di installazione nella barra degli indirizzi.
Funzionalità
Interfaccia Principale
L'interfaccia è suddivisa in tre pannelli principali:
- Pannello Input (sinistra): Area per selezionare o inserire il testo sacro da analizzare, con filtri per tradizione e testi di esempio precaricati.
- Grafo delle Connessioni (centro): Visualizzazione interattiva che mostra la struttura gerarchica dei concetti estratti dal testo, con motore audio generativo sincronizzato, selettore preset e interazione audio tramite click, hover e trascinamento dei nodi.
- Analisi Dettagliata (destra): Pannello testuale con identificazione della fonte e dell'autore, temi, contesto storico approfondito, parole chiave, piste di ricerca AI e opzioni di esportazione.
Barra di Navigazione
- Cronologia (🕐): Accedi alle analisi precedenti salvate localmente.
- Guida (📖): Questa documentazione completa.
- Impostazioni (⚙️): Configura API key e opzioni avanzate.
Controlli Grafo
- Replay (▶): Riproduce la costruzione cinematica del grafo, rivisitando ogni nodo in sequenza.
- Zoom (+/-): Ingrandisci o riduci la visualizzazione.
- Reset Vista: Torna alla posizione iniziale.
- AI Confidence (👁): Attiva la modalità X-Ray che mostra l'opacità dei nodi proporzionale alla certezza del modello AI.
- Audio On/Off (🔊): Attiva/disattiva la sonificazione generativa.
- Preset Audio: Seleziona tra 5 preset sonori (1-5). Il preset si auto-seleziona in base alla tradizione rilevata.
Cronologia e Preferiti
Ogni analisi viene automaticamente salvata nella cronologia locale. Puoi:
- Cercare nelle analisi passate per parola chiave
- Marcare le analisi come preferite per ritrovarle facilmente
- Ricaricare un'analisi precedente con un click
- Esportare in vari formati (JSON, JSON-LD, RDF/Turtle)
Grafo delle Connessioni
Il grafo è una rappresentazione visiva interattiva della struttura semantica del testo analizzato. Utilizza un algoritmo a simulazione fisica per posizionare i nodi in modo organico.
Struttura Gerarchica
Il grafo presenta tre livelli di nodi:
- Nodo Centrale (Source): Rappresenta il testo analizzato. È il punto focale da cui si diramano tutti i temi.
- Cluster Tematici: Raggruppamenti di concetti correlati, colorati in base alla categoria (teologia, etica, mistica, pratica).
- Nodi Figli (Children): Concetti specifici estratti dal testo, collegati al loro cluster di appartenenza.
Interazioni
| Azione | Come fare |
|---|---|
| Zoom | Rotella mouse o pulsanti + / - |
| Pan (spostare vista) | Clicca e trascina sullo sfondo |
| Spostare un nodo | Clicca sul nodo e trascina |
| Vedere dettagli nodo | Click rapido sul nodo (senza trascinare) |
| Hover info | Passa sopra un nodo per vedere il tooltip |
| Reset vista | Pulsante reset nella toolbar |
Sidebar Dettagli Nodo
Cliccando su un nodo si apre una sidebar laterale che mostra:
- Nome e Categoria: Badge colorato con la categoria del concetto
- Citazione: Il testo originale associato al nodo
- Nodi Figli: Lista cliccabile dei sotto-concetti collegati
- Cross-References: Collegamenti ad altri testi o tradizioni
- Azioni: Copia citazione, focus sul nodo nel grafo
Codifica Colori
Teologia
Concetti relativi alla natura divina, dottrine e credenze fondamentali.
Etica
Precetti morali, regole di comportamento e giustizia.
Mistica
Esperienze spirituali, contemplazione e unione con il divino.
Pratica
Rituali, preghiere, pratiche quotidiane e osservanze.
Approfondimento
Per una spiegazione dettagliata di come funziona il prompt AI, il pipeline di validazione e i parametri fisici del grafo, consulta la pagina Dietro le Quinte.
Sonificazione Audio
SacredTexts AI include un motore audio generativo (GenerativeAudioEngine)
basato su Tone.js, sincronizzato alla visualizzazione del grafo. I nodi del grafo innescano note
nella scala musicale della tradizione rilevata, con frammenti melodici autentici e layer generativo di sottofondo.
L'audio è disattivato per default e risponde in tempo reale alle interazioni con i nodi.
Come Attivare l'Audio
- Clicca sul pulsante volume (🔊) nell'header del grafo
- Al primo click, il browser chiederà il permesso per l'audio
- Il pulsante diventa dorato quando l'audio è attivo
- Usa il selettore preset per scegliere l'atmosfera sonora desiderata
I 5 Preset Sonori
Ogni preset configura timbro, registro, tempo, riverbero, delay e probabilità multi-nota per creare atmosfere distinte. Il preset si auto-seleziona in base alla tradizione rilevata.
1 (default)
PolySynth con note lunghe e riverbero profondo. Registro medio-basso, tempo lento, drone FM opzionale. Ideale per meditazione e lettura contemplativa.
2
AMSynth con note acute, brillanti e cristalline. Registro alto, filtro aperto, delay prominente. Atmosfera luminosa e ariosa.
3
FMSynth con timbro ricco di armoniche. Registro basso, filtro chiuso, riverbero lungo. Evoca sonorità antiche e rituali.
4
FMSynth caldo con vibrato. Registro medio, drone grave, filtro scuro. Timbro avvolgente e meditativo.
5
PolySynth con note brevi e ritmiche. Tempo veloce, probabilità multi-nota alta, filtro medio. Energia pulsante e dinamica.
7 Scale Musicali per Tradizione
Il GenerativeAudioEngine utilizza scale musicali specifiche per ogni tradizione.
La scala si seleziona automaticamente in base alla tradizione rilevata dall'analisi AI,
e ogni preset applica modificatori specifici (registro, tempo, drone, riverbero, filtro):
| Tradizione | Scala | Note |
|---|---|---|
| ✝️ Cristianesimo | Modo Ionico (gregoriano) | C D E F G A B |
| ✡️ Ebraismo | Ahava Rabbah | C Db E F G Ab B |
| ☪️ Islam | Maqam Hijaz | C Db E F G Ab Bb |
| 🕉 Induismo | Raga Bhairav | C Db E F# G Ab B |
| ☸️ Buddhismo | Pentatonica | C D F G A |
| ☯️ Taoismo | Pentatonica cinese (Gong) | C D E G A |
| 🌐 Default | Minore Naturale | C D Eb F G Ab Bb |
Interazione Nodi ↔ Audio
L'audio è sincronizzato alla visualizzazione del grafo. Ogni interazione con i nodi produce un feedback sonoro differenziato:
- Click su un nodo: Nota accentata nella scala della tradizione corrente, con panning stereo basato sulla posizione orizzontale
- Hover su un nodo: Nota sottile e delicata a volume ridotto
- Trascinamento (drag): Modula in tempo reale filtro, riverbero e delay in base alla posizione del nodo
- Rilascio del nodo: Tutti i parametri tornano gradualmente ai valori base
Layer Generativo di Sottofondo
Oltre alle interazioni dirette, il motore genera un layer musicale continuo che genera frammenti melodici nella scala della tradizione corrente. Il tempo, la probabilità di note multiple e l'intensità variano in base al preset selezionato. Ogni preset può attivare un drone FM opzionale per arricchire il paesaggio sonoro.
Barra Info Audio
Quando l'audio è attivo, una barra informativa mostra in tempo reale il nome della scala, le note utilizzate e il tipo di sintetizzatore attivo, consentendo di seguire la sonificazione in modo consapevole.
Catena Audio
Il segnale segue la catena: PolySynth → Filter → Highpass → FeedbackDelay → Reverb → Panner → Volume → output.
I sintetizzatori utilizzati includono PolySynth, FMSynth e AMSynth di Tone.js.
💡 Suggerimento
Seleziona la tradizione dal menu a tendina prima di cliccare “Analizza con AI”: il sistema selezionerà automaticamente la scala e il preset più adatti. Se il filtro è su “Tutte le tradizioni”, il sistema rileva automaticamente la tradizione dall'analisi Gemini. Prova a cambiare preset durante l'ascolto per esplorare atmosfere diverse sullo stesso testo.
Esportazione Dati
Formati Disponibili
JSON
Formato nativo dell'applicazione. Contiene tutti i dati dell'analisi in formato strutturato.
JSON-LD
JSON for Linked Data. Usa vocabolario Schema.org e Dublin Core per massima interoperabilità.
RDF/Turtle
Formato RDF in sintassi Turtle. Ideale per importazione in triple store e SPARQL endpoints.
Come Esportare
- Esegui un'analisi o carica una dalla cronologia
- Nel pannello "Analisi Dettagliata", clicca il pulsante Esporta
- Seleziona il formato desiderato dal menu dropdown
- Il file verrà scaricato automaticamente
Vocabolario Semantico
I formati JSON-LD e RDF utilizzano i seguenti vocabolari:
- Schema.org: Vocabolario principale per entità e relazioni
- Dublin Core (dcterms): Metadati bibliografici
- SKOS: Concetti e relazioni tematiche
- stai: Namespace custom per proprietà specifiche dell'app
Analisi Dettagliata
Il pannello Analisi Dettagliata presenta i risultati dell'elaborazione AI in formato testuale strutturato. Il motore di analisi supporta due modelli Google Gemini gratuiti selezionabili dall'utente: Gemini 2.5 Flash-Lite (default, veloce ed economico) e 2.5 Flash (più accurato). Il modello si seleziona dalle Impostazioni (≅). Ogni modello ha quota API indipendente.
Sezioni dell'Analisi
- Fonte del Testo: Header dinamico che identifica il testo analizzato, mostrando titolo, autore (quando riconosciuto dall'AI), tradizione religiosa con emoji e sezione/capitolo. Si aggiorna automaticamente ad ogni analisi.
- Temi Principali: I macro-temi identificati nel testo, ciascuno con una breve descrizione e il livello di importanza.
- Contesto Storico-Culturale: Analisi approfondita con 9 campi strutturati: periodo storico, ambiente socio-culturale, autore, destinatari originali, genere letterario, significato nella tradizione, influenze ricevute, impatto culturale e correnti interpretative.
- Parole Chiave: Termini significativi estratti dal testo con il loro significato nel contesto religioso.
- Piste di Ricerca: Domande epistemologiche generate dall'AI basate su tensioni, paradossi e connessioni inter-tradizione trovate nel testo. Cliccabili per copiare o rianalizzare.
⚠️ Nota Importante
L'analisi è generata da un modello AI e potrebbe contenere imprecisioni o interpretazioni non validate accademicamente. È consigliato verificare le informazioni con fonti accademiche per uso di ricerca. L'AI può riflettere bias presenti nei dati di addestramento.
Trasparenza AI
Per vedere il prompt esatto inviato all'AI, i confronti tra modelli e la metodologia di curatela dei testi, visita Dietro le Quinte.
Audio
SacredTexts AI utilizza un motore audio generativo (GenerativeAudioEngine)
implementato in generative-audio.js, basato su Tone.js e sincronizzato alla visualizzazione del grafo.
Preset e Attivazione
- Audio disattivato per default: L'audio non parte automaticamente. Clicca il bottone 🎵 nella toolbar del grafo per attivarlo.
- Selettore preset: Scegli tra 5 preset sonori — 1, 2, 3, 4, 5 — ciascuno con timbro, registro, tempo e riverbero diversi.
- Auto-selezione: Il preset si seleziona automaticamente in base alla tradizione rilevata dall'analisi AI, con modificatori specifici per registro, tempo, drone e filtro.
- Cambio analisi: Se l'audio è attivo e si avvia una nuova analisi, l'audio si interrompe e riparte automaticamente con la scala e il preset della tradizione corretta.
Interazione Nodi-Audio
I nodi del grafo fungono da trigger per la sonificazione. Ogni tipo di interazione produce un feedback sonoro differenziato:
- Click — Nota accentata: Un click su un nodo produce una nota accentata nella scala della tradizione, con panning stereo in base alla posizione orizzontale.
- Hover — Nota sottile: Passando il mouse su un nodo si genera una nota delicata a volume ridotto.
- Drag — Modulazione continua: Trascinando un nodo si modulano in tempo reale filtro, riverbero e delay in base alla posizione.
- Rilascio: Al rilascio del nodo, tutti i parametri tornano gradualmente ai valori base.
Barra Info Audio
Quando l'audio è attivo, una barra informativa mostra la scala musicale corrente, le note e il tipo di sintetizzatore in uso.
💡 Suggerimento
Prova a cambiare preset durante l'ascolto e trascina lentamente un nodo dal centro verso un angolo per esplorare l'intera gamma di modulazione sonora. Ogni preset trasforma radicalmente l'atmosfera.
Tradizioni Supportate
SacredTexts AI include testi di esempio da otto grandi tradizioni religiose mondiali. Puoi comunque analizzare testi da qualsiasi tradizione inserendoli manualmente.
Testi di Esempio Inclusi
- Bibbia e Tradizione Cristiana: Genesi, Salmi, Vangeli (Giovanni, Matteo, Luca), Lettere di Paolo, Apocalisse, Padri della Chiesa (Agostino, Benedetto), Mistici (Francesco, Giovanni della Croce, Teresa d'Avila, Meister Eckhart), Padri del Deserto, Pseudo-Dionigi
- Corano: Sura Al-Fatiha, Versetto della Luce
- Torah/Tradizione Ebraica: Shema Israel, Salmo 137
- Induismo: Gayatri Mantra, Shanti Mantra
- Buddhismo: Dhammapada
- Taoismo: Tao Te Ching
- Sufismo: Rumi (Masnavi)
- Ortodossia: Preghiera di Gesù (Filocalia)
⚠️ Disclaimer
I testi presenti nel database sono forniti a scopo didattico e divulgativo. Le traduzioni italiane sono basate su edizioni accademiche riconosciute: CEI 2008 (Libreria Editrice Vaticana) per i testi biblici, e edizioni critiche di riferimento per le altre tradizioni (Città Nuova, Adelphi, Fondazione Valla, OCD, Rusconi, UTET, ecc.). Ogni testo include i metadati completi con traduttore, editore e anno di pubblicazione. Per uso accademico o di ricerca, si raccomanda comunque di verificare i testi con le edizioni critiche originali (Nestle-Aland, BHS, Sources Chrétiennes, etc.).
Fonti e Verifica
Per informazioni dettagliate sulle fonti di traduzione, le edizioni critiche di riferimento e il processo di curatela assistita da AI, consulta Dietro le Quinte - Selezione e Traduzione dei Testi.
Impostazioni
API Key Google Gemini
L'API key è necessaria per utilizzare l'analisi AI. Per motivi di sicurezza, la chiave viene salvata solo nella sessione corrente del browser e dovrà essere reinserita alla riapertura dell'applicazione.
⚠️ Sicurezza
Non condividere mai la tua API key. Se sospetti che sia stata compromessa, rigenerala immediatamente da Google AI Studio.
Modalità Studio Comparativo
Questa opzione rilassa i filtri di sicurezza dell'AI per permettere l'analisi di testi religiosi che potrebbero altrimenti essere bloccati (es. passi controversi, testi apocrifi, confronti tra tradizioni).
Nota: Questa modalità è destinata esclusivamente allo studio accademico e comparativo delle religioni. L'utente è responsabile dell'uso appropriato.
Aggiornamenti Automatici
L'applicazione controlla automaticamente la disponibilità di nuove versioni. Quando viene rilevato un aggiornamento, apparirà un prompt per ricaricare la pagina e ottenere le ultime funzionalità.
Sviluppi Futuri
SacredTexts AI è in continuo sviluppo. Ecco lo stato delle funzionalità:
Completate nella v2.2.0
Sonificazione dei Dati
Motore audio generativo Tone.js con 5 preset, 7 scale per tradizione, 35 frammenti melodici, sincronizzazione al grafo.
Esportazione JSON-LD/RDF
Export in formati standard del Web Semantico per interoperabilità accademica.
Sidebar Dettagli Nodo
Pannello laterale con informazioni complete, navigazione e azioni sui nodi del grafo.
Sistema Cache Busting
Aggiornamenti automatici con rilevamento nuove versioni e prompt di ricarica.
Completate nella v2.9.16
Pagina "Dietro le Quinte"
Nuova pagina interattiva con 7 sezioni: inventario testi con fonti critiche, anatomia del prompt AI, meccanismo del grafo, confronto tra modelli AI, strumenti e timeline, playground dei prompt, crediti e metodologia.
Metadati Traduzione nei Testi
Aggiunto campo metadati a tutti i 48 testi sacri con fonte traduzione italiana, edizione critica in lingua originale e note accademiche.
Navigazione Integrata
Nuovo bottone "Dietro le Quinte" nella navbar, link nel modal Info e cross-reference nella guida utente.
Piste di Ricerca AI
Generazione automatica di domande epistemologiche basate sull'analisi del testo. Click per copiare, doppio click per rianalizzare.
AI Confidence (X-Ray Mode)
Visualizzazione della certezza del modello AI: opacità proporzionale alla confidence, bordi tratteggiati per valori bassi, badge percentuale colorato.
Gestione Cache e Aggiornamenti
Banner aggiornamento stilizzato, bottoni per controllo aggiornamenti e pulizia cache nelle impostazioni, SKIP_WAITING flow completo.
Header Fonte Dinamico
Identificazione automatica del testo analizzato con titolo, autore, tradizione ed emoji nel pannello risultati.
Audio Generativo con Interazione Nodi
GenerativeAudioEngine con 5 preset (1-5), 35 frammenti melodici autentici, interazione click/hover/drag sincronizzata al grafo.
Selettore Modello AI
Selettore con 2 modelli Gemini gratuiti (2.5 Flash-Lite, 2.5 Flash). Default: Gemini 2.5 Flash-Lite. Ogni modello ha quota API indipendente.
Welcome Splash con Versione e Verifica Aggiornamenti
Schermata di benvenuto all'avvio con indicazione della versione corrente e controllo automatico disponibilità aggiornamenti.
Fix Retry 429 con Backoff Esponenziale
Gestione intelligente degli errori di rate limiting (HTTP 429) con strategia di retry a backoff esponenziale per garantire la stabilità delle chiamate API.
Transizione ad Audio Interamente Generativo
Sostituiti i campioni audio con motore generativo completo: 7 scale musicali per tradizione (Ionian, Ahava Rabbah, Maqam Hijaz, Raga Bhairav, Pentatonica, Chinese Gong, Minore Naturale), 35 frammenti melodici autentici (Dies Irae, Kol Nidre, Adhan, Raga Bhairav pakad, Shomyo, Liu Shui...), auto-selezione preset basata sulla tradizione, drone FM opzionale, barra info audio.
Animazioni Immersive del Grafo
Movimenti dei nodi più lenti e fluidi con fisica ricalibrata (damping 0.92, velocità dimezzata). Transizioni camera 1800ms con easing ease-in-out-quart. Pulsazione dei nodi rallentata per effetto "respiro".
Pianificati
Disclaimer e Validazione AI
Badge "non validato accademicamente" sui risultati e tooltip esplicativo.
Modalità Presentazione Accademica
Layout ottimizzato per proiezione con font ingranditi, controlli semplificati ed export slide.
Confronto Varianti Testuali
Diverse traduzioni dello stesso passo con evidenziazione delle differenze e note filologiche.
Visualizzazione Intertestualità
Connessioni tra testi di tradizioni diverse con grafo multi-tradizione e filtri per tipo di connessione.