A Cadrumo telepítése

Ez az oldal csak a telepítéssel foglalkozik: szerezze be a csomagot, telepítse az aeat parancsot, adja hozzá a kívánt opcionális kiegészítőket, és (ha AI-asszisztenst használ) telepítse a különálló ügynöki keretrendszert. Ha a Cadrumo még nincs a gépén, kezdje itt: A Cadrumo beszerzése, amely bemutatja a beszerzési útvonalakat és azok aktuális elérhetőségét. A konfigurálás és az első használat a gyorsindítóban kezdődik, miután a telepítési ellenőrzések sikeresen lefutottak.

A Cadrumo bármilyen opcionális szolgáltatás nélkül működik. A Google export, a helyi (on-host) LLM-alapú képfeldolgozás, a felhőbeli LLM-feltöltés és a különálló ügynöki keretrendszer mind választható. Az alapvető benyújtási munkafolyamat egyikük nélkül is fut.

Mielőtt hozzákezd

Szüksége lesz a következőkre:

  • Python 3.13 vagy újabb, elérhető pip-pel.

  • Körülbelül 200 MB szabad lemezterület.

A CLI telepítése

A béta a projekt tárolójából települ:

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

A csomagolt csatornák (PyPI, Scoop, Homebrew és a beépülőpiactér) registry-listázásai a nyilvános indulással nyílnak meg; az egyes csatornák aktuális állapotát lásd az A Cadrumo beszerzése oldalon.

A telepítés megerősítése

Ezekhez az ellenőrzésekhez nincs szükség adózói profilra; egyet a telepítés után az aeat config profile create paranccsal hoz létre. Lásd: Profil beállítása.

Erősítse meg, hogy a parancs elérhető az elérési útján, és hogy a képességek állapota olvasható. Ezután futtassa a munkaállomás-ellenőrzést a saját gépén. Annak függőségi és platformsorai szándékosan azt a munkaállomást tükrözik, beleértve az elérési útján lévő eszközöket, a telepített böngészőelemeket és az operációs rendszer beállításait. A szkriptelt beállítási ellenőrzésekhez használja a gépi olvasható formát (a --format json globális kapcsoló, ezért a parancs elé kerül):

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

Opcionális kiegészítők telepítése a forráskód-kimásolásból

Az alaptelepítés karcsú. A Google export, az élő AEAT-böngésző, az Anthropic-API szolgáltató és az OFX/QFX bankkivonat-importálás opcionális csomagkiegészítők. A telepítéskor nevezze meg a szükséges kiegészítőket:

uv sync --extra google --extra browser

Az elérhető kiegészítők: google, browser, anthropic, ofx és all. Az aeat config check felsorolja az egyes kiegészítőket, és kiírja a pontos telepítési parancsot minden hiányzóhoz. Az a funkció, amelynek kiegészítője nincs telepítve, ugyanezzel a tippel utasítja el a kérést, ahelyett, hogy homályosan meghiúsulna.

Két kiegészítőhöz a pip-telepítés után további előkészítési lépésre van szükség:

  • A browser extra egy Chromium-építést használ az élő AEAT-olvasásokhoz. Töltse le pontosan azt az építést, amelyet a telepített extra indít:

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

    Semmit sem tesz, ha az az építés már megvan. Ha a böngészőcsatorna chromium, akkor az az olvasás, amely nem találja az építést, elutasít, és megnevezi ezt a parancsot.

  • A gépen belüli számlaolvasás helyi modellfuttatókörnyezetet (Ollama) használ: szövegmodellt a szövegréteges PDF-ekhez és képmodellt a beolvasott képekhez. Az aeat config provision status megmutatja, hol áll: telepítve van-e a futtatókörnyezet, válaszol-e, és mely olvasómodellek vannak meg.

    Ezután pótolja mindazt, amit a jelentés hiányzóként mutat. Az aeat config provision install a futtatókörnyezetet Windowson winget, macOS-en Homebrew segítségével telepíti, és csak a --confirm kapcsolóval; ha a futtatókörnyezet már telepített, semmit sem tesz. Linuxon az Ollamát a saját telepítőjével kell felrakni, amely rendszergazdai jogot kér. Az aeat config provision start elindít egy telepített, de nem válaszoló futtatókörnyezetet, és semmit sem tesz, ha az már válaszol. Az aeat config provision pull minden olvasó szerepkör modelljét letölti, összesen néhány GB-ot; a --role kapcsolóval egyszerre egy szerepkör modelljére szűkítheti. Az aeat config provision verify ellenőrzi, hogy minden modell betölt és válaszol.

A felhőbeli LLM-alapú besoroláshoz helyezze a szolgáltató saját CLI-jét a PATH-ra, és jelentkezzen be a szolgáltató folyamatával. Lásd: Tranzakciók besorolása LLM-mel.

Minden változtatás után futtassa újra az aeat config check parancsot, hogy megerősítse a hiányosság megszűnését.

A Model Context Protocol (MCP) felület futtatása

A Cadrumo különálló cadrumo-harness disztribúciója biztosítja a cadrumo-mcp MCP-kiszolgálót, így egy MI-asszisztens ugyanazokat a helyi, korlátozott parancsokat kezelheti, amelyeket a CLI elérhetővé tesz, egy ügynöki keretrendszerrel együtt: az operátori szabályok, az adózói helyzethez tartozó készségek és a meghatározott hatókörű ügynökszerepkörök a biztonsági határon belül tartják az asszisztenst.

A bétában szinkronizálja ezt a munkaterületi tagot, és futtassa a kiszolgálót ugyanabból a repozitórium-munkapéldányból:

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

A Kapcsolódás ügynökhöz oldal megmutatja a forrás-checkout regisztrációját, és elmagyarázza, mire képes az ügynök, illetve mire nem.

Következő lépések