Instalar Cadrumo

Esta página cubre solo la instalación: obtener el paquete, instalar el comando aeat, añadir los extras opcionales que quieras y (si usas un asistente de IA) instalar el arnés de agente independiente. Si aún no tienes Cadrumo en tu máquina, empieza en Obtén Cadrumo para conocer las vías de adquisición y su disponibilidad actual. La configuración y el primer uso empiezan en la guía rápida una vez que pasen las comprobaciones de instalación.

Cadrumo funciona sin ningún servicio opcional. La exportación a Google, la visión LLM en el equipo, la subida a un LLM en la nube y el arnés de agente independiente son opcionales. El flujo de trabajo básico de presentación funciona sin ninguna de ellas.

Antes de empezar

Necesita:

  • Python 3.13 o posterior, con pip disponible.

  • Alrededor de 200 MB de espacio libre en disco.

Instalar la CLI

La beta se instala desde el repositorio del proyecto:

git clone https://github.com/nevenincs/cadrumo.git
cd cadrumo
uv sync
uv run aeat --version

Los listados en los registros de los canales empaquetados (PyPI, Scoop, Homebrew y el marketplace de plugins) se abrirán con el lanzamiento público; consulta Obtén Cadrumo para ver el estado actual de cada canal.

Confirmar la instalación

No hace falta ningún perfil de contribuyente para estas comprobaciones; puede crear uno con aeat config profile create después de instalar. Consulta Configurar un perfil.

Confirma que el comando está en su path y que el estado de capacidades es legible. Luego ejecuta la comprobación de la estación de trabajo en su propia máquina. Sus filas de dependencias y de plataforma reflejan intencionadamente esa estación de trabajo, incluidas las herramientas de su path, los recursos de navegador instalados y los ajustes del sistema operativo. Usa la forma legible por máquina para las comprobaciones de configuración automatizadas (--format json es un flag global, así que va antes del comando):

1Confirm the command is on your path.
aeat --version
aeat --version
2Ask what is installed and what is missing.
aeat config check
aeat config check
3Run the same check with machine-readable output for scripted setups.
aeat --format json config check
aeat --format json config check

Instalar extras opcionales desde la copia del código

La instalación básica es ligera. La exportación a Google, el navegador en vivo de la AEAT, el proveedor de la API de Anthropic, la importación de extractos bancarios OFX/QFX son extras opcionales del paquete. Indica los extras que necesites al instalar:

uv sync --extra google --extra browser

Los extras disponibles son google, browser, anthropic, ofx y all. aeat config check enumera cada extra e imprime el comando de instalación exacto de cualquiera que falte. Una función cuyo extra no esté instalado se rechaza con la misma indicación en lugar de fallar de forma poco clara.

Dos extras necesitan un paso de aprovisionamiento adicional después de la instalación con pip:

  • El extra browser utiliza una compilación de Chromium para lecturas en directo de la AEAT. Descarga la compilación exacta que lanza el extra instalado con:

    1Download the Chromium build the installed browser extra launches with.
    aeat config provision browser
    aeat config provision browser

    No hace nada cuando esa compilación ya está presente. Con el canal de navegador fijado en chromium, una lectura de navegador que no encuentre la compilación se rechaza y nombra este comando.

  • La lectura de facturas en el propio equipo utiliza un entorno de ejecución de modelos local (Ollama) con un modelo de texto para los PDF con capa de texto y un modelo de visión para los escaneos. Ejecuta aeat config provision status para ver tu situación: si el entorno de ejecución está instalado, si responde y qué modelos lectores están presentes.

    Después cierra lo que ese informe muestre como ausente. aeat config provision install instala el entorno de ejecución mediante winget en Windows o Homebrew en macOS, y solo con --confirm; no hace nada cuando el entorno de ejecución ya está instalado. En Linux, instala Ollama con su instalador original, que necesita privilegios de root. aeat config provision start inicia un entorno de ejecución instalado que no responde, y no hace nada cuando ya responde. aeat config provision pull descarga el modelo de cada rol lector, unos pocos GB en total; acótalo con --role para descargar el modelo de un rol cada vez. aeat config provision verify confirma que cada modelo se carga y responde.

Para la clasificación con un LLM en la nube, pon la CLI propia del proveedor en PATH e inicia sesión con el flujo de ese proveedor. Consulta Clasificar transacciones con un LLM.

Ejecuta aeat config check de nuevo tras cada cambio para confirmar que la carencia se ha resuelto.

Ejecuta la superficie del Model Context Protocol (MCP)

La distribución independiente cadrumo-harness de Cadrumo proporciona el servidor MCP, cadrumo-mcp, para que un asistente de IA pueda operar los mismos comandos locales y protegidos que expone la CLI, junto con un arnés de agente: las reglas del operador, las habilidades sobre la situación del contribuyente y las personas de agente acotadas que mantienen al asistente dentro del límite de seguridad.

En la beta, sincroniza ese miembro del espacio de trabajo y ejecuta el servidor desde la misma copia del repositorio:

uv sync --package cadrumo-harness
uv run --package cadrumo-harness cadrumo-mcp --help

Conecta un agente muestra el registro desde un checkout del código fuente y explica qué puede hacer el agente y qué no puede hacer.

Siguientes pasos