A sua primeira tradução

Do seu livro à tradução, passo a passo

Não precisa de saber programar. Se consegue descarregar um ficheiro, editar uma linha e copiar um comando, consegue preparar a primeira tradução.

Duas formas de traduzir

Qualquer uma serve. A única diferença é onde corre a tradução e se o ficheiro chega até nós.

Na nuvem, em berilo.app

Carregue o livro, escolha o idioma e o modelo, e a tradução corre no servidor. Não há nada para instalar, e pode fechar o separador e voltar mais tarde.

O original é apagado assim que a tradução termina. Não há catálogo, nem pesquisa, nem ligação pública; só a sua conta transfere o resultado, através de uma ligação que dura um minuto, e expira ao fim de 30 dias. Não o cedemos a ninguém.

A sua chave de API é guardada cifrada com AES-256-GCM, porque a tradução tem de continuar depois de fechar o separador. O navegador não a consegue voltar a ler; vê os quatro últimos caracteres e pode removê-la quando quiser.

Abrir a tradução na nuvem

No seu próprio computador

Execute o tradutor em casa. O ficheiro nunca sai da sua máquina; para o fornecedor que escolher vão apenas trechos soltos de texto. Precisa de Python e de alguns minutos para a instalação.

Ler as instruções passo a passo

O que é necessário

Prepare quatro coisas. Apenas a utilização do modelo de linguagem escolhido tem custos.

Um computador com Windows, macOS ou Linux.
O seu ficheiro EPUB, PDF ou MOBI, que deve ter o direito de tratar.
Python 3.10 ou mais recente, gratuito.
Uma chave API da OpenAI ou da Anthropic. Não precisa das duas.

Obtenha uma chave API

Uma chave API é uma palavra-passe privada que permite ao Berilo enviar texto diretamente ao fornecedor escolhido e cobrar a utilização na sua conta. Uma subscrição do ChatGPT ou do Claude não inclui necessariamente a API; confirme a faturação na consola do fornecedor.

OpenAI

Crie uma conta na OpenAI Platform, adicione saldo ou um método de pagamento, abra API keys e escolha Create new secret key. Copie a chave de imediato, pois não voltará a ser apresentada por inteiro.

Criar uma chave da OpenAI

Anthropic

Crie uma conta na consola do Claude, configure a faturação, abra API Keys e escolha Create Key. Esta chave também é apresentada apenas uma vez.

Criar uma chave da Anthropic

Não envie a chave por e-mail, não a publique nem a cole neste site. Guarde-a apenas no ficheiro local .env descrito abaixo. Defina um limite de gastos junto do fornecedor.

Descarregue o Berilo e o Python

Descarregue o projeto Berilo em ZIP a partir do GitHub e extraia-o num local que consiga encontrar depois, como Documentos/Berilo.

Descarregar o Berilo em ZIP Abrir o projeto no GitHub

Depois instale o Python 3.10 ou mais recente. No Windows, selecione Add Python to PATH no instalador.

Descarregar o Python do site oficial

Adicione a chave e instale o tradutor

Encontre .env.example na pasta extraída do Berilo. Se não vir ficheiros cujo nome começa por um ponto, ative a apresentação de ficheiros ocultos.

Faça uma cópia de .env.example e mude o nome da cópia para .env.
Abra .env num editor de texto. Cole a chave depois de OPENAI_API_KEY= ou ANTHROPIC_API_KEY=. A outra linha pode ficar vazia.
Abra um terminal na pasta do Berilo. No Windows, escreva powershell na barra de endereço da pasta; no macOS, abra o Terminal e arraste a pasta para a janela.

python -m pip install -e ./translator

Quando a instalação terminar, verifique a ligação. O teste traduz uma frase e tem um custo praticamente nulo.

berilo doctor

Verifique o custo e traduza

Copie o livro para a pasta do Berilo ou use o caminho completo no comando. Coloque sempre entre aspas os caminhos que contêm espaços.

Primeiro, confirme que o Berilo consegue ler o livro:

berilo inspect "moja-knjiga.epub"

Depois obtenha uma estimativa gratuita do custo. Faça-o sempre antes de traduzir:

berilo translate "moja-knjiga.epub" --to sl --dry-run

Se a estimativa for aceitável, inicie a tradução:

berilo translate "moja-knjiga.epub" --to sl

O EPUB traduzido é guardado junto do original. Pode reiniciar uma tradução interrompida: o Berilo continua a partir da cache e não volta a cobrar as secções já concluídas.

Abra o livro traduzido

Pode abrir imediatamente o EPUB traduzido em qualquer leitor de EPUB. Quando o APK oficial do Berilo for publicado, descarregue-o apenas a partir de Releases: permita a instalação de aplicações desconhecidas para o navegador ou gestor de ficheiros do Android e abra o APK descarregado.

Consultar as versões oficiais

Avançado: compilar a aplicação Android a partir do código

Esta opção requer Android Studio, um JDK e adb. Destina-se a pessoas com experiência técnica e não é necessária para a primeira tradução.

cd android
./gradlew assembleRelease

adb install -r app/build/outputs/apk/release/app-release.apk

Um limite justo

O Berilo ajuda a ler. Não ajuda a obter livros.

Use apenas ficheiros que possui legalmente e tem o direito de tratar. O Berilo não tem catálogo, downloads, remoção de DRM nem partilha. Assim, a ferramenta pode permanecer aberta e útil para os leitores, respeitando autores e editoras.

Voltar ao Berilo