gestor GitHub

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.

Para Claude Code o Codex

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

01local

Funciona en su ordenador. Python 3.12+, solo la biblioteca estándar, un fichero SQLite por perfil en ~/.gestor.

02§

Cada importe lleva una marca § que abre su fuente: la cita literal del BOE, la AEAT o la DGT y qué significa para usted.

03MCP

Un servidor MCP permite a Claude Code o Codex leer sus libros y declaraciones. Solo guarda borradores después de su «sí» explícito.

04Validar

En 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 · RU

Interfaz, 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.
gestor calcula; la presentación la hace usted en la Sede de la AEAT. No es asesoramiento fiscal. github.com/gestor-es/gestor-es · MIT · Tipografías PT Sans, PT Mono, Prata (OFL)