US IRS free online tax filing open source repo (2025) (github.com)
139 points by accountinhn 6 hours ago
gouggoug 3 hours ago
I wanted to electronically file my own taxes last year instead of paying turbotax or an actual accountant.
While my situation isn't particularly complex (but complex enough that I did need help from an accountant the first times), none of the free filing services online (IRS FreeFile included) offered the more complex forms I need.
"Not a problem!" I thought. Except, even if I could download the forms from the IRS and do all the work myself, I could not for the life of me find a way to electronically submit (and had to hire my accountant again).
Is it possible in the US to electronically file your own taxes?
Grombobulous 36 minutes ago
My suggestion is to accept the status quo of American tax filing, while in the meantime continue to bother your representatives about it.
If your taxes are complicated enough that you need to pay, just pay.
This will come across as a product plug, but FreeTaxUSA is a lot better than TurboTax and provides 100% of the featureset for free for federal taxes, and charges $16 for state filing. The UI and interface is also way better than the hostile design of TurboTax.
It is technically possible to use Free Fillable Forms but it realy isn't worth saving $16. You will easily burn multiple hours of extra time compared to something like FreeTaxUSA.
https://www.irs.gov/e-file-providers/free-file-fillable-form...
_n_b_ 2 hours ago
Just out of curiosity, which forms are Free File Fillable Forms missing that you need?
(I feel like I have moderately complex taxes and they have all of them that I use.)
gouggoug 2 hours ago
I'm not entirely sure, but I think it was forms related to foreign partnerships and foreign real estate income
_n_b_ 2 hours ago
jghn 2 hours ago
When this repo was first discussed a year or so ago I remember it being stated that the answer is "no" unless you qualify for the IRS free file program
platevoltage an hour ago
Intuit lobbies the government to make sure we don't have any free options.
roosterIllusi0n an hour ago
And here we are with a public way to do it that comes out after republicans get wiped out in the election. Elections do matter.
Jolter an hour ago
SoftTalker 41 minutes ago
wanderingmind an hour ago
Yes just use Claude or ChatGPT to download it and fill it and paper mail it. Today their capabilities far exceed that of an average accountant
gouggoug a minute ago
Me: “is it possible to file your taxes yourself electronically?”
Them: “Yes! Use AI and paper mail them”
You can’t make that stuff up.
ane 4 hours ago
When I read these and the related stories I am thankful I live in a country where you don't even need to file taxes. Virtually all income is reported to the tax authorities, so they will calculate a tax rate for you and you rarely need to make adjustments if your income is stable and regular.
Only when I need to make some surprise deductions (e.g. purchasing work-related literature, deductible by law here up to some sum) or for some reason the payer of income is not reported to the tax authorities. Or when the income falls short of what was projected for that year (e.g. unpaid leave, getting fired, changing to jobs to a lower salary (it happens) etc.), or there is a surprise bonus and so on. Normally I do not need to anything.
kccqzy 4 hours ago
Let’s say I rent a spare bedroom my home to someone; who’s going to report that income if not me?
If your income is actually fully reported to the IRS (W-2 or various 1099) filing taxes is a breeze anyways. Use one of the several free (as in beer) software to take a picture of your forms and it generates the right form that you can submit electronically to the IRS.
throw0101d 3 hours ago
> Let’s say I rent a spare bedroom my home to someone; who’s going to report that income if not me?
How many people are in this situation? Or have other forms of income that are not part of their full-time job payroll? I know I don't, and most of my personal circle.
Even if 'only' 50% of the population is covered by the situation of having solely one income via payroll, that's still half the country not having to faff about with tax forms or tax software.
voxic11 3 hours ago
fph 4 hours ago
Rental contracts must be registered with the authorities where I live. Not only to report income, but also to prevent illegal renting.
piker 3 hours ago
mopsi 3 hours ago
You add that manually to your prefilled forms. In countries that have automated these things, there are often even wizards that ask you to confirm such things before you can approve and send the prefilled forms. Tax authorities put together as much as they can from their sources and you only have to add the missing parts, if there are any. And done.
Kevcmk 3 hours ago
I am pretty shocked that you'd defend the system of tax reporting in the US. Have you seen:
[Intuit: Lobbying to Save TurboTax](https://www.hbs.edu/faculty/Pages/item.aspx?num=67211)
Can I assume that you also oppose healthcare reform?
kccqzy an hour ago
hartator 4 hours ago
> When I read these and the related stories I am thankful I live in a country where you don't even need to file taxes. Virtually all income is reported to the tax authorities, so they will calculate a tax rate for you and you rarely need to make adjustments if your income is stable and regular.
Which country?
In my experience, Americans put a very high bar on governments, hence the multiple complaints you keep seeing, but the actual system is way simpler than most EU countries.
downut 2 hours ago
I've filed our taxes myself probably 20 times, with multiple partial years in multiple states.
I'm a little at a loss about how it is way simpler than what my friends tell me in multiple EU countries.
Can you elaborate?
IshKebab 3 hours ago
UK probably. And while I agree that is a good aspect of our tax system, I wouldn't praise it too much. There are still many many absurdities.
cogman10 4 hours ago
That's the neat thing, in the US virtually all income is reported to tax authorities. They just don't do anything with it.
It is a bit more complex because we have federal and state taxes but there really is no reason why we couldn't also have that system.
newman314 3 hours ago
Intuit is the reason
bentt 4 hours ago
I cannot see how Turbotax survives the oncoming AI Coding freight train. All the information is out there.
UncleOxidant 4 hours ago
Will not shed any tears if Turbotax doesn't make it.
StellarScience 3 hours ago
An accountant does our taxes now, but up until a decade or so ago I was always impressed that I could file taxes and all necessary forms, for myself and my small business with dozens of employees, all using the $25 version of TurboTax.
It's been popular to dump on TurboTax for several years now, but I had a great experience using it.
I personally don't trust AI enough to say "here's my data, please do my taxes for me" yet, but you're right, I suppose that is just a matter of time...
s1artibartfast 3 hours ago
I wouldn't trust AI out of the box either.
That said, there's basically nothing stopping someone from creating fee software equivalent or better than TurboTax from scratch using AI. They can even decompile TurboTax source code as an input
sgerenser 3 hours ago
cellular 2 hours ago
valgaze 4 hours ago
1. Commercial lobby: Intuit/TT, tax preparers, firms that benefit from confusion
2. Political/ideological lobby (less today but still a factor): Grover Norquist railed against return-free filing (using the data they’ve got government sends you a number to pay, if you pay it you are 100% done with taxes no takebacks.)
Commercial lobby is an irritant but the “ideological” one is the most annoying and difficult to surmount.
Norquist & his camp says the government/IRS has fundamental conflict of interest as the collector and enforcer and taxpayers won’t bother to correct government calculation mistakes on their taxes. If there’s a real appeal process doing all the old-school recordkeeping there probably wouldn’t ever be a shortage of taxpayers eager to challenge/contest and file with their own paperwork.
Norquist and friends need taxes to remain a PITA & have high hassle factor for their fundraising and advocacy efforts. If taxes are too easy these people won’t have much political purchase railing against how annoying/$$ it is to pay taxes.
Idk anything substantive about tax policy (ie who should pay what share, best use of $$, etc I’ll leave to the “professionals”/political system) but just as an end user who uses tax prep services it sure seems like there is a concerted effort by people economically & ideologically incentivized to make taxes as annoying as possible
- https://atr.org/senate-conservatives-speak-against-return-fr...
- https://www.latimes.com/politics/story/2021-10-21/california...
- https://www.propublica.org/article/how-the-maker-of-turbotax...
zugi 3 hours ago
The people to blame for complicated taxes are Congress and the President. Over time Congress slips in all sorts of special taxes and special exclusions to support their interest groups. The last time there was a concerted effort to simplify the tax code was 1986 https://en.wikipedia.org/wiki/Tax_Reform_Act_of_1986 .
Critics of the 1986 Tax Reform Act said, why bother simplifying the tax code when Congress will just make it complicated again? The response was sure, we'll just need to clean up the tax code again every 20 years or so. Well that's never happened since.
In 2017 many in Congress wanted to simplify the tax code. Unfortunately Trump said he didn't want to simplify taxes, he just wanted to lower them. As one great example, some folks wanted to eliminate the State and Local Tax deduction (SALT), which is a complicated deduction. (Example: You file federally based on "estimated" state and local taxes, but if you get a refund or owe state and local taxes, the next year you have "adjust" your prior year's deduction.) Instead of eliminating them, the 2017 tax bill just phased them out at higher income levels, which just adds complexity to an already complex part of the tax code.
Certainly the act of filing one's taxes can be made a bit simpler, but it seems there's never any incentive behind actually simplifying the tax code itself, because every tiny change to the tax code creates winners and losers who object.
s1artibartfast 3 hours ago
linsomniac 2 hours ago
I'm definitely planning on using AI and FreeTaxUSA.com this year to file taxes. I've used them before and I've been very happy. Last year I had a fairly complicated tax setup because of my wife's business, and had a neighbor accountant do the taxes for a really reasonable price, but he sent out a letter that he's retiring, and my wife's not doing that business this year.
I can usually do it in a couple hours while watching TV, but I'm interested in seeing what AI can bring to it. Most of my taxes are just copying numbers from one form into the web interface and verifying everything.
Having to copy data from a form that was filed with the IRS, into another form that is going to be filed with the IRS, is idiotic.
vkou 4 hours ago
It's not like the tax code was secret, or like their application isn't a pile of dogshit.
They survived and will survive based on marketing.
Exoristos 4 hours ago
Taxes and vibe-coding--what could go wrong?
mattm an hour ago
I used Claude for my taxes last year. It was fine.
Previously, I used Free Fillable Forms which does force me to know more about tax forms than a more abstract software program. Most people's tax situation does not change very much year to year so it's fairly easy to verify - you can check if my tax return looks fairly similar to the previous year taking into account any differences.
If you have a substantially different year for whatever reason, sure get an accountant to double check. But if you're paying for an AI frontier agent, there's really no need to pay for a 3rd party program anymore.
cadamsdotcom 3 hours ago
Wikipedia in its early days was not a high quality source of information. Assignments citing Wikipedia were graded F, no one trusted the information there, etc etc.
Now look at it! It's a key data source for humans AND AI. When did the flip happen? How did it happen?
Your views on vibecoding are going to become wrong similarly: gradually then all at once.
So keep looking for the signs and be ready to change your views - it'll happen fast to vibecoding too.
jraph 2 hours ago
atcole 3 hours ago
This is great that this is out there. I've been working on making an agent based experience that helps you put together your whole return or make an estimated return based on future assumptions and solving for the federal tax code has been a very token expensive operation!
https://github.com/captaincole/OpenReturn - Still in Beta
I'm going through their engine as well and validating mine. My engine is built to include the CA tax code also.
The biggest reason that turbo tax and the other companies survive though is that in order to allow efile you have to be a registered agent and that process is crazy expensive and difficult.
spike021 3 hours ago
can you explain your validation process?
I'd be tempted to try something similar for this season. But this is what I generally pay HR Block for; they should be relatively vetted (granted i don't know this for a fact).
like do you have tax accounting experience or do you intend to have someone who does help validate test returns to make sure they look right?
atcole 3 hours ago
Yeah! So there are two levels to my validation.
1) I've built the engine and tested it based on CPA or externally reviewed real returns. You can see that in the scenario tests
2) I also have a mechanism for people to test the engine against their previous returns privately and then send bug reports of something wrong
The engine currently only works for 2025 because the 2026 documents aren't out yet from the irs.
There is also definitely a place as well in the tax world for general estimates. For example calculating the tax consequences of a stock sale or iso exercise can get really complicated without a system and cost $800+ with a CPA to do.
souenzzo 4 hours ago
In Brazil, we can send our "IRS" (IRPF) via internet since 1995 It used to have a .jar app that runs on windows/Linux/mac, but now we have android/iOS app, and also online via browser too.
gonzalohm 3 hours ago
The .gov url in that repo doesn't work. That's kind of suspicious
tombert 3 hours ago
Isn't that because Trump killed the directfile program immediately after taking office? Presumably to make sure he is not remembered for doing anything positive.
makuchaku 4 hours ago
How do we know this is from IRS?
simonw 4 hours ago
Weirdly a Google search for "GitHub.com/IRS-Public site:irs.gov" didn't turn up anything.
This is one of the projects that DOGE killed though, so maybe unsurprising that it's not linked to from official .gov websites.
BCM43 4 hours ago
cromka 4 hours ago
As an EU person who lived in US for quite some years, I always found it funny when my fellow Americans were laughing at European technological backwardness, only to be reminded about their admin services being basically still from the 90s/00s.
dgellow 4 hours ago
I mean… Germany admin services are pretty poor, to stay polite
cromka 2 hours ago
Not the same level. US problem is lack of centralization. This was majestically exemplified with the COVID vaccines certificates which were a piece of paper, because they simply could not agree on FDA owning the complete database. That piece of paper did not even have a stamp on it... Meanwhile the EU had Android/iPhone compatible wallet entries, dynamically refreshed.
aliljet 4 hours ago
Who is making an agent-forward turbotax competitor? Take my money already. Good god, the previous generation of tools suck.
richstokes 4 hours ago
Giving an agent a folder of your pay stubs / 1099s / everything for the year and telling it to “file my taxes for me” without all the messing about would be great.
I’m assuming with browser control it would already do a good job of this by driving turbo tax etc. but there’s probably a way to cut them out entirely.
Obviously you’d want to check it over, but 90% of the work for me is working around turbo tax jank / manually entering info when it fails to parse things or can’t auto link to an institution properly. An LLM steering a browser could easily do all that.
atcole 3 hours ago
I think it will be possible to do with the right harness in the future. I've tested gemma4 31b and it's pretty close with an engine backing it.
cogman10 3 hours ago
It's a bunch of PII that you'll be sending to the LLM provider. I'd be pretty uncomfortable with doing that even if it works.
richstokes 3 hours ago
atcole 3 hours ago
I am. For free too! open source and local model capable (albeit most small models and hardware setups can't do it yet). I have some evals provided on document ingestion.
https://github.com/captaincole/OpenReturn
Check it out
rishabhjain1198 3 hours ago
aliljet 4 hours ago
And if you want to maket his with me, message me! I kind of loathe the industry and would love to help.
edoceo 4 hours ago
I've been hacking on one.
proc0 2 hours ago
Of course even with software the government can't help itself but produce a degenerate amount of documentation that you have to parse through before doing anything. I really hope AI helps out in this regard, i.e. they should train their own models or fine tune one to produce correct answers almost always. Then it's a matter of following the AI instructions. Of course that's probably too good and efficient for the US government.
fedpost 4 hours ago
The PRs are mildly entertaining, as are all the ones they've closed. Doesn't seem to be run by someone who knows what they're doing?
ram1500natrluvr 4 hours ago
In the first PR:
https://github.com/IRS-Public/direct-file/pull/1
elijah-wright commented on Jun 3, 2025
> because this is the first pull request and something many people will see, I would like to say that I learned from a former project manager at the IRS that development on Direct File has stopped since January. the source code is only public because of federal law. it's not likely that this is going to be merged but it's possible that the components of Direct File might be used elsewhere
waltbosz 4 hours ago
I wouldn't be surprised . I worked as a developer placed at a state government agency. Many of the people who worked there seem to have no natural drive to do good work.
2OEH8eoCRo0 4 hours ago
Maybe their first exposure to Git? I only had ClearCase experience and was a noob when finally moving away from defense work.
bee_rider 4 hours ago
Is this even legit?
toomuchtodo 5 hours ago
I expect IRS DirectFile to return and made permanent with recent Congressional regime change.
cogman10 4 hours ago
I'd not expect that until 2028 and a little later after that.
The team that managed DirectFile was laid off in DOGE. Further, the current admin has been happily violating the Impoundment Control Act. Congress is going to have to sue to get them to start enforcing the law and I don't expect that to work its way through the courts very quickly. Further, I'd not be surprised if the supreme court decides that the Impoundment control act is unconstitutional for some reason or another.
It should be made permanent.
toomuchtodo 3 hours ago
Not picky how long it takes, just start grinding towards success and don’t stop grinding until it’s been implemented and locked in from future harm with policy whenever possible.
cogman10 3 hours ago
rishabhjain1198 3 hours ago
We're working with the IRS commissioner who spearheaded IRS Direct File to bring it back. https://getprimemeridian.com
kccqzy an hour ago
I expect this will make Trump very unhappy and he will veto it. I would be very surprised if Congress could override the veto.
toomuchtodo 11 minutes ago
Veto away. We can simply keep trying, just like midterms was a generational sea change. We’ll get done what can get done until more can get done.
raverbashing 4 hours ago
Ok but is the IRS API endpoint that gets the filings in json/xml/etc still open and "free to use"?