Source code for the IRS service that files federal tax returns through a plain-language interview
- Stars4.6k
- Forks1.4k
- Open Issues17
Other
- JavaScript
- TypeScript
- Java
About IRS Direct File
Direct File is the IRS service that lets taxpayers electronically file federal tax returns for free, directly with the agency. It interprets the Internal Revenue Code as plain-language interview questions, translates the answers into standard tax forms, and transmits them to the IRS Modernized e-File API. The web experience is built to work on a phone, tablet, laptop, or desktop and is offered in English and Spanish.
A declarative, XML-based Fact Graph reasons about incomplete information, such as a partially completed return. It is written in Scala, runs on the JVM, and is transpiled with Scala.js to run in the browser. Taxpayers can optionally export federal return data to a third-party state or local filing tool.
The code was developed by an in-house IRS team with support from USDS, GSA, TrussWorks, Coforma, and ATI. It is archived and no longer maintained, omits PII, FTI, SBU, and NSS code, and should not be used in production.
Key features
- Plain-language interview that produces standard tax forms
- Transmits returns to the IRS Modernized e-File API
- English and Spanish, built for phone and desktop browsers
- Exports federal return data for state or local filing
- Scala Fact Graph reasons about incomplete returns
Details
- Code published
- 2025
- Status
- Archived, not for production use
- Platforms
- Web
- Backend
- Java and Scala on the JVM
- Frontend
- TypeScript and Scala.js
- Filing
- Federal returns via IRS MeF API
