Skip to content

Actual Budget ​

Conecta Crow a Actual Budget, una herramienta de finanzas personales con privacidad ante todo, para hacer seguimiento de gastos, gestionar presupuestos y ver reportes financieros a través de tu asistente de IA. Todos los datos permanecen en tu servidor.

Qué obtienes ​

  • Ver los saldos de todas tus cuentas
  • Explorar y buscar transacciones por cuenta, fecha, categoría o beneficiario
  • Crear nuevas transacciones desde lenguaje natural
  • Ver las categorías del presupuesto y los montos asignados por mes
  • Actualizar las asignaciones del presupuesto para cualquier categoría
  • Generar reportes de gastos por categoría, beneficiario o periodo de tiempo

Configuración ​

Crow soporta dos modos para Actual Budget: autoalojamiento vía Docker o conexión a una instancia existente.

Opción A: Docker (autoalojado) ​

Instala Actual Budget como un bundle de Crow. Esto ejecuta Actual Budget en Docker junto a tu gateway de Crow.

"Crow, instala el bundle de Actual Budget"

O instálalo desde el panel de Extensiones en el Crow's Nest.

Después de la instalación, Actual Budget estará disponible en http://tu-servidor:5006. Crow genera la contraseña del servidor, la establece en el servidor nuevo justo después de instalar y la guarda en Ajustes > Contraseñas (solo en esta máquina). Inicia sesión en Actual con ella y crea un presupuesto.

Opción B: Conectar a Actual Budget existente ​

Si ya tienes un servidor Actual Budget funcionando, conecta Crow directamente a él.

Configura lo siguiente en tu archivo .env o vía Crow's Nest > Ajustes > Integraciones:

bash
ACTUAL_URL=http://tu-servidor-actual:5006
ACTUAL_PASSWORD=tu-contrasena-del-servidor

Opcionalmente, configura ACTUAL_SYNC_ID para autoseleccionar un archivo de presupuesto específico (útil si tienes varios presupuestos):

bash
ACTUAL_SYNC_ID=tu-sync-id-de-presupuesto

Puedes encontrar el sync ID en los ajustes de Actual, en Avanzado > Mostrar ID del presupuesto.

Herramientas de IA ​

Una vez conectado, puedes gestionar tus finanzas a través de tu IA:

"¿Cuáles son los saldos de mis cuentas?"

"Muéstrame las transacciones del mes pasado"

"Agrega una transacción: $45.99 en Whole Foods, categoría supermercado"

"¿Cuál es mi presupuesto para comer fuera este mes?"

"¿Cuánto gasté en transporte en marzo?"

"Establece el presupuesto de supermercado en $500 para este mes"

Privacidad ​

Actual Budget está diseñado con la privacidad ante todo. Todos los datos financieros permanecen en tu servidor. Sin sincronización en la nube, sin acceso de terceros. El asistente de IA accede a tus datos solo a través de la API local.

Una nota sobre los montos ​

Internamente, Actual almacena los montos en centavos. Crow los convierte automáticamente a dólares para mostrarlos. Al crear transacciones, usa montos normales en dólares (ej., 45.99) en lugar de valores en centavos (ej., 4599).

Solución de problemas ​

"Conexión rechazada" o tiempo de espera agotado ​

Asegúrate de que la ACTUAL_URL sea accesible desde la máquina que ejecuta Crow. Si Actual Budget está en otra máquina, usa la IP o el nombre de host correcto. Verifica que el servidor esté funcionando.

"Login fallido" o error de autenticación ​

Para el servidor que instala Crow, Crow usa la contraseña generada en Ajustes > Contraseñas. Si la cambiaste en la interfaz web de Actual, o el servidor conservó sus datos (y su contraseña) de una instalación anterior, escribe la contraseña actual en ACTUAL_PASSWORD en Configurar. Para un servidor que ejecutas en otro lugar, ACTUAL_PASSWORD debe coincidir con su contraseña.

No aparecen datos del presupuesto ​

Actual Budget requiere que abras y selecciones un archivo de presupuesto antes de que la API pueda acceder a él. Abre la interfaz web de Actual y crea o selecciona un archivo de presupuesto. Alternativamente, configura ACTUAL_SYNC_ID en tu .env para autoseleccionar un presupuesto específico.

Los montos se ven mal ​

Asegúrate de usar montos en dólares (ej., 45.99) al crear transacciones a través de la IA, no valores en centavos (ej., 4599). Crow maneja la conversión automáticamente.

Released under the MIT License.