Código abierto · para autónomos y SL en España
Un gestor local para autónomos y SL en España
Facturas, gastos, IVA, IRPF, Beckham, RETA y el calendario de presentaciones. gestor calcula sus declaraciones y explica cada importe con la norma. La presentación la hace usted.
Alfa · no es asesoramiento fiscal MIT · gratis Funciona en su ordenador
Empiece con su agente
Pegue esto en Claude Code o Codex. El agente instala gestor y le guía en la primera sesión, una pregunta cada vez. Nunca presenta, firma ni paga.
Instala gestor desde https://github.com/gestor-es/gestor-es y guíame en la primera sesión. Háblame en español.
1. Clónalo en ~/gestor-es. gestor necesita Python 3.12+: si python3 es más antiguo, ayúdame a instalar uno nuevo y úsalo abajo.
2. En ~/gestor-es arranca la interfaz para que siga funcionando cuando salgas:
nohup python3 -m gestor > gestor.log 2>&1 &
Luego dame el enlace http://127.0.0.1:8765.
3. Conecta el servidor MCP de gestor para tu programa con el comando de la sección del README «Ayuda en la Sede desde Claude Code o Codex», ejecutado desde ~/gestor-es.
4. Dime que te reinicie en ~/gestor-es para que se cargue el servidor (`claude --continue` o `codex resume --last`) y que escriba «continúa». Después sigue las instrucciones First session del servidor gestor.
No presentes, firmes ni pagues nada. No me pidas el PIN de Cl@ve, contraseñas ni la clave del certificado.
Sesiones siguientes: en Claude Code escriba /mcp__gestor__start; en Codex escriba «empieza con gestor». El agente indica el plazo más cercano y qué hace falta para él.
Sin agente
git clone https://github.com/gestor-es/gestor-es ~/gestor-es
cd ~/gestor-es
python3 -m gestor # http://127.0.0.1:8765, datos en ~/.gestor
Qué calcula
Cada declaración que encuentra en el año un autónomo o una SL de un solo socio, con su plazo habitual. gestor traslada los plazos que caen en fin de semana o festivo nacional.
- 303IVA20.04 · 20.07 · 20.10 · 30.01Declaración trimestral de IVA
- 130Pago fraccionado IRPF20.04 · 20.07 · 20.10 · 30.01Autónomo en IRPF general
- 111Retenciones20.04 · 20.07 · 20.10 · 20.01Practicadas a profesionales y en nóminas que usted paga
- 115Retenciones de alquiler20.04 · 20.07 · 20.10 · 20.01Alquiler de oficina con retención
- 349Operaciones intracomunitarias20.04 · 20.07 · 20.10 · 30.01Solo en trimestres con clientes o proveedores de la UE
- 202Pago fraccionado IS20.04 · 20.10 · 20.12Sociedad Limitada
- 390Resumen anual de IVA30.01Resumen de los 303 del año
- 347Operaciones con tercerosfebreroMás de 3 005,06 € por contraparte
- 100Rentaabril–30.06IRPF anual, estimación
- 151Beckhamabril–30.06Régimen especial del art. 93, estimación
- 200Impuesto sobre Sociedades25.07SL, estimación
- RETASeguridad SocialmensualCuota de autónomos
Escalas autonómicas del IRPF: Comunitat Valenciana, Asturias, Madrid, Cataluña y Andalucía. Las demás comunidades usan la escala estatal como aproximación, y la pantalla lo indica.
Reglas, cifras y plazos detrás de estas declaraciones, con la norma citada: IVA · IRPF · Beckham · RETA · SL · calendario · visados. Base de conocimiento
Cómo funciona
Funciona en su ordenador. Python 3.12+, solo la biblioteca estándar, un fichero SQLite por perfil en ~/.gestor.
Cada importe lleva una marca § que abre su fuente: la cita literal del BOE, la AEAT o la DGT y qué significa para usted.
03MCPUn servidor MCP permite a Claude Code o Codex leer sus libros y declaraciones. Solo guarda borradores después de su «sí» explícito.
04ValidarEn la Sede de la AEAT el agente abre el formulario, importa el fichero o escribe las casillas y pulsa «Validar». No pulsa «Presentar». Firma usted.
05EN · ES · RUInterfaz, fuentes jurídicas, base de conocimiento y documentación en inglés, español y ruso.
Véalo con un perfil ficticio: las partes de gestor, el recorrido de una factura y un trimestre resuelto. Cómo funciona gestor
Preguntas
- ¿gestor presenta mis declaraciones?
- No. gestor calcula las declaraciones y prepara un fichero para importar en la Sede de la AEAT. Usted revisa las cifras y firma en la Sede.
- ¿Dónde se guardan mis datos?
- En su ordenador, en un fichero SQLite por perfil en
~/.gestor. - ¿Para quién es gestor?
- Para un autónomo en España en IRPF general o en régimen Beckham, y para una Sociedad Limitada de un solo socio con ingresos por servicios.
- ¿Qué agentes de IA funcionan con gestor?
- Claude Code y Codex, a través del servidor MCP de gestor. El agente lee sus libros y declaraciones, guarda borradores después de su «sí» explícito y puede rellenar el formulario de la Sede de la AEAT en su navegador.
- ¿Puedo usar gestor sin un agente de IA?
- Sí. Clone el repositorio y ejecute
python3 -m gestor. La interfaz se abre en http://127.0.0.1:8765. - ¿gestor sustituye a una gestoría?
- No. Calcula y explica las declaraciones de un autónomo o de una SL de un solo socio, y usted las presenta. Cada fuente jurídica está marcada como explícita en el texto, interpretación o discutida. Para los puntos discutidos y la contabilidad completa de una SL, consulte a un profesional.
- ¿gestor es asesoramiento fiscal?
- No. Calcula y explica con fuentes del BOE, la AEAT y la TGSS. Compruebe cada cifra antes de firmar.
- ¿Cuánto cuesta gestor?
- Nada. Es de código abierto con licencia MIT.