IRS veröffentlicht Fact Graph als Open Source

• Die US-Bundessteuerbehörde IRS hat einen Wissensgraphen namens Fact Graph als Open Source veröffentlicht.
• Fact Graph wird zur Modellierung des US-Steuerrechts und verwandter Gesetze verwendet und kann sowohl in JVM- als auch in JavaScript-Umgebungen eingesetzt werden.
• Der Quellcode des Projekts wird regelmäßig aktualisiert; entwickelt wird in einem privaten Repository, aus dem freigegebene Änderungen in Echtzeit übernommen werden.
• Fact Graph wird auf Grundlage verschiedener Rechtsgrundlagen und der Open-Source-Richtlinien des Bundes entwickelt und veröffentlicht.
• Nutzer tragen die volle Verantwortung für die Nutzung und Änderung der Software; die IRS bietet keine gesonderte Garantie oder Unterstützung.

---

Bedeutung und Vorteile der Open-Source-Veröffentlichung

• Dass die IRS das Fact-Graph-Projekt als Open Source bereitstellt, ist ein bedeutender Schritt in einer Entwicklung hin zu mehr Transparenz und Wiederverwendbarkeit von Regierungsdaten und Rechtsinformationen.
• Anders als viele allgemeine Wissensgraph-Projekte ist es als hochwertige, produktionsreife Struktur speziell für das US-Steuerrecht und bundesrechtliche Regelungen konzipiert, was den praktischen Nutzen und die Verlässlichkeit in diesem Bereich erhöht.
• Durch die Unterstützung von JavaScript sowie der JVM-Sprachenfamilie (z. B. Java, Kotlin, Scala, Clojure) bietet es breite Kompatibilität mit unterschiedlichen Tech-Stacks.
• Dank häufiger Repository-Updates und eines Systems zur Echtzeit-Übernahme von Änderungen bleibt das Projekt aktuell.
• Durch die klare Beachtung rechtlicher Grundlagen und von Open-Source-Richtlinien entsteht eine verlässliche Basis für die Nutzung durch öffentliche Einrichtungen, Unternehmen und Einzelpersonen.

Projektüberblick

• Fact Graph ist ein Wissensgraph, der direkt in Produktionsumgebungen einsetzbar ist, und dient in erster Linie der Modellierung des US-Bundessteuerrechts (Internal Revenue Code) sowie verwandter Steuergesetze.
• Er kann nicht nur in JavaScript, sondern auch in allen JVM-basierten Sprachen (Java, Kotlin, Scala, Clojure usw.) genutzt werden und lässt sich in unterschiedliche Plattformen und Entwicklungsumgebungen integrieren.

Nutzung des Repositorys und Mitwirkung an der Entwicklung

• Informationen zur Entwicklungsumgebung und zum Setup finden sich in ONBOARDING.md.
• Welche Verbesserungen die neueste Version (v3.1) gegenüber früheren Versionen bietet, wird in separaten Dokumenten und Links erläutert.
• Vorgehensweisen und Richtlinien für Open-Source-Beiträge sind ausführlich in CONTRIBUTING.md beschrieben.

Wichtige Merkmale

• Der Quellcode des Projekts wird regelmäßig aktualisiert. Die eigentliche Entwicklung findet in einem privaten Repository statt; nach Prüfung werden nur freigegebene Änderungen in Echtzeit in dieses Repository (main-Branch) gemergt.
• In der Dokumentation werden ScalaTest (Test-Framework) und scala-xml (XML-Implementierung) erwähnt, wodurch wichtige Abhängigkeiten und Werkzeuge klar benannt werden.

Rechtliche Hinweise und Informationen

• Die rechtliche Grundlage des Projekts beruht auf mehreren US-Bundesgesetzen und Richtlinien (z. B. Source Code Harmonization And Reuse in Information Technology Act, Federal Source Code Policy, Digital Government Strategy).
• Die IRS übernimmt keine Garantie und keine Haftung für Genauigkeit, Vollständigkeit oder Funktionalität des Codes.
• Die gesamte Verantwortung im Zusammenhang mit der Nutzung der Software liegt bei den Nutzern selbst (einschließlich steuerlicher Folgen, Berechnungsfehlern oder Datenverlust).
• Die Einhaltung von Open-Source-Lizenzen und Lizenzen Dritter ist erforderlich.

Sprach- und Technikdaten

• 99,9 % des gesamten Quellcodes sind in Scala geschrieben.
• Darüber hinaus sind kleinere Anteile etwa in Makefile-Strings enthalten.

Sonstige Informationen

• Für dieses Projekt wurde bislang noch kein offizielles Release veröffentlicht; es hat 235 Stars und 11 Forks.
• Insgesamt wirken 11 Contributor an dem Projekt mit.

[GN⁺]

Hacker-News-Kommentare

• Ich frage mich, ob ich etwas missverstehe oder ob dieses Repository tatsächlich keine steuerbezogenen <i>Fakten</i> enthält. Ich wüsste gern, ob die Datei /demo/all-facts als „echte“ Fakten gelten soll und ob man die XML-Faktdateien irgendwo anders bekommen kann. Es ist ziemlich cool, wie der IRS die Steuerformeln definiert und verwaltet, und die Idee von maschinenlesbarem Steuerrecht ist auch wirklich interessant.
  • Die eigentliche Umsetzung des IRS-Steuerrechts befindet sich in einem separaten Repository: https://github.com/IRS-Public/direct-file. Das ursprünglich verlinkte Repository ist für die fact-graph-Tools zuständig, getrennt von der Steuerimplementierung.
  • In diesem Dokument steht: "Das Faktwörterbuch zu standardisieren, sodass es ein kanonisches Format wird, um Steuerlogik deklarativ zu modellieren"
  • Es sieht eher wie eine HTTP-Schnittstelle zu einer Datenbank aus als wie echte Daten.
  • Soweit ich weiß, bedeutet fact eine geteilte Annahme oder Tatsache. Im Steuerrecht ist dieser Ansatz völlig sinnvoll.
• Ich hatte mit TurboTax eine extrem frustrierende Erfahrung wegen der überkomplizierten Benutzeroberfläche, der aggressiven Datensammlung, die so getan hat, als würde sie mir Geld sparen, es aber tatsächlich nicht tat, und einer genauso komplizierten Preisstruktur wie beim IRS. Ich hoffe, dass dieses Projekt es Fachexperten oder einfach guten Leuten ermöglicht, leicht eine transparente und benutzerfreundliche Alternative zu bauen, die der Marktdominanz von TurboTax etwas entgegensetzen kann. Ich frage mich, ob jemand gute Tools oder Ansätze gefunden hat, die diese Probleme verbessern.
  • Ich habe DirectFile nur ein Jahr lang benutzt, aber es war wirklich gut und hat die oben genannten Probleme gelöst. Inzwischen wurden auch entsprechende Maßnahmen ergriffen, also gibt es keinen Grund zur Sorge. Passender Artikel
  • FreeTaxUSA ist wirklich großartig.
  • Ich finde, die Werbung von TurboTax grenzt fast an Betrug. Freetaxusa.com (keine Verbindung) ist genauso gut und tatsächlich kostenlos.
  • Letztes Jahr habe ich Free Fill Fillable Forms sowohl für die Bundes- als auch für die Landessteuer verwendet. Ich habe mich gefragt, warum ich das nicht schon früher gemacht hatte, denn ich hatte Angst davor, die Erklärung selbst auszufüllen, aber in meinem Fall war es wirklich einfach.
• Es freut mich zu sehen, dass das US-Steuerrecht als Open Source umgesetzt wurde. Dieser Code war Teil der IRS-Direct-File-Codebasis und ermöglichte es Menschen, kostenlos direkt beim IRS ihre Steuererklärung einzureichen. Anfang dieses Jahres wurde das von der Trump-Regierung gestoppt. Fact Graph wurde schon vor einigen Monaten Open Source gestellt, und diese Version ist hier. Ich frage mich allerdings, warum jetzt ein zweites Repository entstanden ist.
  • Das frage ich mich auch. Ich vermute, man wollte es aus dem Direct-File-Projekt herauslösen, damit es unabhängig für allgemeinere Zwecke genutzt werden kann.
  • Ich finde es immer noch schade, dass Direct File verschwunden ist, das war wirklich ein Anfang mit Potenzial.
• Ich frage mich, ob man das mit einem LLM kombinieren könnte, um interessante Beratung zum Steuerrecht anzubieten. Es wäre wirklich schön, regelmäßig einfach Fragen zum Steuerrecht stellen zu können.
  • patio11 sagt, dass er bereits mehr als 2.000 $ gespart hat. Vielleicht schreibt er irgendwann auch noch einen formelleren Erfahrungsbericht. (Passender Thread: erster, zweiter)
  • Ich frage mich, ob schon jemand ein Modell gebaut hat, das mit Steuerrecht trainiert wurde. Das wäre sicher interessant.
  • Für rein spielerische Nutzung ist das vielleicht in Ordnung, aber tatsächlich der falschen halluzinierten Steuer-/Rechtsberatung eines LLM zu folgen, wäre absolut NEIN.

• Dieses Projekt ist als Werk der US-Regierung in den USA Public Domain.<br>Ich frage mich, was die Lizenzformulierung „in den USA Public Domain“ genau bedeutet. Ich würde gern wissen, ob man diese Software außerhalb der USA nicht verwenden kann.

  • Wenn du dich fragst, was „in den USA Public Domain“ bedeutet, musst du wirklich den ganzen Satz lesen (einschließlich der zwei Sätze direkt vor dem CC 1.0 Universal-Text). <br>> Außerhalb der USA nicht nutzbar? <br>Die Lizenz erklärt zwei Dinge:<br> (1) Auch ohne separate Lizenz ist es in den USA automatisch Public Domain, weil es ein Werk der US-Bundesregierung ist. <br>(2) Außerhalb der USA, wo der Rechteinhaber die US-Bundesregierung ist (insbesondere in Ländern, die Prinzipien der Berner Übereinkunft anwenden), wird über die CC 1.0 Universal-Erklärung weltweit auf Urheberrechte verzichtet. <br>Damit kann man es faktisch überall auf der Welt frei und ohne urheberrechtliche Einschränkungen verwenden.

  • Einige Länder erkennen das Konzept der Public Domain nicht an. In den USA sind viele Regierungswerke Public Domain. Wegen solcher internationalen rechtlichen Unterschiede versucht die US-Regierung, ihr Ziel zu erreichen, indem sie es als Public Domain bezeichnet und gleichzeitig international eine Lizenz mit ähnlicher Absicht vergibt.
  • Gute Frage. Da sich das Urheberrecht je nach Land unterscheidet, könnte das ein Versuch sein, klarzustellen, dass außerhalb der USA eine separate Lizenz gilt.
• Für mich sah der Source-Code nach Scala aus, aber mein Gehirn hielt ihn zuerst für Clojure, und ich war in den ersten paar Sekunden verwirrt, warum die Klammern fehlten.
• Als der Direct-File-Code veröffentlicht wurde, war das ein wirklich interessanter und cooler Teil. Frühere HN-Diskussion Besonders hilfreich ist, dass in diesem Release immer noch ein ziemlich gutes Inline-Tutorial enthalten ist. Link zum Tutorial
• Ich frage mich, ob die Regeln (Steuerregeln) versioniert werden. Ich habe nachgesehen, konnte dazu aber nichts finden.
• Ich frage mich, wie man das hacken könnte, um Geld zu sparen.
• Ich bin immer noch überrascht, dass es den IRS noch gibt.