Metadata-Version: 2.4
Name: euer
Version: 0.9.0
Summary: EÜR (Einnahmenüberschussrechnung) CLI
Author: Markus
License-Expression: AGPL-3.0-or-later
Project-URL: Issues, https://github.com/curiousmarkus/euer/issues
Project-URL: Repository, https://github.com/curiousmarkus/euer
Project-URL: Documentation, https://github.com/curiousmarkus/euer/blob/main/docs/USER_GUIDE.md
Project-URL: Changelog, https://github.com/curiousmarkus/euer/blob/main/docs/RELEASE_NOTES.md
Keywords: buchhaltung,euer,finanzen,freelancer,sqlite
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Office/Business :: Financial :: Accounting
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: xlsx
Requires-Dist: openpyxl>=3.1.0; extra == "xlsx"
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: coverage>=7.10; extra == "dev"
Requires-Dist: ruff>=0.8; extra == "dev"
Requires-Dist: twine>=6.1; extra == "dev"
Dynamic: license-file

![euer Logo](https://raw.githubusercontent.com/curiousmarkus/euer/main/euer_logo.png)

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

### 🔒 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 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):**

```bash
brew install curiousmarkus/euer/euer
```

**Alle Plattformen (PyPI):**

```bash
# 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:

```powershell
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:

```bash
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:**
```bash
pipx upgrade euer
```

Bei einer Homebrew-Installation aktualisierst du mit:

```bash
brew upgrade euer
```

**Entwicklungsinstallation unter Windows (PowerShell):**

```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](https://github.com/curiousmarkus/euer/blob/main/docs/USER_GUIDE.md#installation))

### 2. Personalisierung

Richte den vollständigen [Skill-Ordner `euer-buchhaltung`](docs/skills/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](docs/templates/onboarding-prompt.md)
in einem separaten LLM-Chat verwenden.

### 3. Initialisierung
Falls noch nicht durch den Agenten erledigt: Wechsle in deinen Buchhaltungsordner
und initialisiere Datenbank und Konfiguration:
```bash
euer init
euer setup
```

### 4. Erste Buchung (lass es deinen AI-Agent machen!)
```bash
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](docs/USER_JOURNEY.md)** – Von Installation und Onboarding über den Monatsabgleich bis zur EÜR, mit Ablaufdiagramm.
- 📖 **[User Guide](https://github.com/curiousmarkus/euer/blob/main/docs/USER_GUIDE.md)** – Installation, Workflows und alle Befehle.
- ❓ **[FAQ](https://github.com/curiousmarkus/euer/blob/main/docs/FAQ.md)** – Häufige Fragen, Sonderfälle (z. B. Prepaid-Guthaben) und Best Practices.
- 🧾 **[Release Notes](https://github.com/curiousmarkus/euer/blob/main/docs/RELEASE_NOTES.md)** – Upgrade-Hinweise für bestehende lokale Instanzen.
- 🤖 **[SKILL "euer-buchhaltung"](https://github.com/curiousmarkus/euer/blob/main/docs/skills/euer-buchhaltung/SKILL.md)** – Die Anleitung für deinen Agenten
- 🤖 **[Agent Templates](https://github.com/curiousmarkus/euer/tree/main/docs/templates)** – Konfigurationsvorlagen für KI-Buchhalter
- 🤝 **[Mitwirken](https://github.com/curiousmarkus/euer/blob/main/CONTRIBUTING.md)** – Hinweise für Issues, Änderungen und Pull Requests.
- 🛠️ **[Development](https://github.com/curiousmarkus/euer/blob/main/DEVELOPMENT.md)** – 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.*
