L’IRS publie Fact Graph en open source

• L’Internal Revenue Service (IRS) des États-Unis a publié en open source un graphe de connaissances appelé Fact Graph
• Fact Graph est utilisé pour modéliser le droit fiscal américain et les lois associées, et peut être exploité à la fois dans des environnements JVM et JavaScript
• Le code source du projet est mis à jour fréquemment, et le développement se fait dans un dépôt privé avant que les modifications approuvées ne soient répercutées en temps réel
• Fact Graph est développé et publié conformément à divers fondements juridiques et aux politiques fédérales open source
• Les utilisateurs assument l’entière responsabilité de l’utilisation et des modifications du logiciel, et l’IRS ne fournit aucune garantie ni assistance spécifique

---

Importance et avantages de la publication en open source

• Le passage en open source du projet Fact Graph par l’IRS constitue une évolution significative dans un contexte visant à renforcer la transparence et la réutilisabilité des données publiques et des informations juridiques
• Contrairement à d’autres projets de graphes de connaissances plus généraux, il a été conçu comme une structure de haute qualité adaptée à un environnement de production, spécialisée dans le droit fiscal américain et les réglementations fédérales, ce qui lui confère une forte utilité et une grande fiabilité dans ce domaine
• Il prend en charge JavaScript ainsi que les langages de l’écosystème JVM (par ex. Java, Kotlin, Scala, Clojure), offrant une large compatibilité avec différents stacks techniques
• Il reste à jour grâce à des mises à jour fréquentes du dépôt et à un système de répercussion en temps réel
• En s’appuyant clairement sur des bases juridiques et des politiques open source, il fournit un socle fiable pour une utilisation par les organismes publics, les entreprises privées et les particuliers

Présentation du projet

• Fact Graph est un graphe de connaissances directement exploitable en production, principalement destiné à modéliser le code fiscal fédéral américain (Internal Revenue Code) et les lois fiscales associées
• Il peut être utilisé non seulement avec JavaScript, mais aussi avec tous les langages basés sur la JVM (Java, Kotlin, Scala, Clojure, etc.), ce qui permet son intégration dans divers environnements de développement et plateformes

Utilisation du dépôt et participation au développement

• L’environnement de développement et la méthode d’installation sont décrits dans ONBOARDING.md
• Les améliorations de la dernière version (v3.1) par rapport aux versions précédentes sont présentées dans une documentation et des liens séparés
• Les méthodes de contribution open source et les guides associés sont détaillés dans CONTRIBUTING.md

Principales caractéristiques

• Le code source du projet est mis à jour régulièrement ; le développement effectif se déroule dans un dépôt privé, puis seules les modifications validées sont fusionnées en temps réel dans ce dépôt (branche main)
• La documentation mentionne ScalaTest (framework de test) et scala-xml (implémentation XML), en précisant clairement les principales dépendances et outils

Droits et informations juridiques

• Le cadre juridique de ce projet repose sur plusieurs lois et politiques fédérales américaines (par ex. Source Code Harmonization And Reuse in Information Technology Act, Federal Source Code Policy, Digital Government Strategy)
• L’IRS ne garantit pas et n’assume aucune responsabilité quant à l’exactitude, l’exhaustivité ou le bon fonctionnement du code
• Toute responsabilité liée à l’utilisation du logiciel incombe à l’utilisateur (y compris les conséquences fiscales, les erreurs de calcul ou les pertes de données)
• Le respect des licences open source et des licences tierces est nécessaire

Informations linguistiques et techniques

• 99,9 % de l’ensemble du code source est écrit en Scala
• Quelques éléments supplémentaires, comme le Makefile, sont également présents

Autres informations

• Aucune release officielle n’a encore été publiée pour ce projet, qui compte 235 étoiles (stars) et 11 forks
• Le projet rassemble actuellement 11 contributeurs

[GN⁺]

Avis Hacker News

• Je me demande si c’est moi qui confonds quelque chose, ou si ce dépôt ne contient pas réellement de faits fiscaux. Je voudrais savoir si le fichier /demo/all-facts est censé être considéré comme de « vrais » faits, et si les fichiers XML de faits peuvent être obtenus ailleurs. La façon dont l’IRS définit et gère les formules fiscales est assez impressionnante, et l’idée d’un code fiscal lisible par machine est vraiment intéressante.
  • L’implémentation réelle du code fiscal de l’IRS se trouve dans un dépôt séparé : https://github.com/IRS-Public/direct-file. Le dépôt lié à l’origine concerne l’outil fact graph, distinct de l’implémentation fiscale.
  • Dans cette documentation : "standardiser le dictionnaire de faits pour en faire un format canonique permettant de modéliser de manière déclarative la logique fiscale"
  • Ça ressemble davantage à une interface HTTP vers une base de données qu’à des données réelles.
  • Si j’ai bien compris, un fact désigne une hypothèse ou un fait partagé. Dans le contexte du code fiscal, cette approche est parfaitement logique.
• J’ai eu une expérience extrêmement frustrante avec TurboTax à cause de son interface trop complexe, de sa collecte de données agressive qui prétend vous faire économiser de l’argent alors que ce n’est pas vraiment le cas, et de sa grille tarifaire presque aussi compliquée que l’IRS. J’espère que ce projet permettra à des experts du domaine ou à des gens bien intentionnés de créer facilement une alternative transparente et conviviale capable de remettre en cause la domination de TurboTax sur le marché. Je me demande si quelqu’un a trouvé de bons outils ou de bonnes approches pour améliorer ces problèmes.
  • Je n’ai utilisé DirectFile qu’une seule année, mais c’était vraiment bien et ça résolvait les problèmes mentionnés ci-dessus. Des mesures ont été prises depuis, donc pas d’inquiétude à avoir. Article associé
  • FreeTaxUSA est vraiment excellent.
  • À mon avis, la publicité de TurboTax frôle l’arnaque. Freetaxusa.com (sans lien avec eux) est tout aussi bien et vraiment gratuit.
  • L’an dernier, j’ai utilisé Free Fill Fillable Forms pour le fédéral comme pour l’État. Je me suis demandé pourquoi je ne l’avais pas fait plus tôt ; l’idée de remplir moi-même ma déclaration me faisait peur, mais dans ma situation c’était vraiment simple.
• Je suis content de voir une implémentation open source du code fiscal américain. Ce code faisait partie de la base de code de l’IRS Direct File, ce qui permettait aux gens de déclarer gratuitement leurs impôts directement auprès de l’IRS. L’administration Trump y a mis fin plus tôt cette année. Fact Graph a déjà été open sourcé il y a quelques mois, et cette version est ici. Mais je me demande pourquoi un deuxième dépôt a été créé.
  • Je me pose la même question. J’imagine que le but est peut-être de le séparer du projet direct file pour qu’il puisse être utilisé indépendamment à des fins plus générales.
  • Direct File me manque encore ; c’était vraiment un début prometteur.
• Je me demande si cela pourrait être combiné avec un LLM pour fournir des conseils intéressants sur le code fiscal. Ce serait vraiment bien de pouvoir poser facilement des questions récurrentes sur la fiscalité.
  • patio11 dit avoir déjà économisé plus de 2 000 $. Il écrira peut-être un retour plus formel un jour. (Fils associés : premier, deuxième)
  • Je me demande si quelqu’un a déjà créé un modèle entraîné sur le code fiscal. Ce serait certainement intéressant.
  • Pour s’amuser, pourquoi pas, mais suivre de vrais conseils fiscaux ou juridiques produits par hallucination par un LLM, c’est absolument NON.

• Ce projet est dans le domaine public aux États-Unis car il s’agit d’une œuvre du gouvernement américain.<br>Je me demande ce que signifie cette formulation de licence, « dans le domaine public aux États-Unis ». J’aimerais savoir si cela veut dire qu’on ne peut pas utiliser ce logiciel en dehors des États-Unis.

  • Si vous vous demandez ce que signifie « dans le domaine public aux États-Unis », il faut absolument lire la phrase entière (et même les deux phrases juste avant le texte CC 1.0 Universal). <br>> Usage interdit hors des États-Unis ? <br>La licence explique deux choses :<br> (1) sans licence distincte, comme il s’agit d’une œuvre du gouvernement fédéral américain, c’est automatiquement dans le domaine public aux États-Unis ; <br>(2) en dehors des États-Unis, lorsque le titulaire du droit d’auteur est le gouvernement fédéral américain (en particulier dans les pays appliquant les principes de la Convention de Berne), une renonciation mondiale au droit d’auteur est exprimée via la déclaration CC 1.0 Universal. <br>En pratique, on peut donc l’utiliser librement, sans contrainte de droit d’auteur, partout dans le monde.

  • Certains pays ne reconnaissent pas la notion de domaine public. Aux États-Unis, beaucoup d’œuvres gouvernementales sont dans le domaine public. À cause de ces différences juridiques internationales, le gouvernement américain cherche à atteindre le même objectif en affirmant le domaine public aux États-Unis tout en accordant à l’international une licence poursuivant une intention similaire.
  • Bonne question. Comme le droit d’auteur varie selon les pays, c’est peut-être une tentative de préciser clairement qu’en dehors des États-Unis, aucune licence particulière ne s’applique.
• Pour moi, le source ressemblait à du Scala, mais mon cerveau l’a pris pour du Clojure, donc pendant les premières secondes j’étais perdu à essayer de comprendre la raison de l’absence de parenthèses.
• C’était une partie vraiment amusante et cool lors de la publication du code de Direct File. Ancienne discussion HN En particulier, cette publication contient encore un tutoriel inline assez bon qui vaut le détour. Lien vers le tutoriel
• Je me demande si les règles (les règles fiscales) sont versionnées. J’ai vérifié et je n’ai pas réussi à le trouver.
• Je me demande comment détourner ça pour économiser de l’argent.
• Je suis encore surpris que l’IRS existe toujours.