Non serve saper programmare. Se sa scaricare un file, modificare una riga e copiare un comando, può preparare la Sua prima traduzione.
Due strade per tradurre
Vanno bene entrambe. L'unica differenza è dove procede la traduzione e se il file arriva o no fino a noi.
Nel cloud, su berilo.app
Carichi il libro, scelga la lingua e il modello, e la traduzione procede sul server. Non deve installare nulla e può chiudere la scheda e tornare più tardi.
L'originale viene eliminato appena la traduzione è pronta. Non esiste un catalogo, né una ricerca, né un link pubblico; solo il Suo account scarica il risultato, con un link valido un minuto, e scade dopo 30 giorni. Non lo trasmettiamo a nessuno.
La Sua chiave API è salvata cifrata con AES-256-GCM, perché la traduzione deve proseguire dopo che ha chiuso la scheda. Il browser non può rileggerla; ne vede le ultime quattro cifre e può rimuoverla quando vuole.
Esegua il traduttore in locale. Il file non lascia mai la Sua macchina; al fornitore che sceglie vanno soltanto singoli tratti di testo. Le servono Python e qualche minuto per l'installazione.
Prepari quattro elementi. Soltanto l’uso del modello linguistico scelto comporta un costo.
Un computer Windows, macOS o Linux.
Il Suo file EPUB, PDF o MOBI, che deve avere il diritto di trattare.
Python 3.10 o successivo, gratuito.
Una chiave API OpenAI o Anthropic. Non servono entrambe.
01
Ottenga una chiave API
Una chiave API è una password privata che permette a Berilo di inviare il testo direttamente al fornitore scelto e addebitare l’uso al Suo account. Un abbonamento ChatGPT o Claude non include necessariamente l’uso delle API; controlli la fatturazione nella console del fornitore.
OpenAI
Crei un account su OpenAI Platform, aggiunga credito o un metodo di pagamento, apra API keys e scelga Create new secret key. Copi subito la chiave, perché in seguito non sarà più mostrata per intero.
Non invii la chiave per e-mail, non la pubblichi e non la incolli in questo sito. La conservi soltanto nel file locale .env descritto qui sotto. Imposti un limite di spesa presso il fornitore.
02
Scarichi Berilo e Python
Scarichi il progetto Berilo in formato ZIP da GitHub e lo estragga in una posizione facile da ritrovare, per esempio Documenti/Berilo.
Cerchi .env.example nella cartella Berilo estratta. Se non vede i file che iniziano con un punto, abiliti la visualizzazione dei file nascosti.
Crei una copia di .env.example e rinomini la copia in .env.
Apra .env in un editor di testo. Incolli la chiave dopo OPENAI_API_KEY= o ANTHROPIC_API_KEY=. L’altra riga può restare vuota.
Apra un terminale nella cartella Berilo. In Windows scriva powershell nella barra degli indirizzi della cartella; in macOS apra Terminale e trascini la cartella nella finestra.
python -m pip install -e ./translator
Al termine dell’installazione, verifichi la connessione. Il test traduce una frase e ha un costo pressoché nullo.
berilo doctor
04
Controlli il costo e traduca
Copi il libro nella cartella Berilo oppure usi il percorso completo nel comando. Racchiuda sempre tra virgolette i percorsi che contengono spazi.
Per prima cosa verifichi che Berilo riesca a leggere il libro:
berilo inspect "moja-knjiga.epub"
Poi ottenga una stima gratuita del costo. Lo faccia sempre prima di tradurre:
L’EPUB tradotto viene salvato accanto all’originale. Può riavviare una traduzione interrotta: Berilo riprende dalla cache e non addebita nuovamente le sezioni già completate.
05
Apra il libro tradotto
Può aprire subito l’EPUB tradotto in qualsiasi lettore EPUB. Quando verrà pubblicato l’APK ufficiale di Berilo, lo scarichi soltanto da Releases: consenta l’installazione di app sconosciute per il browser o il gestore file di Android, quindi apra l’APK scaricato.
Berilo aiuta a leggere. Non aiuta a procurarsi libri.
Usi soltanto file che possiede legalmente e che ha il diritto di trattare. Berilo non offre cataloghi, download, rimozione di DRM o condivisione. In questo modo lo strumento può restare aperto e utile a chi legge, nel rispetto di autori ed editori.