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, not humans

• CLI first: Perfekt für LLMs – Text Input, strukturierter Text Output. Kein Halluzinieren von GUI-Klicks.
• Do one thing well: Kein Feature-Bloat. Nur EÜR. Agenten lieben Tools mit klarem Scope.
• SQL Superpowers: Für komplexe Abfragen kann der Agent direkt SQL nutzen. Volle Flexibilität für intelligente Automatisierung.

🔒 Revisionssicher & Lokal

• Local First: Eine SQLite-Datei. Deine Daten. Dein Backup. Deine Kontrolle.
• Audit-Log: Jede Änderung wird unveränderbar protokolliert. Sicherheit für dich und das Finanzamt.
• 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 den offiziellen Zeilennummern für die Anlage 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/tap/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

Kopiere den Onboarding Prompt in einen LLM-Chat und beantworte die Fragen. Du erhältst eine personalisierte AGENTS.md mit dem nötigen Kontext für deine KI-Agenten sowie die konkreten nächsten Schritte, um loszulegen.

3. Initialisierung

Wechsle (wie beim Onboarding erklärt) in deinen Buchhaltungs-Ordner und erstelle deine Datenbank:

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 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.