Skip to content

docs: add Spanish README - #1

Open
webbrain-one wants to merge 1 commit into
ambrosecltr:mainfrom
webbrain-one:webbrain/readme-translation
Open

docs: add Spanish README#1
webbrain-one wants to merge 1 commit into
ambrosecltr:mainfrom
webbrain-one:webbrain/readme-translation

Conversation

@webbrain-one

@webbrain-one webbrain-one commented Aug 7, 2026

Copy link
Copy Markdown

Adds README.es-ES.md alongside the original documentation.

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive Spanish README for Finn.
    • Documented setup with Docker Compose, environment variables, recommended models, local development, and system architecture.
    • Added guidance for the web app, macOS Puter app, repository structure, technology stack, documentation, and AGPL licensing.

@coderabbitai

coderabbitai Bot commented Aug 7, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Se añade README.es-ES.md con documentación completa en español sobre Finn. Incluye capacidades, despliegue, configuración, modelos, aplicaciones, desarrollo local, arquitectura, estructura del repositorio, referencias y licencia.

Changes

README en español

Layer / File(s) Summary
Capacidades y arquitectura del sistema
README.es-ES.md
Presenta Finn y describe sus agentes, trabajadores, memoria, Patterns, integraciones y componentes principales.
Despliegue y configuración
README.es-ES.md
Documenta Docker Compose, Postgres, Honcho, variables de entorno, modelos recomendados, proveedores LLM y configuración posterior al arranque.
Aplicaciones y desarrollo local
README.es-ES.md
Describe la aplicación web, Puter para macOS, la instalación local y los comandos habituales de desarrollo.
Referencia del repositorio y licencia
README.es-ES.md
Añade el mapa del repositorio, enlaces de documentación, la pila tecnológica y la licencia AGPL con sus requisitos de atribución.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the addition of the Spanish README, which is the pull request's main change.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.es-ES.md`:
- Line 13: Corrige los encabezados y enlaces internos de README.es-ES.md: haz
que el enlace de “Modelos recomendados” apunte al ancla generada por su
encabezado traducido, reemplaza el enlace inexistente de “configuration” por la
sección correspondiente y renombra los encabezados duplicados en las secciones
señaladas para generar anclas únicas. Conserva el contenido de las secciones y
actualiza todas las referencias afectadas.
- Line 274: Actualiza la descripción de la licencia en el texto de README para
reemplazar “Licencia Pública General Afirmativa de GNU” por el nombre legal
oficial “GNU Affero General Public License”, manteniendo la referencia a la
versión 3 o posterior y los enlaces existentes a LICENSE y NOTICE.
- Line 258: Actualiza la etiqueta del enlace en la sección correspondiente de
README.es-ES.md para que coincida con el destino
docs/operations/hindsight-memory.mdx: usa “Operaciones de Memoria Hindsight”.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 763326d9-e05e-4c89-8ceb-b4d08f3a0936

📥 Commits

Reviewing files that changed from the base of the PR and between 3a0036a and ebcae01.

📒 Files selected for processing (1)
  • README.es-ES.md

Comment thread README.es-ES.md

Finn forma parte del [Personal Intelligence Project](https://personalintelligenceproject.com).

> **Modelos recomendados:** **Opus (4.6 o 4.8)** en la ruta principal (hot path), **Kimi (2.6)** para todo lo demás. Finn fue optimizado para esta combinación. Opus transmite mejor la personalidad (adopta la identidad de Finn como algo central, no como una máscara superficial) y razona bien sobre el tiempo (hora actual, marcas de tiempo de memoria y mensajes), mientras que Kimi maneja el trabajo pesado en segundo plano de forma económica. Ambos son compatibles con visión y resisten bien en ejecuciones agenticas largas. Consulta [Modelos recomendados](#recommended-models).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Corrige los fragmentos internos y los encabezados duplicados.

Line [13] enlaza a #recommended-models, pero el encabezado traducido genera #modelos-recomendados. Line [40] enlaza a #configuration, que tampoco existe. Además, Line [28] y Line [56] usan el mismo título.

Renombra las secciones y actualiza los enlaces para evitar navegación rota y anclas ambiguas.

Propuesta
-Consulta [Modelos recomendados](`#recommended-models`).
+Consulta [Modelos recomendados](`#modelos-recomendados`).

-## Configuración
+## Despliegue

-Edita `.env` (al menos los valores en [Configuración](`#configuration`) a continuación, incluyendo `MEMORY_PROVIDER=honcho` y tu `HONCHO_API_KEY`), y luego inicia Finn:
+Edita `.env` (al menos los valores en [Variables de entorno](`#variables-de-entorno`) a continuación, incluyendo `MEMORY_PROVIDER=honcho` y tu `HONCHO_API_KEY`), y luego inicia Finn:

-## Configuración
+## Variables de entorno

La advertencia procede de markdownlint; las correcciones usan los encabezados presentes en este archivo.

Also applies to: 28-28, 40-40, 56-56

🧰 Tools
🪛 markdownlint-cli2 (0.23.2)

[warning] 13-13: Link fragments should be valid

(MD051, link-fragments)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.es-ES.md` at line 13, Corrige los encabezados y enlaces internos de
README.es-ES.md: haz que el enlace de “Modelos recomendados” apunte al ancla
generada por su encabezado traducido, reemplaza el enlace inexistente de
“configuration” por la sección correspondiente y renombra los encabezados
duplicados en las secciones señaladas para generar anclas únicas. Conserva el
contenido de las secciones y actualiza todas las referencias afectadas.

Source: Linters/SAST tools

Comment thread README.es-ES.md
- [Inteligencia Personal y My Day](docs/features/personal-intelligence-and-my-day.mdx)
- [Configuración](docs/operations/configuration.mdx)
- [Despliegue](docs/operations/deployment.mdx)
- [Operaciones de Memoria Honcho](docs/operations/hindsight-memory.mdx)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Alinea el texto del enlace con el documento de destino.

Line [258] muestra “Operaciones de Memoria Honcho”, pero apunta a docs/operations/hindsight-memory.mdx. Cambia la etiqueta a “Operaciones de Memoria Hindsight” o enlaza al documento correcto de Honcho.

Propuesta
-- [Operaciones de Memoria Honcho](docs/operations/hindsight-memory.mdx)
+- [Operaciones de Memoria Hindsight](docs/operations/hindsight-memory.mdx)

La ruta de Line [54] confirma que ese archivo corresponde a Hindsight.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- [Operaciones de Memoria Honcho](docs/operations/hindsight-memory.mdx)
- [Operaciones de Memoria Hindsight](docs/operations/hindsight-memory.mdx)
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.es-ES.md` at line 258, Actualiza la etiqueta del enlace en la sección
correspondiente de README.es-ES.md para que coincida con el destino
docs/operations/hindsight-memory.mdx: usa “Operaciones de Memoria Hindsight”.

Comment thread README.es-ES.md

## Licencia

Finn es software de código abierto licenciado bajo la Licencia Pública General Afirmativa de GNU versión 3 o posterior. Consulta [LICENSE](LICENSE) para el texto completo y [NOTICE](NOTICE) para la atribución del proyecto.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔒 Security & Privacy | 🟠 Major | ⚡ Quick win

Conserva el nombre legal exacto de la licencia.

Line [274] traduce “Affero” como “Afirmativa”, pero LICENSE identifica la licencia como GNU AFFERO GENERAL PUBLIC LICENSE, versión 3. Usa el nombre oficial para evitar una descripción legal incorrecta.

Propuesta
-Finn es software de código abierto licenciado bajo la Licencia Pública General Afirmativa de GNU versión 3 o posterior.
+Finn es software de código abierto licenciado bajo la GNU Affero General Public License (AGPL), versión 3 o posterior.

El encabezado de LICENSE proporcionado es la fuente legal de esta comparación.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Finn es software de código abierto licenciado bajo la Licencia Pública General Afirmativa de GNU versión 3 o posterior. Consulta [LICENSE](LICENSE) para el texto completo y [NOTICE](NOTICE) para la atribución del proyecto.
Finn es software de código abierto licenciado bajo la GNU Affero General Public License (AGPL), versión 3 o posterior. Consulta [LICENSE](LICENSE) para el texto completo y [NOTICE](NOTICE) para la atribución del proyecto.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.es-ES.md` at line 274, Actualiza la descripción de la licencia en el
texto de README para reemplazar “Licencia Pública General Afirmativa de GNU” por
el nombre legal oficial “GNU Affero General Public License”, manteniendo la
referencia a la versión 3 o posterior y los enlaces existentes a LICENSE y
NOTICE.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant