Skip to content
joschi655Public

About

Open Source tool to help with EEG

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

EEGbot

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.

Du möchtest erst einmal Orientierung — ohne Installation?

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.

Installation mit einem Satz (Codex oder Claude Code)

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.

Warum das kein „Chatbot über Gesetze" ist

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_ERFORDERLICH ausgewiesen (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

Quickstart

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 freigeben

Dann 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-Delta

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

Deine Unterlagen als Wissensquelle

Leg deinen kompletten Papierkram in einen Ordner (dokumente/) — Einspeisezusage, MaStR-Bestätigung, Angebote, Datenblätter, Dachpläne, Zählerschrank-Fotos:

bun run ingest:dokumente

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

Architektur (Kurzfassung)

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.

Rechtlicher Rahmen (wichtig)

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.

Qualitätssicherung

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

Datenquellen & Lizenzen

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.

Roadmap

  • 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

Web-App (fink)

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

Mitmachen

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.

About

Open Source tool to help with EEG

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages