EÜR-Buchhaltung für KI-Agenten

euer ist die Lösung für Freelancer und Kleinunternehmer in Deutschland, die ihre Einnahmenüberschussrechnung (EÜR) an ihre KI-Agenten auslagern möchten.

Warum euer?

Die meisten Tools zwingen dich zu einer Entscheidung: Entweder du nutzt unflexible SaaS-Abos (Lexoffice, SevDesk) oder du bastelst manuell in Excel. euer geht einen dritten Weg: Ein Tool, damit dein Agent die Arbeit übernehmen kann.

🤖 Built for AI Agents (Claude Code, Hermes, OpenCode, Codex, etc.)

• Structured CLI interface: Deterministischer Text rein, strukturierter Output raus. Perfekt für Tool-Calling lokaler Coding-Agenten (euer add expense, euer summary).
• Zero bloat: Schlanke EÜR nach Zufluss-/Abfluss-Prinzip (§ 11 EStG) ohne doppelte Buchführung, Kontenrahmenzwang oder Bilanzierungs-Overhead.
• SQL Superpowers: Für komplexe Auswertungen kann der Agent direkt auf die lokale SQLite-Datenbank zugreifen. Volle Flexibilität für intelligente Automatisierung.

🔒 Nachvollziehbar & Lokal

• Local First: Eine SQLite-Datei. Deine Daten. Dein Backup. Volle Datenhoheit ohne Cloud-Zwang.
• Audit-Trail: Jede Buchung und Änderung über die CLI wird in einer Historie protokolliert (euer audit). Volle Transparenz darüber, was dein Agent getan hat.
• Leichtgewichtig: Nur Python 3.11+. Keine schweren Abhängigkeiten. Läuft überall.
• Kein Lock-in: Daten einfach in CSV oder Excel exportieren.

✅ Alles, was du steuerlich brauchst

• EÜR-konforme Kategorien: Direkt einsatzbereit mit geprüften, jahresabhängigen Zuordnungen zu Formularfeldern unterstützter Anlagen EÜR.
• Optionaler Kontenrahmen: Frei konfigurierbare Buchungskonten ([[ledger_accounts]]) mit automatischer Kategoriezuordnung.
• Umsatzsteuer-Logik: Voller Support für Regelbesteuerung (USt/Vorsteuer) sowie Kleinunternehmerregelung (§19 UStG).
• Reverse-Charge Support: Umsatzsteuerliche Behandlung von Dienstleistern aus dem EU-/Drittland-Ausland (§13b UStG) inklusive persistiertem RC-Typ.
• UStVA-Report: euer vat-report erzeugt einen ELSTER-nahen USt-Voranmeldungs-Arbeitsbericht mit KZ-Mapping, Warnungen und CSV/XLSX-Export.
• Beleg-Management: Verknüpfe digitale Belege (PDF/Bilder) direkt mit deinen Buchungen.

Quickstart: In 2 Minuten startklar

1. Installation

pipx installiert euer global, ohne dass du je eine virtuelle Umgebung aktivieren musst.

macOS und Linux (Homebrew):

brew install curiousmarkus/euer/euer

Alle Plattformen (PyPI):

# pipx einmalig installieren (falls noch nicht vorhanden)
python3 -m pip install --user pipx
pipx ensurepath

pipx install euer

Für den optionalen Excel-Export installierst du direkt das XLSX-Extra:

pipx install "euer[xlsx]"

Unter Windows kannst du stattdessen py -m pip install --user pipx und danach pipx ensurepath verwenden. Die Paketinstallation bleibt identisch.

GitHub-Fallback:

Für Entwicklungsversionen oder einen Checkout ohne PyPI kannst du weiterhin direkt aus dem Repository installieren:

pipx install git+https://github.com/curiousmarkus/euer.git

Danach ist euer sofort und dauerhaft in jedem Terminal verfügbar.

Update auf die neueste Version:

pipx upgrade euer

Bei einer Homebrew-Installation aktualisierst du mit:

brew upgrade euer

Entwicklungsinstallation unter Windows (PowerShell):

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev,xlsx]"
python -m unittest discover -s tests

(Details siehe User Guide)

2. Personalisierung

Richte den vollständigen Skill-Ordner euer-buchhaltung inklusive references/ in deiner KI-Anwendung ein. Starte deinen Agenten im Buchhaltungsordner und sage: „Richte meine Buchhaltung mit euer ein.“ Der Agent prüft vorhandene Angaben, führt bei Bedarf das Onboarding durch und legt dein persönliches Mandanten-Dossier (AGENTS.md) sowie die Konfiguration an.

Alternativ kannst du den Onboarding-Prompt in einem separaten LLM-Chat verwenden.

3. Initialisierung

Falls noch nicht durch den Agenten erledigt: Wechsle in deinen Buchhaltungsordner und initialisiere Datenbank und Konfiguration:

euer init
euer setup

4. Erste Buchung (lass es deinen AI-Agent machen!)

euer add expense --payment-date 2026-02-02 --vendor "Hetzner" --category "Laufende EDV-Kosten" --amount -10.00

# Optional mit Kontenrahmen:
euer add expense --payment-date 2026-02-02 --vendor "Hetzner" --ledger-account hosting --amount -10.00

So arbeitet dein AI-Agent mit euer

Du hast einen Stapel PDF Belege? Gib es an deinen KI-Agenten:

"Buche diese Belege in euer ein."

1. Der Agent holt sich die korrekten Steuerkategorien mit euer list categories
2. Prüft optional den Kontenrahmen mit euer list ledger-accounts
3. Fügt die Belege in die EÜR mit euer add expense --payment-date ... --vendor ...
4. kontrolliert die Vollständigkeit mit euer incomplete list
5. gibt dir eine Übersicht über deine EÜR mit euer summary --year 2026
6. erstellt bei Bedarf einen UStVA-Arbeitsbericht mit euer vat-report --year 2026

Ergebnis: Du kannst dich zurücklehnen — dein Agent übernimmt für dich die Buchhaltung!

Dokumentation & Support

Detaillierte Anleitungen findest du in unseren Guides:

• 🧭 User Journey – Von Installation und Onboarding über den Monatsabgleich bis zur EÜR, mit Ablaufdiagramm.
• 📖 User Guide – Installation, Workflows und alle Befehle.
• ❓ FAQ – Häufige Fragen, Sonderfälle (z. B. Prepaid-Guthaben) und Best Practices.
• 🧾 Release Notes – Upgrade-Hinweise für bestehende lokale Instanzen.
• 🤖 SKILL "euer-buchhaltung" – Die Anleitung für deinen Agenten
• 🤖 Agent Templates – Konfigurationsvorlagen für KI-Buchhalter
• 🤝 Mitwirken – Hinweise für Issues, Änderungen und Pull Requests.
• 🛠️ Development – Architektur und technische Entwicklungsregeln.

📄 Lizenz

GNU AGPLv3 License Copyright (c) 2026 Markus

Hinweis zur AGPL: Diese Software ist frei verfügbar. Wenn du sie jedoch modifizierst und über ein Netzwerk (z.B. als Web-Service oder SaaS) anbietest, bist du verpflichtet, den vollständigen Quellcode deiner Version ebenfalls unter der AGPL offenzulegen. Dies stellt sicher, dass euer ein Gemeinschaftsprojekt bleibt und nicht proprietär vereinnahmt wird.

Entwickelt für AI-Agents, die sich täglich freuen deine Buchhaltung zu übernehmen – CLI basiert, lokal und einfach.