borgo9 commited on
Commit
df9b878
ยท
verified ยท
1 Parent(s): f8d8dd6

Upload app_rag.py

Browse files
Files changed (1) hide show
  1. app_rag.py +369 -0
app_rag.py ADDED
@@ -0,0 +1,369 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ ๐Ÿ“Š Generatore di Tabelle Comparative con RAG
3
+ Sistema per creare tabelle comparative da materiali didattici
4
+
5
+ Utilizza RAG (Retrieval-Augmented Generation) per generare tabelle
6
+ basate su documenti caricati dagli utenti.
7
+
8
+ Autore: Sistema IA per la Didattica Inclusiva
9
+ """
10
+
11
+ import os
12
+ import gradio as gr
13
+ from langchain_openai import ChatOpenAI, OpenAIEmbeddings
14
+ from langchain.text_splitter import RecursiveCharacterTextSplitter
15
+ from langchain_community.vectorstores import FAISS
16
+ from langchain.chains import RetrievalQA
17
+ from langchain.prompts import PromptTemplate
18
+ from langchain.schema import Document
19
+
20
+ # ========================================
21
+ # CONFIGURAZIONE
22
+ # ========================================
23
+
24
+ if "OPENAI_API_KEY" not in os.environ:
25
+ raise ValueError(
26
+ "โš ๏ธ OPENAI_API_KEY non trovata! "
27
+ "Imposta la variabile d'ambiente nel tuo Hugging Face Space."
28
+ )
29
+
30
+ # ========================================
31
+ # TESTO DI ESEMPIO
32
+ # ========================================
33
+
34
+ ESEMPIO_TESTO = """LE RIVOLUZIONI INDUSTRIALI: UN CONFRONTO STORICO
35
+
36
+ PRIMA RIVOLUZIONE INDUSTRIALE (1760-1840)
37
+ La Prima Rivoluzione Industriale ebbe inizio in Gran Bretagna. Fu caratterizzata dall'introduzione della macchina a vapore di James Watt (1769).
38
+ Settori: industria tessile, siderurgia, trasporti.
39
+ Energia: carbone per macchine a vapore.
40
+ Impatto sociale: urbanizzazione, nascita classe operaia, condizioni di lavoro difficili (12-16 ore), lavoro minorile.
41
+ Luoghi: fabbriche sostituiscono lavoro artigianale.
42
+
43
+ SECONDA RIVOLUZIONE INDUSTRIALE (1870-1914)
44
+ Si sviluppรฒ in Germania, Stati Uniti e Francia. Caratterizzata da elettricitร  e petrolio.
45
+ Settori: industria chimica, elettrica, automobilistica, siderurgica avanzata.
46
+ Innovazioni: telefono (Bell, 1876), lampadina (Edison, 1879), automobile (Benz, 1885), aeroplano (Wright, 1903).
47
+ Energia: elettricitร  e petrolio.
48
+ Impatto sociale: crescita classe media, miglioramento condizioni lavoro, sindacati, societร  di massa.
49
+ Organizzazione: taylorismo e fordismo, catena di montaggio.
50
+
51
+ TERZA RIVOLUZIONE INDUSTRIALE (1970-2010)
52
+ Rivoluzione Digitale, iniziata anni '70 con elettronica e informatica.
53
+ Settori: informatica, telecomunicazioni, biotecnologie, energie rinnovabili.
54
+ Tecnologie: microprocessore (1971), personal computer (anni '80), internet (1991), smartphone (2007).
55
+ Energia: elettricitร , nucleare, rinnovabili (solare, eolico).
56
+ Impatto sociale: globalizzazione, societร  dell'informazione, smart working, digital divide, social media.
57
+ Organizzazione: automazione, outsourcing, lavoro a distanza.
58
+
59
+ QUARTA RIVOLUZIONE INDUSTRIALE (2010-oggi)
60
+ Industria 4.0, fusione di tecnologie digitali, fisiche e biologiche.
61
+ Settori: intelligenza artificiale, robotica avanzata, IoT, stampa 3D, blockchain.
62
+ Tecnologie: big data, cloud computing, realtร  aumentata, quantum computing.
63
+ Energia: rinnovabili (solare, eolico, idrogeno), transizione ecologica.
64
+ Impatto sociale: automazione lavoro, riqualificazione continua, etica IA, economia circolare, telemedicina.
65
+ Organizzazione: smart factory, produzione personalizzata, gig economy.
66
+ """
67
+
68
+ # ========================================
69
+ # CLASSE RAG
70
+ # ========================================
71
+
72
+ class ComparativeTableRAG:
73
+ """Sistema RAG per generare tabelle comparative da documenti."""
74
+
75
+ def __init__(self, model_name="gpt-4.1-mini", temperature=0.3):
76
+ self.llm = ChatOpenAI(
77
+ model=model_name,
78
+ temperature=temperature,
79
+ max_tokens=2000
80
+ )
81
+
82
+ self.embeddings = OpenAIEmbeddings()
83
+
84
+ self.text_splitter = RecursiveCharacterTextSplitter(
85
+ chunk_size=1000,
86
+ chunk_overlap=200,
87
+ length_function=len
88
+ )
89
+
90
+ self.vectorstore = None
91
+
92
+ self.table_prompt = PromptTemplate(
93
+ input_variables=["context", "question"],
94
+ template="""Sei un assistente educativo che aiuta gli studenti a creare tabelle comparative.
95
+
96
+ Basandoti ESCLUSIVAMENTE sulle informazioni fornite nel contesto, crea una tabella comparativa dettagliata.
97
+
98
+ CONTESTO:
99
+ {context}
100
+
101
+ RICHIESTA:
102
+ {question}
103
+
104
+ ISTRUZIONI:
105
+ 1. Analizza attentamente il contesto fornito
106
+ 2. Identifica gli elementi da confrontare
107
+ 3. Crea una tabella in formato Markdown con colonne appropriate
108
+ 4. Usa SOLO informazioni presenti nel contesto
109
+ 5. Se un'informazione non รจ presente, scrivi "Non specificato nel testo"
110
+ 6. Mantieni un linguaggio chiaro e adatto agli studenti
111
+
112
+ FORMATO RISPOSTA:
113
+ Rispondi con una tabella in formato Markdown seguita da una breve spiegazione.
114
+
115
+ TABELLA COMPARATIVA:
116
+ """
117
+ )
118
+
119
+ def load_text(self, text: str) -> str:
120
+ """Carica un testo e crea il vector store."""
121
+ try:
122
+ documents = [Document(page_content=text)]
123
+ chunks = self.text_splitter.split_documents(documents)
124
+ self.vectorstore = FAISS.from_documents(chunks, self.embeddings)
125
+ return f"โœ… Testo caricato con successo! ({len(chunks)} sezioni create)"
126
+ except Exception as e:
127
+ return f"โŒ Errore: {str(e)}"
128
+
129
+ def generate_table(self, query: str, k: int = 5) -> str:
130
+ """Genera una tabella comparativa basata sulla query."""
131
+ if self.vectorstore is None:
132
+ return "โš ๏ธ Errore: Nessun documento caricato. Carica prima un testo."
133
+
134
+ try:
135
+ retriever = self.vectorstore.as_retriever(search_kwargs={"k": k})
136
+
137
+ qa_chain = RetrievalQA.from_chain_type(
138
+ llm=self.llm,
139
+ chain_type="stuff",
140
+ retriever=retriever,
141
+ chain_type_kwargs={"prompt": self.table_prompt}
142
+ )
143
+
144
+ result = qa_chain.invoke({"query": query})
145
+ return result["result"]
146
+ except Exception as e:
147
+ return f"โŒ Errore durante la generazione: {str(e)}"
148
+
149
+ def reset(self):
150
+ """Resetta il vector store."""
151
+ self.vectorstore = None
152
+ return "๐Ÿ”„ Sistema resettato. Carica un nuovo testo."
153
+
154
+ # ========================================
155
+ # INIZIALIZZAZIONE
156
+ # ========================================
157
+
158
+ rag_system = ComparativeTableRAG()
159
+
160
+ # ========================================
161
+ # FUNZIONI GRADIO
162
+ # ========================================
163
+
164
+ def process_text_input(text):
165
+ """Carica un testo inserito dall'utente."""
166
+ if not text or not text.strip():
167
+ return "โš ๏ธ Per favore, inserisci un testo."
168
+
169
+ return rag_system.load_text(text)
170
+
171
+ def process_file_input(file):
172
+ """Carica un file caricato dall'utente."""
173
+ if file is None:
174
+ return "โš ๏ธ Per favore, carica un file."
175
+
176
+ try:
177
+ with open(file.name, 'r', encoding='utf-8') as f:
178
+ text = f.read()
179
+ return rag_system.load_text(text)
180
+ except Exception as e:
181
+ return f"โŒ Errore: {str(e)}"
182
+
183
+ def generate_comparative_table(query):
184
+ """Genera una tabella comparativa."""
185
+ if not query or not query.strip():
186
+ return "โš ๏ธ Per favore, inserisci una richiesta."
187
+
188
+ if rag_system.vectorstore is None:
189
+ return "โš ๏ธ Carica prima un testo nella sezione 'Caricamento Materiali'."
190
+
191
+ return rag_system.generate_table(query)
192
+
193
+ def reset_system():
194
+ """Resetta il sistema."""
195
+ return rag_system.reset()
196
+
197
+ def load_example():
198
+ """Carica il testo di esempio."""
199
+ result = rag_system.load_text(ESEMPIO_TESTO)
200
+ return result + "\n\n๐Ÿ“– Esempio: Rivoluzioni Industriali"
201
+
202
+ # ========================================
203
+ # INTERFACCIA GRADIO
204
+ # ========================================
205
+
206
+ with gr.Blocks(title="๐Ÿ“Š Tabelle Comparative con RAG") as demo:
207
+
208
+ gr.Markdown(
209
+ """
210
+ # ๐Ÿ“Š Generatore di Tabelle Comparative con RAG
211
+
212
+ Questo strumento utilizza l'intelligenza artificiale per creare tabelle comparative
213
+ basate sui materiali didattici che carichi.
214
+
215
+ ### ๐Ÿš€ Come funziona:
216
+ 1. **Carica** un testo o file con i materiali da studiare
217
+ 2. **Richiedi** una tabella comparativa specifica
218
+ 3. **Verifica** le informazioni con le tue fonti
219
+ """
220
+ )
221
+
222
+ with gr.Tab("๐Ÿ“ค Caricamento Materiali"):
223
+ gr.Markdown(
224
+ """
225
+ ### Carica i tuoi materiali didattici
226
+
227
+ Puoi caricare:
228
+ - Testo copiato da appunti, libri, articoli
229
+ - File di testo (.txt)
230
+ - Oppure usare l'esempio precaricato sulle Rivoluzioni Industriali
231
+ """
232
+ )
233
+
234
+ with gr.Row():
235
+ with gr.Column():
236
+ text_input = gr.Textbox(
237
+ label="๐Ÿ“ Incolla il tuo testo",
238
+ placeholder="Incolla qui il testo dei tuoi appunti o materiali didattici...",
239
+ lines=10
240
+ )
241
+ text_btn = gr.Button("๐Ÿ“ค Carica Testo", variant="primary")
242
+
243
+ with gr.Column():
244
+ file_input = gr.File(
245
+ label="๐Ÿ“ Oppure carica un file",
246
+ file_types=[".txt"]
247
+ )
248
+ file_btn = gr.Button("๐Ÿ“ค Carica File", variant="primary")
249
+
250
+ example_btn = gr.Button("๐Ÿ“– Usa Esempio: Rivoluzioni Industriali", variant="secondary")
251
+
252
+ upload_output = gr.Textbox(
253
+ label="๐Ÿ“Š Stato Caricamento",
254
+ lines=3
255
+ )
256
+
257
+ with gr.Tab("๐Ÿ“Š Generazione Tabelle"):
258
+ gr.Markdown(
259
+ """
260
+ ### Richiedi una tabella comparativa
261
+
262
+ Descrivi che tipo di confronto vuoi vedere.
263
+
264
+ **Esempi di richieste:**
265
+ - "Confronta le 4 rivoluzioni industriali per periodo, tecnologie e impatto sociale"
266
+ - "Crea una tabella che mostri l'evoluzione delle fonti di energia"
267
+ - "Confronta le condizioni di lavoro nelle diverse rivoluzioni"
268
+ """
269
+ )
270
+
271
+ query_input = gr.Textbox(
272
+ label="โœ๏ธ La tua richiesta",
273
+ placeholder="Es: Confronta le 4 rivoluzioni industriali in base a periodo, tecnologie e impatto sociale",
274
+ lines=3
275
+ )
276
+
277
+ generate_btn = gr.Button("๐ŸŽฏ Genera Tabella", variant="primary")
278
+
279
+ table_output = gr.Markdown(label="๐Ÿ“Š Tabella Generata")
280
+
281
+ gr.Examples(
282
+ examples=[
283
+ "Confronta le 4 rivoluzioni industriali per periodo storico, principali settori e fonti di energia",
284
+ "Crea una tabella che mostri l'impatto sociale di ogni rivoluzione industriale",
285
+ "Confronta le innovazioni tecnologiche chiave delle 4 rivoluzioni",
286
+ "Mostra l'evoluzione dell'organizzazione del lavoro attraverso le rivoluzioni"
287
+ ],
288
+ inputs=query_input
289
+ )
290
+
291
+ with gr.Tab("โ„น๏ธ Informazioni"):
292
+ gr.Markdown(
293
+ """
294
+ ## ๐Ÿ“š Cos'รจ RAG?
295
+
296
+ **RAG (Retrieval-Augmented Generation)** รจ una tecnica avanzata che permette all'IA di:
297
+
298
+ 1. **Cercare** informazioni rilevanti nei tuoi documenti
299
+ 2. **Comprendere** il contesto specifico
300
+ 3. **Generare** risposte basate SOLO sui tuoi materiali
301
+
302
+ ### ๐ŸŽฏ Vantaggi per lo Studio:
303
+
304
+ - โœ… Risposte basate sui TUOI materiali didattici
305
+ - โœ… Sintesi e organizzazione automatica delle informazioni
306
+ - โœ… Confronti strutturati tra concetti
307
+ - โœ… Risparmio di tempo nella creazione di schemi
308
+
309
+ ### โš ๏ธ Importante:
310
+
311
+ - L'IA puรฒ fare errori o omettere informazioni
312
+ - Verifica sempre le tabelle con i materiali originali
313
+ - Usa questo strumento come supporto, non come sostituto dello studio
314
+ - Discuti i risultati con i tuoi insegnanti
315
+
316
+ ### ๐Ÿ’ก Suggerimenti:
317
+
318
+ - Carica testi completi e dettagliati per risultati migliori
319
+ - Sii specifico nelle richieste (indica cosa vuoi confrontare)
320
+ - Usa le tabelle come punto di partenza per approfondimenti
321
+ - Integra con altri metodi di studio (mappe mentali, riassunti)
322
+
323
+ ---
324
+
325
+ ### ๐Ÿ“– Per gli Insegnanti:
326
+
327
+ Questo strumento puรฒ essere utilizzato per:
328
+ - **Sintesi**: Aiutare gli studenti a organizzare informazioni complesse
329
+ - **Confronto**: Creare tabelle comparative su argomenti studiati
330
+ - **Verifica**: Attivitร  di fact-checking delle tabelle generate
331
+ - **Discussione**: Analizzare cosa l'IA ha incluso/omesso
332
+
333
+ **Attivitร  suggerite:**
334
+ 1. Gli studenti caricano materiali e generano tabelle
335
+ 2. Verificano le informazioni con i testi originali
336
+ 3. Discutono in classe accuratezza e completezza
337
+ 4. Migliorano manualmente le tabelle
338
+
339
+ ---
340
+
341
+ <center>
342
+ <small>
343
+ Creato con โค๏ธ per la didattica inclusiva | Powered by LangChain & GPT-4.1-mini
344
+ </small>
345
+ </center>
346
+ """
347
+ )
348
+
349
+ # Pulsante reset
350
+ with gr.Row():
351
+ reset_btn = gr.Button("๐Ÿ”„ Reset Sistema", variant="stop")
352
+
353
+ # Eventi
354
+ text_btn.click(process_text_input, inputs=[text_input], outputs=[upload_output])
355
+ file_btn.click(process_file_input, inputs=[file_input], outputs=[upload_output])
356
+ example_btn.click(load_example, outputs=[upload_output])
357
+ generate_btn.click(generate_comparative_table, inputs=[query_input], outputs=[table_output])
358
+ reset_btn.click(reset_system, outputs=[upload_output])
359
+
360
+ # ========================================
361
+ # AVVIO APPLICAZIONE
362
+ # ========================================
363
+
364
+ if __name__ == "__main__":
365
+ demo.launch(
366
+ server_name="0.0.0.0",
367
+ server_port=7860,
368
+ share=False
369
+ )