El IRS publica Fact Graph como código abierto

• El Servicio de Impuestos Internos de EE. UU. (IRS) publicó como código abierto un grafo de conocimiento llamado Fact Graph
• Fact Graph se usa para modelar la legislación tributaria de Estados Unidos y las leyes relacionadas, y puede utilizarse tanto en entornos JVM como JavaScript
• El código fuente del proyecto se actualiza con frecuencia, y el desarrollo se realiza en un repositorio privado; luego, los cambios aprobados se reflejan en tiempo real
• Fact Graph se desarrolla y publica conforme a diversos fundamentos legales y políticas federales de código abierto
• Los usuarios asumen toda la responsabilidad derivada del uso y modificación del software, y el IRS no ofrece garantías ni soporte por separado

---

Importancia y ventajas de su publicación como código abierto

• Que el IRS haya abierto como código abierto el proyecto Fact Graph es un paso significativo dentro de la tendencia de impulsar la transparencia y la reutilización de los datos gubernamentales y la información legal
• A diferencia de otros proyectos generales de grafos de conocimiento, está diseñado como una estructura de alta calidad preparada para entornos de producción, especializada en la legislación tributaria de EE. UU. y las regulaciones federales, por lo que ofrece alta utilidad y confiabilidad en ese ámbito
• Es compatible tanto con JavaScript como con el ecosistema de lenguajes JVM (por ejemplo, Java, Kotlin, Scala y Clojure), lo que le da compatibilidad con una amplia variedad de stacks tecnológicos
• Se mantiene actualizado mediante frecuentes actualizaciones del repositorio y un sistema de integración en tiempo real
• Al seguir con claridad las bases legales y las políticas de código abierto, proporciona una base confiable para que entidades públicas, empresas y usuarios individuales puedan adoptarlo

Descripción general del proyecto

• Fact Graph es un grafo de conocimiento listo para usarse en producción, cuyo objetivo principal es modelar el código tributario federal de Estados Unidos (Internal Revenue Code) y otras leyes fiscales relacionadas
• Puede utilizarse no solo en JavaScript, sino también en todos los lenguajes basados en JVM (Java, Kotlin, Scala, Clojure, etc.), por lo que se adapta a diversas plataformas y entornos de desarrollo

Uso del repositorio y participación en el desarrollo

• El entorno de desarrollo y la forma de configurarlo pueden consultarse en ONBOARDING.md
• Las mejoras de la versión más reciente (v3.1) frente a versiones anteriores se ofrecen en documentación y enlaces separados
• La forma de contribuir al proyecto de código abierto y sus guías se detallan en CONTRIBUTING.md

Características principales

• El código fuente del proyecto se actualiza periódicamente; el desarrollo real se lleva a cabo en un repositorio privado, y solo los cambios revisados se fusionan en tiempo real en este repositorio (rama main)
• La documentación menciona ScalaTest (framework de pruebas) y scala-xml (implementación de XML), explicando claramente las principales dependencias y herramientas

Derechos legales y avisos

• La base legal de este proyecto se sustenta en varias leyes y políticas federales de EE. UU. (por ejemplo, Source Code Harmonization And Reuse in Information Technology Act, Federal Source Code Policy, Digital Government Strategy, etc.)
• El IRS no garantiza ni asume responsabilidad por la exactitud, integridad o funcionalidad de este código
• Toda responsabilidad relacionada con el uso del software recae en el propio usuario (incluidos resultados fiscales, errores de cálculo o pérdida de datos)
• Es necesario cumplir con la licencia de código abierto y con las licencias de terceros

Información de lenguaje y tecnología

• El 99.9% del código fuente está escrito en Scala
• También incluye algunos archivos y cadenas en otros formatos, como Makefile

Información adicional

• Este proyecto aún no ha publicado un release oficial, y cuenta con 235 estrellas (stars) y 11 forks
• En total participan 11 contribuidores

[GN⁺]

Opiniones en Hacker News

• Me pregunto si soy yo quien está confundido, o si este repositorio en realidad no incluye hechos relacionados con la legislación fiscal. Quisiera saber si el archivo /demo/all-facts debe considerarse un conjunto de hechos “reales”, y si los archivos XML de hechos se pueden obtener en otro lugar. La forma en que el IRS define y mantiene las fórmulas de impuestos es bastante genial, y también es muy interesante que se trate de legislación fiscal legible por máquinas.
  • La implementación real de la legislación fiscal del IRS existe en un repositorio aparte: https://github.com/IRS-Public/direct-file. El repositorio enlazado originalmente se encarga de la herramienta fact graph separada de la implementación fiscal.
  • En esta documentación: "Estandarizar el diccionario de hechos para convertirlo en un formato normalizado que modele de forma declarativa la lógica fiscal".
  • Parece más una interfaz HTTP para una base de datos que datos reales.
  • Hasta donde sé, un fact se refiere a una suposición o hecho compartido. En legislación fiscal, este enfoque es totalmente razonable.
• Tuve una experiencia muy frustrante con TurboTax por su interfaz demasiado compleja, su recolección agresiva de datos mientras finge ayudarte a ahorrar dinero cuando en realidad no lo hace, y su estructura de tarifas tan complicada como la del IRS. Ojalá este proyecto permita que expertos del dominio o gente bien intencionada construyan fácilmente una alternativa transparente y amigable para el usuario que pueda desafiar el dominio de mercado de TurboTax. Me pregunto si alguien ha encontrado buenas herramientas o enfoques que mejoren estos problemas.
  • Solo usé DirectFile durante un año, pero fue realmente bueno y resolvió los problemas mencionados arriba. Además, después se tomaron medidas al respecto, así que no hay de qué preocuparse. Artículo relacionado
  • FreeTaxUSA es realmente excelente.
  • Creo que la publicidad de TurboTax está casi al nivel de una estafa. Freetaxusa.com (sin relación) es igual de bueno y realmente gratis.
  • El año pasado usé Free Fill Fillable Forms tanto para la declaración federal como la estatal. Me pregunté por qué no lo había usado antes; me daba miedo preparar la declaración por mi cuenta, pero en mi situación fue realmente sencillo.
• Me da gusto ver una implementación open source de la legislación fiscal de EE. UU. Este código era parte del codebase de IRS Direct File, y gracias a eso la gente podía presentar sus impuestos directamente ante el IRS de forma gratuita. A principios de este año, la administración Trump lo suspendió. Fact Graph ya se había liberado como open source hace unos meses, y esa versión está aquí. Pero me pregunto por qué apareció un segundo repositorio.
  • Yo también me lo pregunto. Supongo que quizá quieran separarlo del proyecto direct file para que pueda usarse de forma independiente para propósitos más generales.
  • Sigo lamentando que Direct File haya desaparecido; de verdad era un inicio con mucho potencial.
• Me pregunto si esto podría combinarse con un LLM para ofrecer consejos interesantes sobre legislación fiscal. Sería genial poder hacer preguntas fácilmente sobre dudas fiscales de forma regular.
  • patio11 dice que ya ahorró más de $2,000. Tal vez algún día escriba una reseña más formal. (Hilos relacionados: primero, segundo)
  • Me pregunto si alguien ya habrá creado un modelo entrenado con legislación fiscal. Seguro sería interesante.
  • Para usarlo solo por diversión, quizá está bien, pero seguir consejos fiscales o legales reales dados por un LLM cuando alucina mal sería un rotundo NOPE.

• Este proyecto es de dominio público dentro de Estados Unidos por ser una obra del gobierno de EE. UU.<br>Me pregunto qué significa exactamente esa frase de licencia, “de dominio público dentro de Estados Unidos”. Quisiera saber si este software no puede usarse fuera de EE. UU.

  • Si te preguntas qué significa “de dominio público dentro de Estados Unidos”, tienes que leer toda la oración (incluso las dos que van justo antes del texto de CC 1.0 Universal). <br>> ¿No se puede usar fuera de EE. UU.? <br>La licencia explica dos cosas:<br> (1) sin necesidad de una licencia aparte, al ser una obra del gobierno federal de EE. UU., automáticamente es de dominio público dentro de EE. UU. <br>(2) fuera de EE. UU., cuando el titular de los derechos es el gobierno federal de EE. UU. (especialmente en países que aplican principios bajo el Convenio de Berna), se está haciendo una renuncia mundial al copyright mediante la declaración CC 1.0 Universal. <br>Así que, en la práctica, puede usarse libremente en cualquier parte del mundo sin restricciones de copyright.

  • Algunos países no reconocen el concepto de dominio público. En EE. UU., muchas obras gubernamentales son de dominio público. Debido a estas diferencias legales internacionales, el gobierno de EE. UU. intenta lograr su objetivo declarando dominio público y, al mismo tiempo, otorgando internacionalmente una licencia con una intención similar al dominio público.
  • Buena pregunta. Como las leyes de copyright varían según el país, quizá sea un intento de dejar claro que fuera de EE. UU. no se aplica ninguna licencia especial.
• A mí me parecía que el código fuente era Scala, pero mi cerebro lo confundió con Clojure, así que durante los primeros segundos me costó entender por qué faltaban paréntesis.
• Cuando se publicó el código de Direct File, esta fue una de las partes más divertidas y geniales. Discusión anterior en HN. En particular, ese release todavía conserva un tutorial inline bastante bueno, así que sirve como referencia. Enlace al tutorial
• Me pregunto si las reglas (las reglas fiscales) tienen control de versiones. Revisé un poco, pero no pude encontrarlo.
• Me pregunto cómo hackear esto para ahorrar dinero.
• Me sorprende que el IRS siga existiendo.