Skip to content

curiousmarkus/euer

Repository files navigation

euer Logo

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:

# pipx einmalig installieren (falls noch nicht vorhanden)
brew install pipx

# euer 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 euercli

(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:


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

About

Dein KI-Agent erledigt EÜR und UStVA: euer ist die lokale, revisionssichere CLI-Buchhaltung für Freelancer und Kleinunternehmer in Deutschland.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages