pyGAEB · Open Source
Die GAEB-Engine für den modernen Stack.
Eine MIT-lizenzierte Python-Bibliothek, die jede GAEB-DA-XML-Datei – jede Version, jede Austauschphase – in ein sauberes, dezimalpräzises, typisiertes Modell überführt. Parsen, prüfen, vergleichen, konvertieren, zurückschreiben. Die Engine unter DatumOS – frei nutzbar für alle.
Funktionen
Eine API für alles rund um GAEB.
Echte GAEB-Dateien sind selten sauber: gemischte Versionen, kaputte Zeichensätze, Hersteller-Eigenheiten. pyGAEB ist für die Dateien gebaut, die Sie wirklich bekommen – tolerant im Standard, strikt auf Wunsch.
Jede DA-XML-Version, jede Phase
DA XML 2.0 bis 3.3, automatisch erkannt. Vergabe (X81–X86), Nachträge (X88), Rechnungen (X89), Mengenermittlung (X31, REB), Kalkulation (X50–X52), Bestellung (X93–X97), Zeitvertragsarbeiten (X83Z/X84Z). Das ältere GAEB 90 mit festen Feldbreiten steht auf der Roadmap.
Schema-konforme Ausgabe
Geschriebene DA-XML-3.3-Dateien tragen die IDs, die Elementreihenfolge und die phasenspezifischen Profile, die die offiziellen Schemas von 2021-05 verlangen. Verifiziert gegen die BVBS-Prüfdateien für X81, X82, X83, X84 und X86.
Von Haus aus dezimalpräzise
Jeder Geld- und Mengenwert ist ein Python-Decimal – nie ein Float. Revisionssichere, gerichtsfeste Arithmetik nach GAEB-Genauigkeitsregeln und VOB-Summenkonventionen.
Tolerant gegenüber echten Dateien
Reparatur kaputter Umlaute, Wiederherstellung fehlerhaften XMLs, souveräner Umgang mit regelwidrigen Exporten gängiger AVA-Programme. Warnungen statt Abstürze.
Validierung – in und zwischen Phasen
Strukturelle, numerische und phasenspezifische Prüfungen – plus phasenübergreifende Validierung: Passt das Angebot strukturell zum LV? Stimmen die Einheitspreise der Rechnung mit dem Auftrag überein?
Vergleich mit finanzieller Auswirkung
Zwei Leistungsverzeichnisse vergleichen: jede Änderung nach Relevanz klassifiziert, hinzugefügte und verschobene Positionen erkannt, finanzielle Auswirkung berechnet. Bericht als HTML oder Excel.
Konvertieren und zurückschreiben
Jedes Dokument im Roundtrip: parsen, ändern, in jede DA-XML-Version schreiben – oder in eine andere Phase, z. B. aus einem LV (X83) ein Angebot (X84) machen. Konvertierungsberichte melden Datenverlust.
Export in alle Richtungen
Hierarchietreue Excel-Arbeitsmappen, JSON-Bäume, flaches CSV – plus CLI (pygaeb info / validate / convert / diff / export) für schnelle Pipeline-Arbeit.
Optionale LLM-Anreicherung
Positionen nach Gewerk und Elementtyp klassifizieren, auf IFC und DIN 276 abbilden, typisierte Spezifikationen extrahieren (Türbreiten, Brandschutzklassen) – mit dem LLM-Anbieter Ihrer Wahl, in der Cloud oder vollständig lokal für abgeschottete Umgebungen.
Im KI-Assistenten
Stellen Sie einer GAEB-Datei eine Frage.
pyGAEB bringt einen Model-Context-Protocol-Server (MCP) mit. Richten Sie Claude Desktop, Claude Code, Cursor, Codex CLI, Gemini CLI oder VS Code Copilot auf einen Ordner mit Ausschreibungen und fragen Sie in natürlicher Sprache: Wie hoch ist die Summe, welche zehn Positionen treiben die Kosten, was hat sich seit letzter Woche geändert, wie vergleichen sich drei Angebote. Der Server läuft lokal, ruft selbst kein Modell auf und liefert kleine, paginierte Antworten – so passt ein LV mit 5.000 Positionen ins Kontextfenster.
ChatGPT und die Gemini-App verbinden sich nur mit entfernten MCP-Servern über HTTPS – sie brauchen den Streamable-HTTP-Transport hinter einem Tunnel statt eines lokalen Prozesses.
Anleitung zum MCP-Server →Im Vergleich
Open Source, offline, Python-nativ.
Die etablierte Alternative für Entwickler ist ein kommerzieller GAEB-Webservice mit generierten Clients in vielen Sprachen. pyGAEB geht den anderen Weg: Die Engine ist eine Bibliothek, die Sie installieren, lesen und offline betreiben – ohne Gebühr pro Aufruf, ohne dass Daten Ihren Rechner verlassen. Die DA-XML-3.3-Ausgabe validiert gegen die offiziellen Schemas, und Fehler aus echten LV-Dateien werden in der Regel innerhalb von Tagen behoben. Was der kommerzielle Dienst heute noch besser kann: GAEB 90 mit festen Feldbreiten lesen und Client-Bibliotheken jenseits von Python.
Warum Open Source
Die Schicht, die Ihr Angebot summiert, darf keine Blackbox sein.
Kaufmännische Baudaten sind Vertragsdaten. Die Schicht, die sie parst, prüft und summiert, muss überprüfbar sein – von Ihren Entwicklern, Ihren Prüfern und der Branche. Deshalb ist die DatumOS-Engine Open Source unter MIT-Lizenz: jede Zeile lesbar, erweiterbar, einbettbar, komplett offline betreibbar. Unser kommerzielles Produkt baut auf derselben Engine auf, die wir veröffentlichen – und sie entsteht öffentlich, wo Issues aus echten GAEB-Dateien jedes Release prägen.
„Thanks for publishing this great library. It has saved me a lot of work and handles the GAEB format really well.“
„In Python ist pyGAEB die übliche Library; sie frisst sowohl d- als auch x-Formate.“
Python 3.10+ · typisierte API · Async-Unterstützung · optionale Extras für CLI, Excel, MCP und LLM-Klassifikation.
FAQ
Häufige Fragen zu pyGAEB.
Was ist pyGAEB?
pyGAEB ist eine Open-Source-Python-Bibliothek, die GAEB-DA-XML-Dateien – jede Version und Austauschphase – parst, prüft, vergleicht, konvertiert und zurückschreibt, in ein sauberes, dezimalpräzises, typisiertes Modell.
Welche GAEB-Versionen und -Phasen werden unterstützt?
DA XML 2.0 bis 3.3 (automatisch erkannt), über Vergabe (X81–X86), Nachträge (X88), Rechnungen (X89), Mengenermittlung (X31/REB), Kalkulation (X50–X52) und Bestellung (X93–X97). GAEB 90 mit festen Feldbreiten ist geplant.
Bestehen von pyGAEB geschriebene Dateien die offiziellen GAEB-Prüfungen?
Die DA-XML-3.3-Ausgabe für X81, X82, X83, X84 und X86 validiert gegen die offiziellen GAEB-Schemas von 2021-05 und besteht die BVBS-Prüfdateien. Eine formale BVBS-Zertifizierung gilt für Softwareprodukte, nicht für Bibliotheken; DatumOS strebt sie für die Plattform an.
Ist es wirklich kostenlos, auch kommerziell?
Ja. pyGAEB ist MIT-lizenziert – frei lesbar, erweiterbar, einbettbar und kommerziell nutzbar, ohne Nutzungsgebühren.
Kann es aus einem LV (X83) ein Angebot (X84) machen oder zwischen Versionen konvertieren?
Ja. Dokumente lassen sich im Roundtrip verarbeiten – parsen, ändern und in jede DA-XML-Version oder eine andere Phase schreiben – und Konvertierungsberichte melden jeden Datenverlust.
Braucht es eine Internetverbindung oder ein LLM?
Nein. Parsen, Validierung und Schreiben sind vollständig deterministisch und laufen offline. Die optionale LLM-Klassifikation ist separat und kann für abgeschottete Umgebungen auf einem lokalen Modell laufen.
Wie installiere ich es?
pip install pyGAEB (Python 3.10+). Optionale Extras ergänzen CLI, Excel-Export, den MCP-Server und LLM-Klassifikation.