Irs Open Sources Its Fact Graph
Posted3 months agoActive3 months ago
github.comTechstoryHigh profile
calmmixed
Debate
60/100
Tax CodeOpen SourceIrsFact Graph
Key topics
Tax Code
Open Source
Irs
Fact Graph
The IRS has open-sourced its fact graph, a knowledge graph representing the US tax code, sparking discussion on its potential uses, limitations, and implications for tax preparation and transparency.
Snapshot generated from the HN discussion
Discussion Activity
Very active discussionFirst comment
29m
Peak period
59
0-6h
Avg / period
13.2
Comment distribution79 data points
Loading chart...
Based on 79 loaded comments
Key moments
- 01Story posted
Oct 15, 2025 at 7:24 PM EDT
3 months ago
Step 01 - 02First comment
Oct 15, 2025 at 7:53 PM EDT
29m after posting
Step 02 - 03Peak activity
59 comments in 0-6h
Hottest window of the conversation
Step 03 - 04Latest activity
Oct 18, 2025 at 5:41 PM EDT
3 months ago
Step 04
Generating AI Summary...
Analyzing up to 500 comments to identify key contributors and discussion patterns
ID: 45599567Type: storyLast synced: 11/20/2025, 5:36:19 PM
Want the full context?
Jump to the original sources
Read the primary article or dive into the live Hacker News thread when you're ready.
This is the rules engine's details. You could use it to build the logic and traversal in whatever language you like.
I'm curious why a second repository was created for this.
> The main changes are: [...] converting the fact-graph to a standalone library [...]
--Internal Revenue Service Commissioner Bill Long, July 28, 2025
https://directfile.irs.gov
So it's always possible they'll just forget to shut it off.
The 2024 site remains up so people can file their taxes for that year, but it will no longer be updated.
https://arxiv.org/abs/2507.16126v1
[0] but it's quite possible the conversion from HTML to text is bad
Would be neat (and still legally fraught!).
However it's clear that we are moving towards separating the data and the language model. Even base chatgpt is given Search Tools and python Tools instead of producing them by text, the tool call itself may be generated by the model though.
You can for sure use a pure LLM to ask it questions about tax code, but we'll probably see specific tools that only contain canon law and kosher case law, and sources it properly. Y'know instead of halucinating
It begs the question why you assume the parent comment was going to blindly follow the LLMs output.
Many people do
You can pay for K-12 with 529 or Coverdell ESA funds. But neither allows deductions for contributions. Only growth in either is tax free (assuming it’s spent on education expenses).
What does it mean for the license to say "within the US"?
Does this mean this software cannot be used outside the US?
To satisfy these conflicting requirements, the US government places it in the Public Domain in the US to satisfy US law. Additionally, they make it available internationally under a license that approximates the intent of Public Domain while still being recognized as a legally valid thing.
It means exactly what it says; you have to read the whole thing (or at least the two sentences before the CC 1.0 Universal text, which is the operative mechanism by which the second sentence is effected), not a fraction of the first sentence.
> Does this mean this software cannot be used outside the US?
No. The license explains two things:
(1) Without any license, this is automatically public domain in the US because it is a federal government work.
(2) The federal government (as the owner of the copyright at creation outside the United States, at least anywhere that applies the common rules underlying the Berne Convention) waives copyright worldwide, and does so via the CC 1.0 Universal declaration (the text of which is then included.)
So, it is, to the extent that this is legally possible, copyright-free globally.
It’s pretty cool to see the way that the IRS handles defining and maintaining its tax calculations, but also a machine-readable tax code seems cool too.
https://github.com/IRS-Public/direct-file/tree/e0d5c84451cc5...
> Standardize Fact Dictionaries as a canonical format for declaratively modeling tax logic
I hope this initiative is good enough to enable domain experts and good people to build transparent, user-friendly alternatives to challenge TurboTax’s market grip.
Has anyone encountered promising tools or approaches that tackle these pain points?
https://apnews.com/article/irs-direct-file-tax-returns-free-...
http://apnews.com/article/apnews-declares-trump-stupid-4bb0b...
https://apnews.com/article/4bb0bca02fab9b3d06ae6f45ac67b7ab
This is true for most news websites as well as online shopping sites
https://www.opensecrets.org/news/2024/02/turbotax-maker-intu...
Democrats keep trying to make taxes in America better, including prominent democrats literally calling for the investigation of Intuit's bribery here.
Then people elect republicans.
https://www.investors.com/politics/editorials/worst-run-stat...
Freetaxusa.com (no affiliation) is just as good and legitimately free.
In particular there's a pretty nice inline tutorial that's still there in that release: https://github.com/IRS-Public/direct-file/blob/main/direct-f...
0: If Intuit (TurboTax) and others didn't keep lobbying to keep it so complicated, the IRS would be able to opt-out auto-calculate tax bills for income, estate, and corporate taxes automatically like many other advanced economies.
PS: Federal shutdown day 16. IRS press office remains open. And most of the tax enforcement divisions were recently RIFed because it's too annoying for rich people to game the system to dodge taxes.