File size: 14,030 Bytes
df9b878
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
75f4cb1
df9b878
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
"""
📊 Generatore di Tabelle Comparative con RAG
Sistema per creare tabelle comparative da materiali didattici

Utilizza RAG (Retrieval-Augmented Generation) per generare tabelle
basate su documenti caricati dagli utenti.

Autore: Sistema IA per la Didattica Inclusiva
"""

import os
import gradio as gr
from langchain_openai import ChatOpenAI, OpenAIEmbeddings
from langchain.text_splitter import RecursiveCharacterTextSplitter
from langchain_community.vectorstores import FAISS
from langchain.chains import RetrievalQA
from langchain.prompts import PromptTemplate
from langchain.schema import Document

# ========================================
# CONFIGURAZIONE
# ========================================

if "OPENAI_API_KEY" not in os.environ:
    raise ValueError(
        "⚠️ OPENAI_API_KEY non trovata! "
        "Imposta la variabile d'ambiente nel tuo Hugging Face Space."
    )

# ========================================
# TESTO DI ESEMPIO
# ========================================

ESEMPIO_TESTO = """LE RIVOLUZIONI INDUSTRIALI: UN CONFRONTO STORICO

PRIMA RIVOLUZIONE INDUSTRIALE (1760-1840)
La Prima Rivoluzione Industriale ebbe inizio in Gran Bretagna. Fu caratterizzata dall'introduzione della macchina a vapore di James Watt (1769).
Settori: industria tessile, siderurgia, trasporti.
Energia: carbone per macchine a vapore.
Impatto sociale: urbanizzazione, nascita classe operaia, condizioni di lavoro difficili (12-16 ore), lavoro minorile.
Luoghi: fabbriche sostituiscono lavoro artigianale.

SECONDA RIVOLUZIONE INDUSTRIALE (1870-1914)
Si sviluppò in Germania, Stati Uniti e Francia. Caratterizzata da elettricità e petrolio.
Settori: industria chimica, elettrica, automobilistica, siderurgica avanzata.
Innovazioni: telefono (Bell, 1876), lampadina (Edison, 1879), automobile (Benz, 1885), aeroplano (Wright, 1903).
Energia: elettricità e petrolio.
Impatto sociale: crescita classe media, miglioramento condizioni lavoro, sindacati, società di massa.
Organizzazione: taylorismo e fordismo, catena di montaggio.

TERZA RIVOLUZIONE INDUSTRIALE (1970-2010)
Rivoluzione Digitale, iniziata anni '70 con elettronica e informatica.
Settori: informatica, telecomunicazioni, biotecnologie, energie rinnovabili.
Tecnologie: microprocessore (1971), personal computer (anni '80), internet (1991), smartphone (2007).
Energia: elettricità, nucleare, rinnovabili (solare, eolico).
Impatto sociale: globalizzazione, società dell'informazione, smart working, digital divide, social media.
Organizzazione: automazione, outsourcing, lavoro a distanza.

QUARTA RIVOLUZIONE INDUSTRIALE (2010-oggi)
Industria 4.0, fusione di tecnologie digitali, fisiche e biologiche.
Settori: intelligenza artificiale, robotica avanzata, IoT, stampa 3D, blockchain.
Tecnologie: big data, cloud computing, realtà aumentata, quantum computing.
Energia: rinnovabili (solare, eolico, idrogeno), transizione ecologica.
Impatto sociale: automazione lavoro, riqualificazione continua, etica IA, economia circolare, telemedicina.
Organizzazione: smart factory, produzione personalizzata, gig economy.
"""

# ========================================
# CLASSE RAG
# ========================================

class ComparativeTableRAG:
    """Sistema RAG per generare tabelle comparative da documenti."""
    
    def __init__(self, model_name="gpt-4.1-mini", temperature=0.3):
        self.llm = ChatOpenAI(
            model=model_name,
            temperature=temperature,
            max_tokens=2000
        )
        
        self.embeddings = OpenAIEmbeddings()
        
        self.text_splitter = RecursiveCharacterTextSplitter(
            chunk_size=1000,
            chunk_overlap=200,
            length_function=len
        )
        
        self.vectorstore = None
        
        self.table_prompt = PromptTemplate(
            input_variables=["context", "question"],
            template="""Sei un assistente educativo che aiuta gli studenti a creare tabelle comparative.

Basandoti ESCLUSIVAMENTE sulle informazioni fornite nel contesto, crea una tabella comparativa dettagliata.

CONTESTO:
{context}

RICHIESTA:
{question}

ISTRUZIONI:
1. Analizza attentamente il contesto fornito
2. Identifica gli elementi da confrontare
3. Crea una tabella in formato Markdown con colonne appropriate
4. Usa SOLO informazioni presenti nel contesto
5. Se un'informazione non è presente, scrivi "Non specificato nel testo"
6. Mantieni un linguaggio chiaro e adatto agli studenti

FORMATO RISPOSTA:
Rispondi con una tabella in formato Markdown seguita da una breve spiegazione.

TABELLA COMPARATIVA:
"""
        )
    
    def load_text(self, text: str) -> str:
        """Carica un testo e crea il vector store."""
        try:
            documents = [Document(page_content=text)]
            chunks = self.text_splitter.split_documents(documents)
            self.vectorstore = FAISS.from_documents(chunks, self.embeddings)
            return f"✅ Testo caricato con successo! ({len(chunks)} sezioni create)"
        except Exception as e:
            return f"❌ Errore: {str(e)}"
    
    def generate_table(self, query: str, k: int = 5) -> str:
        """Genera una tabella comparativa basata sulla query."""
        if self.vectorstore is None:
            return "⚠️ Errore: Nessun documento caricato. Carica prima un testo."
        
        try:
            retriever = self.vectorstore.as_retriever(search_kwargs={"k": k})
            
            qa_chain = RetrievalQA.from_chain_type(
                llm=self.llm,
                chain_type="stuff",
                retriever=retriever,
                chain_type_kwargs={"prompt": self.table_prompt}
            )
            
            result = qa_chain.invoke({"query": query})
            return result["result"]
        except Exception as e:
            return f"❌ Errore durante la generazione: {str(e)}"
    
    def reset(self):
        """Resetta il vector store."""
        self.vectorstore = None
        return "🔄 Sistema resettato. Carica un nuovo testo."

# ========================================
# INIZIALIZZAZIONE
# ========================================

rag_system = ComparativeTableRAG()

# ========================================
# FUNZIONI GRADIO
# ========================================

def process_text_input(text):
    """Carica un testo inserito dall'utente."""
    if not text or not text.strip():
        return "⚠️ Per favore, inserisci un testo."
    
    return rag_system.load_text(text)

def process_file_input(file):
    """Carica un file caricato dall'utente."""
    if file is None:
        return "⚠️ Per favore, carica un file."
    
    try:
        with open(file.name, 'r', encoding='utf-8') as f:
            text = f.read()
        return rag_system.load_text(text)
    except Exception as e:
        return f"❌ Errore: {str(e)}"

def generate_comparative_table(query):
    """Genera una tabella comparativa."""
    if not query or not query.strip():
        return "⚠️ Per favore, inserisci una richiesta."
    
    if rag_system.vectorstore is None:
        return "⚠️ Carica prima un testo nella sezione 'Caricamento Materiali'."
    
    return rag_system.generate_table(query)

def reset_system():
    """Resetta il sistema."""
    return rag_system.reset()

def load_example():
    """Carica il testo di esempio."""
    result = rag_system.load_text(ESEMPIO_TESTO)
    return result + "\n\n📖 Esempio: Rivoluzioni Industriali"

# ========================================
# INTERFACCIA GRADIO
# ========================================

with gr.Blocks(title="📊 Tabelle Comparative con RAG") as demo:
    
    gr.Markdown(
        """
        # 📊 Generatore di Tabelle Comparative con RAG
        
        Questo strumento utilizza l'intelligenza artificiale per creare tabelle comparative
        basate sui materiali didattici che carichi.
        
        ### 🚀 Come funziona:
        1. **Carica** un testo o file con i materiali da studiare
        2. **Richiedi** una tabella comparativa specifica
        3. **Verifica** le informazioni con le tue fonti
        """
    )
    
    with gr.Tab("📤 Caricamento Materiali"):
        gr.Markdown(
            """
            ### Carica i tuoi materiali didattici
            
            Puoi caricare:
            - Testo copiato da appunti, libri, articoli
            - File di testo (.txt)
            - Oppure usare l'esempio precaricato sulle Rivoluzioni Industriali
            """
        )
        
        with gr.Row():
            with gr.Column():
                text_input = gr.Textbox(
                    label="📝 Incolla il tuo testo",
                    placeholder="Incolla qui il testo dei tuoi appunti o materiali didattici...",
                    lines=10
                )
                text_btn = gr.Button("📤 Carica Testo", variant="primary")
            
            with gr.Column():
                file_input = gr.File(
                    label="📁 Oppure carica un file",
                    file_types=[".txt"]
                )
                file_btn = gr.Button("📤 Carica File", variant="primary")
        
        example_btn = gr.Button("📖 Usa Esempio: Rivoluzioni Industriali", variant="secondary")
        
        upload_output = gr.Textbox(
            label="📊 Stato Caricamento",
            lines=3
        )
    
    with gr.Tab("📊 Generazione Tabelle"):
        gr.Markdown(
            """
            ### Richiedi una tabella comparativa
            
            Descrivi che tipo di confronto vuoi vedere.
            
            **Esempi di richieste:**
            - "Confronta le 4 rivoluzioni industriali per periodo, tecnologie e impatto sociale"
            - "Crea una tabella che mostri l'evoluzione delle fonti di energia"
            - "Confronta le condizioni di lavoro nelle diverse rivoluzioni"
            """
        )
        
        query_input = gr.Textbox(
            label="✍️ La tua richiesta",
            placeholder="Es: Confronta le 4 rivoluzioni industriali in base a periodo, tecnologie e impatto sociale",
            lines=3
        )
        
        generate_btn = gr.Button("🎯 Genera Tabella", variant="primary")
        
        table_output = gr.Markdown(label="📊 Tabella Generata")
        
        gr.Examples(
            examples=[
                "Crea una tabella che confronti le 4 rivoluzioni industriali per periodo storico, principali settori e fonti di energia",
                "Crea una tabella che mostri l'impatto sociale di ogni rivoluzione industriale",
                "Confronta le innovazioni tecnologiche chiave delle 4 rivoluzioni",
                "Mostra l'evoluzione dell'organizzazione del lavoro attraverso le rivoluzioni"
            ],
            inputs=query_input
        )
    
    with gr.Tab("ℹ️ Informazioni"):
        gr.Markdown(
            """
            ## 📚 Cos'è RAG?
            
            **RAG (Retrieval-Augmented Generation)** è una tecnica avanzata che permette all'IA di:
            
            1. **Cercare** informazioni rilevanti nei tuoi documenti
            2. **Comprendere** il contesto specifico
            3. **Generare** risposte basate SOLO sui tuoi materiali
            
            ### 🎯 Vantaggi per lo Studio:
            
            - ✅ Risposte basate sui TUOI materiali didattici
            - ✅ Sintesi e organizzazione automatica delle informazioni
            - ✅ Confronti strutturati tra concetti
            - ✅ Risparmio di tempo nella creazione di schemi
            
            ### ⚠️ Importante:
            
            - L'IA può fare errori o omettere informazioni
            - Verifica sempre le tabelle con i materiali originali
            - Usa questo strumento come supporto, non come sostituto dello studio
            - Discuti i risultati con i tuoi insegnanti
            
            ### 💡 Suggerimenti:
            
            - Carica testi completi e dettagliati per risultati migliori
            - Sii specifico nelle richieste (indica cosa vuoi confrontare)
            - Usa le tabelle come punto di partenza per approfondimenti
            - Integra con altri metodi di studio (mappe mentali, riassunti)
            
            ---
            
            ### 📖 Per gli Insegnanti:
            
            Questo strumento può essere utilizzato per:
            - **Sintesi**: Aiutare gli studenti a organizzare informazioni complesse
            - **Confronto**: Creare tabelle comparative su argomenti studiati
            - **Verifica**: Attività di fact-checking delle tabelle generate
            - **Discussione**: Analizzare cosa l'IA ha incluso/omesso
            
            **Attività suggerite:**
            1. Gli studenti caricano materiali e generano tabelle
            2. Verificano le informazioni con i testi originali
            3. Discutono in classe accuratezza e completezza
            4. Migliorano manualmente le tabelle
            
            ---
            
            <center>
            <small>
            Creato con ❤️ per la didattica inclusiva | Powered by LangChain & GPT-4.1-mini
            </small>
            </center>
            """
        )
    
    # Pulsante reset
    with gr.Row():
        reset_btn = gr.Button("🔄 Reset Sistema", variant="stop")
    
    # Eventi
    text_btn.click(process_text_input, inputs=[text_input], outputs=[upload_output])
    file_btn.click(process_file_input, inputs=[file_input], outputs=[upload_output])
    example_btn.click(load_example, outputs=[upload_output])
    generate_btn.click(generate_comparative_table, inputs=[query_input], outputs=[table_output])
    reset_btn.click(reset_system, outputs=[upload_output])

# ========================================
# AVVIO APPLICAZIONE
# ========================================

if __name__ == "__main__":
    demo.launch(
        server_name="0.0.0.0",
        server_port=7860,
        share=False
    )