# Manuale d'Uso: Il Poetificatore Benvenuto ne **Il Poetificatore**, un'applicazione ideata per trasformare i tuoi spunti emotivi, visioni e riflessioni più profonde in composizioni poetiche che seguono le grandi strutture canonizzate della tradizione letteraria italiana. Questo manuale ti guiderà nella configurazione e nell'utilizzo dello strumento. ## 1. Impostazioni dell'Intelligenza Artificiale (Provider AI) Il cuore del Poetificatore è mosso da un'Intelligenza Artificiale Generativa. Il sistema supporta l'utilizzo di modelli Locali o in Cloud. Nel pannello di sinistra, trovi la sezione **Impostazioni AI**. ### 1.1 Scegliere un Provider Dal menù a tendina **Provider AI**, puoi selezionare uno dei quattro motori supportati: - **Ollama**: Ideale se hai installato Ollama sul tuo computer per lanciare modelli linguistici in locale. L'URL di default è `http://localhost:11434`. - **LM Studio**: Ideale se preferisci utilizzare l'interfaccia di LM Studio con un server locale esposto. In questo caso l'URL predefinito solitamente è `http://localhost:1234/v1`. - **Google Gemini**: Per utilizzare i modelli in cloud di casa Google (es. `gemini-1.5-flash`). Richiede una **API Key** di Google AI Studio. - **OpenAI (ChatGPT)**: Per usare modelli come `gpt-4o`. Richiede una **API Key** della piattaforma OpenAI. ### 1.2 Configurazione della Connessione - **Se usi motori locali (Ollama, LM Studio)**: Clicca sul tasto **"🔄 Connetti / Carica Modelli"**. Il sistema interrogherà il tuo applicativo in locale e, se la connessione andrà a buon fine, un indicatore si colorerà di verde ("🟢 Connesso"). Nel menù "Modello" comparirà la lista dei LLM scaricati sul tuo PC. - **Se usi motori in Cloud (Gemini, OpenAI)**: Compariranno i campi per incollare l'**API Key**. Incolla la tua chiave segreta, indica testualmente il nome del modello, e clicca per confermare. L'indicatore si illuminerà ("🟢 Chiave impostata"). ## 2. Inserimento dei Temi: Cosa Scrivere La colonna di sinistra ospita l'area dedicata agli **Spunti Emotivi (Input)**. Qui **non** devi inserire testi interi o prose lunghe già rifinite, ma **temi significativi**, spunti descrittivi o frammenti espressivi. Ad esempio: - *Tema dell'amore perduto in un paesaggio autunnale umido e malinconico.* - *Senso di ribellione politica in una grande metropoli grigia, descrivendola con odore di asfalto e luci al neon.* - *La bellezza serena e fragile dell'esistenza osservata guardando fiorire un ciliegio in giardino all'alba.* Più sarai generoso nella **ricchezza dei dettagli emotivi, visivi e sensoriali**, più la poesia che l'AI andrà a forgiare risulterà evocativa e non banale. Puoi pulire agilmente quest'area cliccando sull'icona col cestino (🗑️) in alto a destra. ## 3. Le Forme Poetiche Prima di generare, seleziona la conformazione letteraria dal pannello a sinistra nella voce **Scegli la forma**. Il sistema forzerà il modello linguistico a comportarsi come un vate del passato, strutturando i tuoi temi in regole precise: 1. **Il Sonetto**: Forma classica e amorosa (Due quartine e due terzine per un totale di 14 endecasillabi). Dispositivo cardine dell'argomentazione lirica. 2. **La Canzone**: La creatura più aulica tra Trecento e Cinquecento, composta solitamente da Fronte, Sirma e Congedo. Piena e stratificata. 3. **La Terzina (Terza Rima)**: Omaggio a Dante. Strofe a gruppi di tre, incatenate dalle rime (ABA BCB CDC). Crea un effetto perpetuo ed è adatta alle narrazioni lunghe. 4. **L'Ottava**: Il cuore del poema cavalleresco. Otto endecasillabi (ABABABCC) dove i due ultimi versi (la rima baciata) fungono da fulmineo concetto lapidario e conclusivo per l'intera strofa. 5. **La Ballata**: Intrisa di un intrinseco animo musicale. Presenta una ripresa reiterata (una sorta di ritornello) a fine di ogni strofa. Molto ritmica e cadenzata. 6. **Il Madrigale**: Costruzione libera ma brevissima ed estremamente curata. Utilizza endecasillabi incisivi con inusitate rime per formare un fugace lampo estetico di grande eleganza. 7. **La Sestina**: Composizione tra le più ardue a livello tecnico. Sei strofe di sei versi ciascuna in cui si susseguono all'infinito le sei stesse parole in posizioni invertite. 8. **L'Ode**: In bilico tra slancio etico, civile o esaltazione morale. Ritmi robusti e stendardi alti alla memoria di poeti classici come Parini o Manzoni. 9. **Bouts-rimés (Rime Obbligate)**: Divertissement letterario nato nei salotti seicenteschi. Consiste nel fornire, inserendole nell'Input insieme ai temi, una lista predefinita di parole. L'AI genererà esattamente un verso per ogni parola e posizionerà ciascuna parola, nel medesimo ordine, come **conclusione inequivocabile di ogni singola riga** (la rima obbligata). ## 4. Composizione (Output) e Azioni Una volta che il modello è configurato, i temi sono scritti e lo stile scelto, puoi premere il vistoso pulsante **✨ POETIFICA ✨**. Apparirà un livello di caricamento durante l'ispirazione. Terminata l'elaborazione, i versi verranno mostrati elegantemente nell'area denominata **Composizione (Output)** sulla destra. Da qui hai a dispozione due strumenti in alto a destra: - **Copia (📋)**: Clona nei tuoi appunti l'intero testo composto. Utile per incollarlo in altri documenti. - **Salva come .md (💾)**: Genera e scarica automaticamente nel tuo computer un file `.md` (Markdown) che avrà come titolo generato all'interno proprio lo stile poetico che hai scelto. Ideale per archiviare subito le tue composizioni. **Nota sui token per Modelli Cloud**: Ogni qualvolta schiacci *Poetifica* impiegando motori OpenAI o Gemini a pagamento, scalerai il computo base per interrogare l'API. Assicurati inoltre che il provider supporti a pieno l'Italiano e abbia competenze nella lingua per assecondare complesse rime letterarie (modelli molto performanti o pesanti daranno esiti migliori sulla struttura metrica).