Ein Open-Source-Claude-Code-Framework für deutsches Energierecht. Geführte Workflows für Balkonkraftwerk, PV-Dachanlage, Wärmepumpen-Förderung und ausgeförderte Ü20-Anlagen — gebaut auf deterministischen Rechnern, einem temporalen Normgraphen über alle EEG-Fassungen seit 2020 und harten RDG-Guardrails.
Du bringst deinen eigenen Claude mit (Claude Code), das Framework bringt das Energierechts-Wissen, die Rechner und die Leitplanken.
Vision: EEGbot macht Energierecht ausführbar.
Balkonsolar-Vorabcheck im Browser — kostenlos, ohne Anmeldung und ohne Installation: Montageplatz klären, hypothetische Wirtschaftlichkeit rechnen, Ratgeber und Checklisten für PV-Dach, Wärmepumpe und Wallbox lesen. Kein Konto, keine Analyse, kein KI-Aufruf.
Die bestehende Web-App mit den deterministischen Rechnern läuft unter eegbot.aiwerke.de/app/. Der KI-Pilot für persönlich eingeladene Tester liegt unter eegbot.aiwerke.de/pilot/ (persönlicher Code erforderlich, 20 Aufrufe je Einladung, nur Freitext).
- Zuerst geeignete gesicherte Montagefläche prüfen. Nein/unklar bedeutet STOP; eine Fenstertür allein reicht nicht. Ein separater synthetischer Demo-Modus erlaubt Lernen.
- Der Browserrechner verwendet explizite Annahmen, keine Förder-/Vergütungssätze, kein LLM, keine Uploads, keine Anmeldung. Ergebnis ist keine Kaufempfehlung.
- Die Checklisten sind Orientierung, keine automatische Förderberatung oder Fachplanung.
| Weg | Voraussetzung | Umfang und Grenze |
|---|---|---|
| Statische Browserseite | Nur Browser; nach Veröffentlichung direkt nutzbar | Szenario-Rechner, Ratgeber; kein Backend. Eingaben bleiben im Browser, Hosting sieht technische Zugriffsdaten. |
| Lokale Web-App | Bun, Repository; für Wissensfunktionen bun run setup |
HOST=127.0.0.1 bun ui/server.ts → http://localhost:3475/app/; bestehende Engines. Optionale KI-Vorbefüllung braucht API-Zugang, kann Kosten verursachen und verlangt Übertragungszustimmung. |
| Claude-Code-Framework | Bun, Repository, eigener Claude-Code-/Modellzugang | Geführte Workflows und Dokumente. Code MIT; Modell-/Zugangskosten separat. Gelesene Auszüge/Bilder gelangen zum Anbieter. Kein hier angebotener installierbarer Plugin-Weg. |
Für einen synthetischen ersten Test reicht die Demo auf der Browserseite.
Technische lokale Vorschau: bun install && bun run preview:site, dann
http://127.0.0.1:4178/EEGbot/. Keine KI-/API-Einrichtung nötig.
Die vorhandenen Framework-Installationsschritte folgen unverändert unten.
Was kann ich testen? · Sicheres Pages-Deployment ausschließlich aus site/ · Mitmachen · Anonymisiertes Feedback
Bitte keine personenbezogenen Dokumente, Rechnungen oder Angebote in öffentliche Issues. Keine durch diesen Einstieg belegte Praxiserprobung oder Produktionsreife.
Kopiere diesen Auftrag in deinen Coding-Assistenten:
Installiere https://github.com/joschi655/EEGbot in einem neuen lokalen Ordner, prüfe die Voraussetzungen, führe das dokumentierte Setup und die Tests aus und starte anschließend die lokale Web-App; frage vor nötigen Systemänderungen nach und verwende zunächst nur die mitgelieferten Beispieldaten.
Codex kann Setup und Web-App bedienen. Die projektspezifischen Claude-Code-Skills, MCP-Freigaben und Hooks werden dadurch nicht automatisch in Codex aktiviert. Modellzugangskosten können anfallen; keine API-Schlüssel in den Prompt schreiben. Bereits vorhandene Projektordner nicht überschreiben.
Bereits ohne Installation erreichbar: öffentliche Rechner-Demo. Dort zunächst die Beispielanlage laden. KI-Vorbefüllung ist deaktiviert; Quellen-/Datenstand beachten, keine fachliche Freigabe durch diesen Link.
Sprachmodelle raten Vergütungssätze, verwechseln EEG-Fassungen und übersehen Fristen. EEGbot dreht das um — deterministisch, wo das Recht eindeutig ist; agentisch nur, wo Auslegung oder Nutzerführung gebraucht wird:
- §52 Liability Radar — Strafzahlungs-Exposure (10 €/kW/Monat) mit Heilungs- ersparnis, Verjährung (§ 52 Abs. 6) und Kappung (Abs. 5) als nachrechenbare Engine
- Temporaler Normgraph — EEG & EnWG in 6 Fassungsständen (SQLite, 1.300+ Norm-Expressions, 10.000+ Querverweise); jede Antwort zitiert Norm und Fassung
- §100-Übergangsrechts-Resolver — die Versteinerungs-Kaskade (BGH XIII ZR 3/24) als deterministisches Primitiv: IBN-Datum rein, anwendbare Fassung + Normenkette raus
- §24-Entscheidungsbaum — deterministische Prüfschritte; der unbestimmte
Rechtsbegriff „unmittelbare räumliche Nähe" wird ehrlich als
LLM_SUBSUMTION_ERFORDERLICHausgewiesen (mit BGH-XIII-ZR-12/19-Pflichtkontext) - Solarspitzen-Check — 60-%-Wirkleistungsgrenze, Steuertechnik und Negativpreisfolge nach §§ 9, 51, 51a EEG einschließlich Übergangsrecht und bewusstem Altregime-Gate statt pauschaler Bestandsanlagen-Antwort
- Förder-Matcher — KfW 458/270, BAFA BEG EM, § 35c EStG als maschinenlesbare Schemas mit Boni-Logik und Kumulierungs-Matrix
- Formularinventar — MaStR-Felder, Veräußerungsform-Meldung, WEG-Zustimmung inkl. der dokumentierten Fehlerfallen (IBN ≠ Zählersetzung; die 0-€-Falle)
- RDG-Ampel — deterministischer Guardrail-Hook: Prozessstrategie, Steuer- gestaltung und Vertragsentwurf werden geblockt und auf Clearingstelle/Anwalt/ Steuerberater eskaliert
git clone https://github.com/joschi655/EEGbot && cd EEGbot
bun run setup # installiert, validiert, baut Normgraph + Suchindex (~2–5 Min)
claude # Projekt vertrauen und die 5 MCPs beim ersten Start einmalig freigebenDann einfach fragen: „Ich habe ein Balkonkraftwerk gekauft, was muss ich tun?" — der Intake-Skill strukturiert den Fall und führt durch den Workflow.
Sofort ausprobieren (mit synthetischen Beispiel-Unterlagen):
cp docs/beispiel-unterlagen/*.md dokumente/ && bun run ingest:dokumente
claude # dann: „Wir wollen eine Wärmepumpe — meine Unterlagen liegen in dokumente/"Claude liest Angebot + Typenschild, füllt den Fall mit belegten Werten, ruft den
deterministischen foerderfahrplan auf und fragt nur nach, was in den Unterlagen
fehlt (im Beispiel: das Haushaltseinkommen für den +30-%-Bonus).
Rückforderungs-Check (BGH-Zwillingsfall): In
docs/beispiel-unterlagen-rueckforderung/ liegt ein synthetischer Fall nach dem
Muster von BGH VIII ZR 147/16 — der Netzbetreiber fordert 45.540 € nach § 52 EEG,
der §52-Radar rechnet Heilung (rückwirkend 2 €/kW) und Verjährung (§ 52 Abs. 6)
nach und kommt auf 6.417 €. Einspielen wie oben, dann: „Prüf die Unterlagen in
dokumente/ — stimmt die Forderung?"
EEG-2027-Zeitmaschine (Entwurfsrecht, klar markiert):
bun run build:eeg2027 # legt den RefE 21.04.2026 als ENTWURFS-Fassung in den Normgraph
bun run demo:zeitmaschine # gleiche Anlage, IBN 15.12.2026 vs. 15.01.2027 — Diff + Euro-DeltaStichtags-Abfragen ab dem 01.01.2027 zeigen den Entwurf (Titel + Text tragen
ENTWURF-Marker), Abfragen für heute weiterhin ausschließlich geltendes Recht.
Voraussetzungen: bun, Claude Code. Kein API-Key für die Wissensbasis nötig — alle Quellen sind offene Daten. Ausführliche Anleitung: docs/user-guide.md.
Leg deinen kompletten Papierkram in einen Ordner (dokumente/) —
Einspeisezusage, MaStR-Bestätigung, Angebote, Datenblätter, Dachpläne,
Zählerschrank-Fotos:
bun run ingest:dokumentePDF-Text wird extrahiert, Scans und Fotos werden per OCR (tesseract.js, deutsch) durchsuchbar, Pläne und Fotos liest Claude zusätzlich im Original (Vision). Ingestion, Originaldateien, Extrakte und Indizes liegen lokal und bleiben gitignored. Sobald Claude Code einen Treffer, Volltext oder ein Bild liest, wird der ausgewählte Inhalt jedoch Teil des Modellkontexts und an deinen konfigurierten Modellanbieter übertragen. Deshalb sucht EEGbot zuerst in kleinen Ausschnitten und liest Volltexte nur bei Bedarf. Die Web-App verwendet einen getrennten Consent-Flow: Vorschau der vollständigen Übertragung, Empfänger und Zweck, danach ausdrückliche Einwilligung für die Anthropic API.
Optionale Wissensquellen (je ein Befehl, lokal gebaut): Clearingstelle-FAQ +
Voten (ingest:clearingstelle), BGH-Rechtsprechung (ingest:rechtsprechung),
BNetzA-Gebotstermine (ingest:ausschreibungen), Marktwerte (ingest:markt).
Claude Code (Runtime)
├─ Skills Intake → Workflow-Runner (interpretiert data/workflows/*.yaml)
│ + Compliance, Dokumente, Recherche, Update
├─ Agenten 7 Spezialisten; erben die Tools/MCPs der Hauptsession
├─ Hooks RDG-Prompt-Ampel + Output-Stop-Prüfung · Freshness
└─ MCP-Server eeg-wissen Normgraph, §100-Resolver, Norm-/Clearingstelle-/
Rechtsprechungs-Suche
eeg-rechner §52, Vergütung, §24, Fristen, Schwellen, Solarspitzen, Ü20
eeg-foerder Programme, Kumulierung, Formularinventar
eeg-daten MaStR-Suche, Marktwerte, DIP, Gebotstermine
eeg-dokumente DEINE Unterlagen: Suche, Volltext, Pläne/Fotos
data/ Geschäftslogik als DATEN (zod-validiert): Programme, Workflows,
Formulare, Guardrail-Policy, datierte Parameter (OpenFisca-Pattern)
rules/ Catala-Spezifikationen (Gesetz-als-Code, Verifikations-Schicht)
knowledge/ generiert: Normgraph (SQLite) + BM25-Index — lokal gebaut
Details: docs/architektur.md. Vier Workflows sind die Referenz-Testfälle — das System ist generisch: neuer Fall-Typ = neue YAML-Datei.
EEGbot liefert allgemeine Rechtsinformationen und deterministische
Berechnungen nach veröffentlichten Werten — keine Rechtsberatung im Einzelfall
(§ 2 RDG), keine Steuerberatung (StBerG). Du betreibst das Tool selbst, lokal,
mit deinem eigenen Modell-Zugang. Die Guardrail-Policy
(data/guardrails/policy.yaml) erzwingt diese Grenze technisch: streitige
Einzelfälle werden an die Clearingstelle EEG|KWKG (kostenfreie
Erstbearbeitung, kein Anwaltszwang), Fachanwälte oder Steuerberater eskaliert —
inklusive automatisch erstelltem Übergabe-Paket.
Keine Gewähr für Richtigkeit oder Aktualität. Gesetze ändern sich mehrmals
jährlich; der Freshness-Hook warnt bei veralteter Wissensbasis, bun run changefeed überwacht BGBl, QuantLaw-Delta und Bundestags-Vorhaben.
# Voraussetzung: bun run setup (Graph-Tests lesen die lokal gebaute Wissensbasis)
bun test # 150 Tests: Normgraph, Engines, Contracts, Profile (BGH-/Clearingstelle-Fixtures)
bun run evals # EEG-Benchmark: 20 deterministische + 4 interpretative Fragen
bun run validate:data # Schema- + Konsistenz-Gate für alle data/-Artefakte
bun run crosscheck:catala # Catala-Spezifikation ⇄ TS-Engine (12 Szenarien; Catala via opam, sonst nur TS-Seite)Der EEG-Benchmark (evals/benchmark/fragen.yaml) ist unseres Wissens der
erste öffentliche Benchmark für mehrfassungs-EEG-Compliance — Beiträge (Ziel: 50+
Fragen) ausdrücklich willkommen.
| Quelle | Nutzung | Lizenz |
|---|---|---|
| gesetze-im-internet.de via QuantLaw-Archiv | Normtexte, Versionshistorie | amtliche Werke (§ 5 UrhG) |
| MaStR | Anlagendaten | DL-DE-BY-2.0 (© Bundesnetzagentur) |
| DIP Bundestag | Gesetzesvorhaben | offene Parlamentsdaten |
| Open Legal Data | BGH-/EEG-Rechtsprechung | amtliche Werke (§ 5 UrhG), API CC |
| Clearingstelle EEG|KWKG, KfW, BAFA, BDEW | FAQ/Voten werden nur lokal indexiert (ingest:clearingstelle) |
nicht redistribuiert — das Repo shipped Scraper, keine Korpora |
Code: MIT. Generierte Wissensbasis (knowledge/) wird lokal gebaut
und nicht eingecheckt.
- Historische Vergütungssätze (EEG 2000–2014) als Parameter — dann rechnet der Ü20-Pfad auch Alt-Vergütungen nach
- Hybrid-Retrieval: Vektor-Reranking (jina-embeddings-v2-base-de) über dem BM25-Index
- Catala-Kompilierung in CI (Spezifikation → ausführbare Verifikation)
- Neuro-symbolische Rückverifikation von LLM-Subsumtionen
- NeuRIS-API-Anbindung, sobald produktionsreif (ELI-kompatible IDs sind vorbereitet)
- Claude-Code-Plugin als späterer Distributionskanal; v0.x bleibt bewusst ein eigenständiges Projekt-Repository mit lokaler Wissensbasis und Dokumentordner
- B2B-Ausbau (gehostet, Agent-SDK): Kanzlei-Dashboards, Portfolio-§52-Batch für
Stadtwerke, Kundenanlage-Migrations-Assessments — auf denselben
data/-Schemas
bun ui/server.ts startet die fink-Web-App (Design-System in ui/fink/) samt
REST-API auf http://localhost:3475 — die /api/*-Endpunkte rufen dieselben
Engine-Funktionen wie die MCP-Server auf (Normsuche, §100-Resolver,
Querverweis-Kaskade, Förder-Matcher, Förderfahrplan). Nichts ist gemockt.
Hinweis: die Gilmer-Fonts sind kommerziell lizenziert und nicht im Repo
(ui/fink/assets/fonts/README.md).
Weniger tippen — KI-Vorbefüllung: Der Fahrplan-Screen kann die Fall-Felder
automatisch aus deinen Unterlagen (dokumente/ + bun run ingest:dokumente)
und einem Freitext-Satz vorbefüllen (POST /api/intake). Vorher zeigt
POST /api/intake/vorschau die vollständig übertragenen Inhalte, den Empfänger
und den Zweck; der eigentliche Aufruf verlangt eine ausdrückliche Einwilligung.
Die KI schlägt nur belegte Werte vor (Quelle + wörtliches Zitat, sonst
verworfen), du prüfst, die deterministische Engine rechnet. Dafür wird ein Anthropic-API-Key benötigt
(ANTHROPIC_API_KEY in .env); ohne Key funktioniert alles Übrige unverändert —
in Claude Code liest Claude die Unterlagen ohnehin direkt (Skill „Unterlagen").
Der wertvollste Beitrag ist Daten-Kuratierung: Parameter verifizieren
(ZU VERIFIZIEREN-Hinweise), Förderprogramme ergänzen, Benchmark-Fragen mit
Quellen einreichen, Workflows für neue Fall-Typen schreiben. Jede Daten-Änderung
braucht eine Quelle und muss bun run validate:data bestehen.
Ohne Git-Kenntnisse: Dateien in docs/ und data/ lassen sich direkt im
GitHub-Web-Editor bearbeiten (Datei öffnen → Stift-Symbol → „Propose changes"
erzeugt einen Pull Request). Format je Fundstelle: Aussage · Quelle · Fundstelle
· Abrufdatum.