Tu primera traducción

De tu libro a una traducción, paso a paso

No necesitas saber programar. Si puedes descargar un archivo, editar una línea y copiar un comando, puedes preparar tu primera traducción.

Qué necesitas

Prepara cuatro cosas. Solo cuesta dinero el uso del modelo de lenguaje que elijas.

  • Un ordenador con Windows, macOS o Linux.
  • Tu archivo EPUB, PDF o MOBI, que debes tener derecho a tratar.
  • Python 3.10 o posterior, gratuito.
  • Una clave API de OpenAI o Anthropic. No necesitas las dos.

Obtén una clave API

Una clave API es una contraseña privada que permite a Berilo enviar texto directamente al proveedor elegido y cargar el uso en tu cuenta. Una suscripción a ChatGPT o Claude no incluye necesariamente el uso de la API; revisa la facturación en la consola del proveedor.

OpenAI

Crea una cuenta en OpenAI Platform, añade saldo o un método de pago, abre API keys y selecciona Create new secret key. Cópiala de inmediato, porque la clave completa no volverá a mostrarse.

Crear una clave de OpenAI

Anthropic

Crea una cuenta en la consola de Claude, configura la facturación, abre API Keys y selecciona Create Key. Esta clave también se muestra una sola vez.

Crear una clave de Anthropic

No envíes la clave por correo, no la publiques ni la pegues en esta web. Guárdala únicamente en el archivo local .env descrito más abajo. Fija un límite de gasto con el proveedor.

Descarga Berilo y Python

Descarga el proyecto Berilo en formato ZIP desde GitHub y descomprímelo en un lugar que puedas encontrar después, como Documentos/Berilo.

Después instala Python 3.10 o posterior. En Windows, marca Add Python to PATH en el instalador.

Descargar Python desde la web oficial

Añade la clave e instala el traductor

Busca .env.example en la carpeta descomprimida de Berilo. Si no ves los archivos que empiezan por un punto, activa la visualización de archivos ocultos.

  1. Haz una copia de .env.example y cambia el nombre de la copia a .env.
  2. Abre .env en un editor de texto. Pega la clave después de OPENAI_API_KEY= o ANTHROPIC_API_KEY=. La otra línea puede quedar vacía.
  3. Abre una terminal en la carpeta de Berilo. En Windows, escribe powershell en la barra de direcciones de la carpeta; en macOS, abre Terminal y arrastra la carpeta hasta la ventana.
python -m pip install -e ./translator

Cuando termine la instalación, comprueba la conexión. La prueba traduce una frase y su coste es prácticamente nulo.

berilo doctor

Comprueba el coste y traduce

Copia el libro en la carpeta de Berilo o utiliza su ruta completa en el comando. Escribe siempre entre comillas las rutas que contengan espacios.

Primero, comprueba que Berilo puede leer el libro:

berilo inspect "moja-knjiga.epub"

Después obtén una estimación gratuita del coste. Hazlo siempre antes de traducir:

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

Si la estimación te parece adecuada, inicia la traducción:

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

El EPUB traducido se guarda junto al original. Puedes reiniciar una traducción interrumpida: Berilo continúa desde su caché y no vuelve a cobrar los fragmentos ya terminados.

Abre el libro traducido

Puedes abrir el EPUB traducido inmediatamente en cualquier lector de EPUB. Cuando se publique el APK oficial de Berilo, descárgalo únicamente desde Releases: permite la instalación de aplicaciones desconocidas para el navegador o gestor de archivos de Android y abre el APK descargado.

Consultar las versiones oficiales
Avanzado: compilar la aplicación Android desde el código

Esta opción requiere Android Studio, un JDK y adb. Está destinada a personas con experiencia técnica y no es necesaria para tu primera traducción.

cd android
./gradlew assembleRelease
adb install -r app/build/outputs/apk/release/app-release.apk

Un límite justo

Berilo te ayuda a leer. No te ayuda a conseguir libros.

Usa únicamente archivos que poseas legalmente y tengas derecho a tratar. Berilo no ofrece catálogo, descargas, eliminación de DRM ni funciones para compartir. Así la herramienta puede seguir abierta y ser útil para quienes leen, respetando a autores y editoriales.

Volver a Berilo