HomeLedger
HomeLedger es una aplicación open source para gestionar finanzas personales y presupuestos, auto-alojada en tu servidor. Ofrece seguimiento de cuentas, gastos, objetivos y patrimonio neto con enfoque en la privacidad, funcionando como alternativa a servicios en la nube como Mint o YNAB.
Ficha actualizada 22 sept 2026, 16:11 · upstream 17 sept 2026, 2:10 · release v1.1.1
Qué es HomeLedger
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
HomeLedger es una herramienta de gestión financiera personal auto-alojada diseñada para usuarios que desean mantener el control total de sus datos financieros sin depender de servicios centralizados en la nube. Construida con tecnologías modernas como SvelteKit 5 y Fastify, permite rastrear múltiples cuentas (cuentas corrientes, tarjetas, inversiones), ingresos, gastos, presupuestos por categoría y objetivos de ahorro. La aplicación incluye un motor de reglas para categorización automática de transacciones y soporte para OCR en recibos adjuntos.
El sistema soporta una única moneda por instalación (configurable al inicio) y ofrece funcionalidades avanzadas como monitoreo de crédito, gestión de suscripciones recurrentes con calendario visual, préstamos con plan de amortización y alertas automáticas para saldos bajos o pagos vencidos. Cuenta con un panel de control completo que muestra el patrimonio neto, tendencias de gasto y salud financiera en tiempo real.
La plataforma está optimizada para entornos domésticos y servidores personales, ofreciendo despliegue sencillo mediante Docker o como complemento de Home Assistant. Incluye una API REST completa autenticada con JWT para integraciones externas y permite exportar/importar datos completos en formato JSON con validación previa. El código fuente es abierto bajo licencia MIT, fomentando la transparencia y la seguridad del usuario.
- Gestión de presupuesto familiar o personal con seguimiento de gastos por categoría
- Seguimiento de patrimonio neto y objetivos de ahorro a largo plazo
- Automatización de finanzas mediante reglas de categorización y alertas automáticas
- Integración en ecosistema doméstico (Home Assistant) para visualización en dashboards
- Auditoría financiera local sin enviar datos sensibles a terceros o servicios cloud
- Gestión de préstamos y tarjetas de crédito con seguimiento de intereses y pagos
- Privacidad-first: Datos almacenados localmente en SQLite, sin envío a servidores externos
- Tecnología moderna: Stack SvelteKit + Fastify + TypeScript para rendimiento y mantenibilidad
- Integración Home Assistant: Disponible como addon oficial y custom integration con sensores
- OCR de recibos: Capacidad para analizar imágenes adjuntas y extraer datos de transacciones
- API REST completa: Endpoints bajo /api/v1 con autenticación JWT para automatizaciones
- Soporte multi-moneda: Configuración de moneda única por instalación (MXN, USD, EUR, etc.)
- Moneda única por instalación: No permite cambiar la moneda globalmente sin reinstalar o reconfigurar variables de entorno
- Base de datos SQLite: Puede no ser óptima para volúmenes masivos de transacciones en comparación con PostgreSQL
- OCR dependiente de librerías externas: La precisión del reconocimiento de texto puede variar según la calidad de la imagen
- Sin sincronización cloud nativa: No ofrece sincronización automática entre múltiples instancias sin solución propia
- Recuperación de cuenta limitada: El proceso de recuperación está bloqueado si se pierde el acceso al admin inicial
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar con Docker usando la imagen irving1flores/homeledger. Es obligatorio mapear el puerto 3000 y persistir datos en un volumen para /data. Configurar variables de entorno JWT_SECRET y ADMIN_PASSWORD antes del primer inicio. Para Home Assistant, instalar como addon o integración HACS. Verificar compatibilidad de arquitectura CPU al descargar la imagen multi-arch.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.