IRS Direct File logo

IRS Direct File

Source code for the IRS service that files federal tax returns through a plain-language interview

Open Source Alternative to
Repository activity
  • Stars4.6k
  • Forks1.4k
  • Open Issues17
License

Other

Languages
  • JavaScript
  • TypeScript
  • Java
Get it:GitHub

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