Documentation

Everything you need — written for business owners, entrepreneurs and accountants. No IT background required. If you can use email, you can use this.

Dokumentáció

Minden, amire szükséged van — vállalkozóknak, cégvezetőknek és könyvelőknek írva. Nem kell informatikusnak lenned. Ha e-mailt tudsz írni, ezt is tudod használni.

Contents

Tartalom

🖥️ Version 1 — The Web App ( recommended for most users )1. verzió — Webes alkalmazás ( a legtöbb felhasználónak ajánlott )

Works in your browser. Nothing to install. Your data is stored encrypted on our servers in the EU.

A böngésződben fut. Nincs telepítés. Az adataid titkosítva, EU-s szervereken tárolódnak.

  1. Create your account

    Go to the homepage and click Start Free. Sign up with your email. No credit card needed — the free plan includes 100 transactions per month, forever.

  2. Hozd létre a fiókod

    Menj a kezdőoldalra és kattints a Start Free-re. Regisztrálj e-maillel. Bankkártya nem kell — az ingyenes csomag havonta 100 tranzakciót tartalmaz, korlátlan ideig.

  3. Add your company

    Click Add Company, enter the company name and pick your country. The country decides which official tax forms the system prepares for you ( 40 countries supported ).

  4. Vedd fel a céged

    Kattints az Add Company-ra, add meg a cég nevét és válaszd ki az országot. Az ország határozza meg, hogy mely hivatalos adóűrlapokat készíti el neked a rendszer ( 40 ország támogatott ).

  5. Get your numbers in — 3 ways

    📷 Receipts: photograph or upload them; AI reads the vendor, date, amount and tax automatically.
    🏦 Bank statement: upload the CSV export from your bank.
    ✍️ Manual: type transactions in by hand.

  6. Töltsd be a számaidat — 3 mód

    📷 Nyugták: fényképezd le vagy töltsd fel; az AI kiolvassa a kiállítót, dátumot, összeget és az adót.
    🏦 Bankkivonat: töltsd fel a bank CSV-exportját.
    ✍️ Kézi: kézzel is beviheted a tranzakciókat.

  7. Let the AI work

    Every transaction is categorized automatically ( income, expense, tax category ). Something wrong? Fix it with one click — the AI learns from your correction.

  8. Hagyd dolgozni az AI-t

    Minden tranzakció automatikusan kategorizálódik ( bevétel, költség, adókategória ). Hiba van? Egy kattintással javítod — az AI tanul a javításodból.

  9. Download your tax forms

    Open Forms → choose your country's forms ( e.g. Hungarian EKHO/ÁFA, German ESt/USt ) → Generate → download as PDF. Deadlines and official submission channels are shown for each form.

  10. Töltsd le az adóűrlapokat

    Nyisd meg a Forms menüt → válaszd az országod űrlapjait ( pl. magyar EKHO/ÁFA, német ESt/USt ) → Generate → PDF-letöltés. Minden űrlaphoz ott a határidő és a hivatalos beadási csatorna.

  11. Ask questions ( optional )

    Use the built-in AI chat to ask things like "How much VAT do I owe this quarter?" — answers come from your own numbers, not generic advice.

  12. Kérdezz ( opcionális )

    A beépített AI-chatben kérdezhetsz ilyeneket: „Mennyi ÁFA-t kell befizetnem ebben a negyedévben?" — a válaszok a saját számaidból jönnek, nem általános tanácsok.

💡 Upgrading: Plans ( Starter $2.99 / Business $5.99 / Enterprise $14.99 per month ) are managed with your card in the Dashboard → Billing. Cancel any time.
💡 Frissítés: A csomagok ( Starter $2.99 / Business $5.99 / Enterprise $14.99 havonta ) a Dashboard → Billing menüben, bankkártyával kezelhetők. Bármikor lemondhatók.

🏠 Version 2 — Self-Hosted Agent ( maximum privacy )2. verzió — Self-Hosted Agent ( maximális adatvédelem )

The same accounting engine runs on your own computer or server. Your documents never leave your machine — only the license check uses the internet. Intro price: $9.99/month, all 40 countries included.

Ugyanaz a könyvelő-motor fut a saját gépeden vagy szervereden. A dokumentumaid sosem hagyják el a gépedet — csak a licenc-ellenőrzés használ internetet. Bevezető ár: 9,99 $/hó, mind a 40 ország benne van.

Who is this for? Companies with strict confidentiality rules, accountants handling client data, or anyone who simply prefers full control.

Kinek való ez? Szigorú titoktartási szabályokkal működő cégeknek, ügyfél-adatokat kezelő könyvelőknek, vagy bárkinek, aki a teljes kontrollt választja.

What you need ( the shopping list )

Ami kell ( bevásárlólista )

✅ A computer that stays on while you work ( a normal office PC or laptop is fine )
✅ Docker installed ( one-click installer, see Step 2 )
✅ Your license key ( arrives by email after subscribing )
✅ Egy számítógép, ami munka közben bekapcsolva van ( egy normál irodai PC vagy laptop megfelel )
✅ Docker telepítve ( egykattintásos telepítő, lásd 2. lépés )
✅ A licenckulcsod ( feliratkozás után e-mailben érkezik )
  1. Get your license key

    Subscribe on the pricing page → Self-Hosted ($9.99/mo). Within minutes you receive an email containing your key. It looks like: aa_sk_1a2b3c…. Keep it private — it is your subscription.

  2. Szerezd meg a licenckulcsot

    Iratkozz fel az árazási oldalon → Self-Hosted ( 9,99 $/hó ). Perceken belül e-mailben megérkezik a kulcs. Valahogy így néz ki: aa_sk_1a2b3c…. Tartsd titokban — ez a feliratkozásod.

  3. Install Docker ( 5 minutes, one time )

    Docker is a free program that runs the agent safely on your machine.
    Windows/Mac: download Docker Desktop from docker.com, install, restart, done.
    Linux: run this one line in a terminal:

    curl -fsSL https://get.docker.com | sh

  4. Docker telepítése ( 5 perc, egyszer )

    A Docker egy ingyenes program, ami biztonságosan futtatja az agentet a gépeden.
    Windows/Mac: töltsd le a Docker Desktopot a docker.com-ról, telepítsd, indítsd újra a gépet, kész.
    Linux: futtasd ezt az egy sort terminálban:

    curl -fsSL https://get.docker.com | sh

  5. Create the agent's settings file

    In a new folder, create a file named config.json with exactly this content — replace aa_sk_YOUR_KEY with your real key from the email:

    {
      "license_key": "aa_sk_YOUR_KEY",
      "central_url": "https://central.ai-accountant.net",
      "data_dir": "/var/aa/data",
      "out_dir": "/var/aa/out"
    }

  6. Hozd létre az agent beállítófájlját

    Egy új mappában készíts egy config.json nevű fájlt pontosan ezzel a tartalommal — az aa_sk_YOUR_KEY helyére az e-mailből kapott valódi kulcsot írd:

    {
      "license_key": "aa_sk_A_TE_KULCSOD",
      "central_url": "https://central.ai-accountant.net",
      "data_dir": "/var/aa/data",
      "out_dir": "/var/aa/out"
    }

  7. Start the agent ( one command )

    Open a terminal ( Windows: PowerShell ) in that folder and run:

    docker run -d --name aa-agent --restart unless-stopped \
      -v $PWD/config.json:/etc/aa-agent/config.json \
      -v $PWD/data:/var/aa/data \
      -v $PWD/out:/var/aa/out \
      ghcr.io/ai-accountant/aa-agent:latest
    You will see a long ID — that means it started. It will also start automatically after reboot.

  8. Indítsd el az agentet ( egy parancs )

    Nyiss egy terminált ( Windowsen: PowerShell ) abban a mappában, és futtasd:

    docker run -d --name aa-agent --restart unless-stopped \
      -v $PWD/config.json:/etc/aa-agent/config.json \
      -v $PWD/data:/var/aa/data \
      -v $PWD/out:/var/aa/out \
      ghcr.io/ai-accountant/aa-agent:latest
    Egy hosszú azonosítót látsz — ez azt jelenti, hogy elindult. Újraindítás után magától elindul.

  9. Check it's alive ( 10 seconds )

    docker exec aa-agent wget -qO- http://127.0.0.1:8787/health
    You should see "licensed": true. Congratulations — it's running.

  10. Ellenőrizd, hogy él ( 10 másodperc )

    docker exec aa-agent wget -qO- http://127.0.0.1:8787/health
    Ezt kell látnod: "licensed": true. Gratulálunk — fut.

  11. Day-to-day use

    Drop receipts, invoices and bank CSVs into the data/ folder. Generate forms:

    curl -s http://127.0.0.1:8787/generate -H "content-type: application/json" \
      -d '{"country":"HU","year":2026,"entity_type":"sole_prop",
           "transactions":[{"date":"2026-03-01","type":"income","category":"sales","amount":1000000}]}'
    Filled PDF forms appear in the out/ folder. That's your filing package.

  12. Napi használat

    Dobd a nyugtákat, számlákat és bank-CSV-ket a data/ mappába. Űrlapok generálása:

    curl -s http://127.0.0.1:8787/generate -H "content-type: application/json" \
      -d '{"country":"HU","year":2026,"entity_type":"sole_prop",
           "transactions":[{"date":"2026-03-01","type":"income","category":"sales","amount":1000000}]}'
    A kitöltött PDF-űrlapok az out/ mappában jelennek meg. Ez a beadandó csomagod.

🔒 Privacy guarantee: raw documents never leave your machine. Only the license check and — if you use it — anonymized AI analysis use the internet. Tax numbers, IBANs, names and amounts are replaced by neutral tokens (ENT_00001…) before anything is sent. The reverse mapping exists only in data/.aa-vault.json on your machine.
🔒 Adatvédelmi garancia: a nyers dokumentumok sosem hagyják el a gépedet. Csak a licenc-ellenőrzés és — ha használod — a névtelenített AI-elemzés megy ki az internetre. Adószámok, IBAN-ok, nevek és összegek semleges tokenekre (ENT_00001…) cserélődnek, mielőtt bármi elmenne. A visszafejtési tábla kizárólag a gépeden, a data/.aa-vault.json-ban létezik.

🔧 Updates, backup, licenseFrissítés, mentés, licenc

Updating the self-hosted agent

Self-hosted agent frissítése

docker pull ghcr.io/ai-accountant/aa-agent:latest
docker rm -f aa-agent
Then run the same docker run command from Step 4 again. Your data in data/ and out/ is untouched.
docker pull ghcr.io/ai-accountant/aa-agent:latest
docker rm -f aa-agent
Majd futtasd újra ugyanazt a docker run parancsot a 4. lépésből. A data/ és out/ mappák adataid érintetlenek maradnak.

Backup — the 30-second habit

Mentés — a 30 másodperces szokás

Everything that matters lives in two folders: data/ ( your records ) and out/ ( your forms ). Copy them to an external drive or cloud folder weekly. That's your complete backup — no database, no export tool needed. In the web app, use Dashboard → Settings → Export.
Minden fontos dolog két mappában él: data/ ( a tételeid ) és out/ ( az űrlapjaid ). Másold őket hetente külső meghajtóra vagy felhőmappába. Ez a teljes mentés — nincs adatbázis, nincs exportáló eszköz. A webes appban: Dashboard → Settings → Export.

How your license works

Hogyan működik a licenced

QuestionAnswer
What does $9.99 include?All 40 countries, legal updates, PDF form engine, monthly generation quota.
What happens if I stop paying?The agent keeps your data and you can still read out/; new generation stops until renewed.
Can I move to another computer?Yes — copy data/, out/ and config.json, run the same docker command there.
Is the license per person?One license = one installation. Need more? Each seat gets its own key.
KérdésVálasz
Mit tartalmaz a 9,99 $?Mind a 40 országot, jogi frissítéseket, PDF-űrlapmotort, havi generálási keretet.
Mi történik, ha nem fizetem tovább?Az agent megtartja az adataidat, az out/ olvasható marad; az új generálás megáll a megújításig.
Átköltözhetek másik gépre?Igen — másold át a data/, out/ és config.json fájlokat, futtasd ott ugyanazt a docker-parancsot.
Személyre szól a licenc?Egy licenc = egy telepítés. Több kell? Minden helyhez külön kulcs jár.

❓ FAQ & TroubleshootingGYIK & hibaelhárítás

The agent won't start — what now?

Run docker logs aa-agent and read the last lines.
• "license invalid" → typo in config.json; copy the key again from the email ( no spaces ).
• "port already in use" → another program uses port 8787; close it or ask support.
• Docker itself not running → start Docker Desktop first ( Windows/Mac ).

Nem indul el az agent — mit tegyek?

Futtasd: docker logs aa-agent, és olvasd el az utolsó sorokat.
• „license invalid" → elírás a config.json-ban; másold ki újra a kulcsot az e-mailből ( szóköz nélkül ).
• „port already in use" → másik program használja a 8787-es portot; zárd be, vagy írj a supportnak.
• A Docker maga nem fut → indítsd el előbb a Docker Desktopot ( Windows/Mac ).

"licensed": false in the health check

The agent cannot reach the license server, or the key expired. Check internet connection, then docker restart aa-agent. Still false? Your subscription may have lapsed — see the billing email or contact support.

„licensed": false a health-ellenőrzésben

Az agent nem éri el a licencszervert, vagy lejárt a kulcs. Ellenőrizd az internetet, majd docker restart aa-agent. Még mindig false? Lehet, hogy lejárt a feliratkozásod — nézd meg a számlázási e-mailt vagy írj a supportnak.

Which version should I choose?

Not sure? Start with the web app — it's free to try and you can switch to self-hosted later with the same account. Choose self-hosted if confidentiality rules or personal preference demand it.

Melyik verziót válasszam?

Nem biztos benne? Kezdd a webes appal — ingyenes kipróbálás, és később ugyanazzal a fiókkal átválthatsz self-hostedre. Self-hostedet válassz, ha titoktartási szabály vagy személyes preferencia indokolja.

Is my accountant able to use this with me?

Yes. Business plan and above support multiple users on one company. Your accountant sees the same ledgers and forms; you keep control of permissions.

A könyvelőm is tudja vele együtt használni?

Igen. Business csomagtól felfelé egy cégre több felhasználó támogatott. A könyvelőd ugyanazokat a főkönyveket és űrlapokat látja; a jogosultságokat te szabod meg.

What about the Windows ZIP version?

A no-Docker Windows build is in final testing — it will be linked from the Getting Started page when available.

Mi a helyzet a Windows ZIP-verzióval?

A Docker nélküli Windows-build végső tesztelés alatt — elérhetővé válásakor a Getting Started oldalról linkeljük.