mietfuchs
Herramienta local para generar abonos de gastos de comunidad en Alemania (Nebenkostenabrechnung) sin nube ni cuentas externas. Compatible con Docker y Node.js 24.15+. Incluye análisis opcional de facturas mediante IA local.
Ficha actualizada 22 sept 2026, 15:14 · upstream 22 sept 2026, 14:45 · release v0.7.1
Qué es mietfuchs
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Mietfuchs es una aplicación de escritorio diseñada específicamente para propietarios privados en Alemania que necesitan generar abonos anuales de gastos de comunidad (Nebenkostenabrechnung). Funciona completamente offline sin depender de servicios en la nube, cuentas externas o pagos recurrentes. Los datos residen exclusivamente en un archivo JSON local junto a la aplicación.
La herramienta gestiona el ciclo completo: registro de facturas y consumos, cálculo preciso de distribuciones según superficie, número de personas o unidades habitables, generación de saldos por inquilino con menciones legales (§35a EStG, §556/§560 BGB), seguimiento del alquiler mediante cuenta de alquiler (Mietkonto) y elaboración de la declaración fiscal (Anlage V). También incluye gestión de contadores con alertas de consumo negativo.
La arquitectura combina un servidor Node.js con una interfaz frontend en TypeScript. Soporta despliegue directo, instalación en paquetes distribucionales o contenedores Docker. La evaluación automática de facturas mediante IA es opcional y requiere Ollama o servicio externo independiente.
- Generar abonos anuales de gastos de comunidad para múltiples inquilinos con distribución centesimal exacta
- Gestionar la cuenta de alquiler (Mietkonto) con seguimiento mensual de pagos, saldos y vencimientos
- Elaborar declaración fiscal anual (Anlage V) con desglose de ingresos, gastos deducibles y excedentes
- Registrar consumos por contadores con historial de lecturas y alertas de consumo negativo tras cambio de contador
- Evaluación automática de facturas mediante IA local para reducir entrada manual de datos (opcional)
- Gestionar múltiples propiedades en un mismo sistema con separación clara entre vivienda propia y alquilada
- 100% local sin dependencia de servicios en la nube ni cuentas externas
- Distribución centesimal exacta según superficie, número de personas o unidades habitables
- Generación automática de abonos con menciones legales (§35a EStG, §556/§560 BGB)
- Soporte nativo para Docker y despliegue en servidores headless vía SSH
- Licencia MIT sin restricciones comerciales ni de redistribución
- Evaluación opcional de facturas mediante IA local con Ollama o servicio externo
- Requiere Node.js 24.15+ para ejecución desde código fuente (no necesario en binarios)
- La evaluación automática de facturas necesita instalación separada de Ollama o acceso a API externa
- No incluye funcionalidades específicas para gestión inmobiliaria profesional ni contabilidad empresarial
- Actualizaciones no automáticas: descargar nueva versión desde releases y ejecutar manualmente
- Dependencia del sistema operativo para firma de ejecutables (Windows/macOS/Linux con glibc 2.17+)
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.
Ejecutar directamente descomprimiendo el binario correspondiente al sistema o usar Docker Compose. Para desarrollo: npm install y npm run dev en puerto 3001/5173. Datos en data/ (o ~/.local/share/mietfuchs si instalado como paquete). Backup copiado del directorio de datos. Actualizar manualmente desde releases.
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.