Instal·la Cadrumo

Aquesta pàgina només tracta la instal·lació: obtén el paquet, instal·la l’ordre aeat, afegeix els extres opcionals que vulguis i (si utilitzes un assistent d’IA) instal·la l’arnès d’agent independent. Si encara no tens Cadrumo a la teva màquina, comença a Obtén Cadrumo per conèixer les vies d’adquisició i la seva disponibilitat actual. La configuració i el primer ús comencen a la guia d’inici ràpid un cop passin les comprovacions d’instal·lació.

Cadrumo funciona sense cap servei opcional. L’exportació a Google, la visió LLM al mateix equip, la pujada a un LLM al núvol i l’arnès d’agent independent són opcionals. El flux de treball de presentació bàsic funciona sense cap d’aquestes.

Abans de començar

Necessites:

  • Python 3.13 o superior, amb pip disponible.

  • Uns 200 MB d’espai lliure al disc.

Instal·la la CLI

La beta s’instal·la des del repositori del projecte:

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

Les llistes als registres dels canals empaquetats (PyPI, Scoop, Homebrew i el mercat de connectors) s’obriran amb el llançament públic; consulta Obtén Cadrumo per a l’estat actual de cada canal.

Confirma la instal·lació

No cal cap perfil de contribuent per a aquestes comprovacions; en crees un amb aeat config profile create després d’instal·lar. Consulta Configura un perfil.

Confirma que l’ordre és al teu path i que l’estat de capacitats es pot llegir. Després executa la comprovació de l’estació de treball a la teva màquina. Les seves files de dependències i de plataforma reflecteixen intencionadament aquesta estació de treball, incloent-hi les eines del teu path, els recursos de navegador instal·lats i la configuració del sistema operatiu. Utilitza la forma llegible per màquina per a comprovacions de configuració automatitzades (--format json és un indicador global, per la qual cosa va abans de l’ordre):

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

Instal·la els extres opcionals des de la còpia del codi font

La instal·lació bàsica és mínima. L’exportació a Google, el navegador AEAT en directe, el proveïdor de l’API d’Anthropic, la importació d’extractes bancaris OFX/QFX són extres opcionals del paquet. Indica els extres que necessites quan instal·les:

uv sync --extra google --extra browser

Els extres disponibles són google, browser, anthropic, ofx i all. aeat config check enumera cada extra i imprimeix l’ordre d’instal·lació exacta de qualsevol que falti. Una funcionalitat que necessita un extra no instal·lat es rebutja amb el mateix suggeriment en comptes de fallar de manera obscura.

Dos extres necessiten un pas d’aprovisionament addicional després de la instal·lació amb pip:

  • L’extra browser fa servir una compilació de Chromium per a lectures en directe de l’AEAT. Descarregueu la compilació exacta que llança l’extra instal·lat amb:

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

    No fa res quan aquesta compilació ja hi és. Amb el canal de navegador fixat a chromium, una lectura de navegador que no trobi la compilació es nega i anomena aquesta ordre.

  • La lectura de factures a l’equip mateix fa servir un entorn d’execució de models local (Ollama) amb un model de text per als PDF amb capa de text i un model de visió per als escanejos. Executeu aeat config provision status per veure on us trobeu: si l’entorn d’execució està instal·lat, si respon i quins models lectors hi ha.

    Després tanqueu tot allò que aquest informe mostri com a absent. aeat config provision install instal·la l’entorn d’execució mitjançant winget a Windows o Homebrew a macOS, i només amb --confirm; no fa res quan l’entorn d’execució ja està instal·lat. A Linux, instal·leu Ollama amb el seu instal·lador original, que necessita privilegis de root. aeat config provision start inicia un entorn d’execució instal·lat que no respon, i no fa res quan ja respon. aeat config provision pull descarrega el model de cada rol lector, uns pocs GB en total; limiteu-lo amb --role per descarregar el model d’un rol cada vegada. aeat config provision verify confirma que cada model es carrega i respon.

Per a la classificació amb un LLM al núvol, posa la CLI pròpia del proveïdor al PATH i inicia la sessió amb el flux d’aquest proveïdor. Consulta Classifica les transaccions amb un LLM.

Torna a executar aeat config check després de cada canvi per confirmar que la mancança està resolta.

Executa la superfície del Model Context Protocol (MCP)

La distribució independent cadrumo-harness de Cadrumo proporciona el servidor MCP, cadrumo-mcp, perquè un assistent d’IA pugui operar les mateixes ordres locals i protegides que exposa la CLI, juntament amb un arnès d’agent: les regles de l’operador, les habilitats sobre la situació del contribuent i els perfils d’agent d’abast limitat que mantenen l’assistent dins del límit de seguretat.

A la beta, sincronitza aquest membre de l’espai de treball i executa el servidor des de la mateixa còpia del repositori:

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

Connecta un agent mostra el registre des d’un checkout del codi font i explica què pot fer l’agent i què no pot fer.

Passos següents