
US Tax Model
Machine-checkable US federal tax calculation engine
FinanceOpen sourceOpen source · verified#tax#finance#open-source
Listed by the ProductPerch team from Hacker News · not launched here yet
What is US Tax Model?
US Tax Model encodes US federal individual income tax forms and instructions as public, cited, and machine-checkable data. It includes a guided self-preparation interview that asks users questions, determines applicable forms, performs calculations, and outputs a values sheet for manual filing. The software processes everything locally and never files, signs, or transmits tax returns.
The project structures each form as YAML files containing records with identifiers, IRS labels, expressions, and strict citations. Every citation links to an archived IRS document with a specific locator and hash. A build-time checker validates that all references resolve, prevents circular dependencies, and fails if citations are missing or invalid.
Calculations rely on a closed vocabulary of approximately twenty basic operations, such as addition, rounding, and table lookups. This design limits complexity and allows independent verification directly from the repository. The system tracks the IRS published procedures rather than the Internal Revenue Code itself.
US Tax Model features
- Machine-checkable tax form data stored as YAML
- Guided self-preparation interview for users
- Closed vocabulary of twenty calculation operations
- Automated citation verification against archived IRS pages
- Local-only processing with no data transmission
- Build-time validation for reference resolution and acyclicity
Who uses US Tax Model and for what
- Verifying tax calculations independently of commercial software
- Building compliant tax preparation applications
- Auditing IRS form logic and publication procedures
- Creating educational tools for understanding federal tax rules
- Running offline tax computation engines for privacy
US Tax Model FAQ
Is US Tax Model free?
Yes, it is released under the Apache-2.0 license and available on GitHub.
Does US Tax Model file my taxes automatically?
No, the software never files, signs, or transmits a return. It only computes values and provides a sheet for you to file yourself.
Is US Tax Model open source?
Yes, the repository is licensed under Apache-2.0 and the source code is publicly available on GitHub.
What programming languages does US Tax Model use?
The repository contains TypeScript files in the engine directory and Python scripts for citation verification. The website does not specify full language support details.
Can I use US Tax Model for state taxes?
The project focuses exclusively on US federal individual income tax forms and instructions. The website does not mention state tax support.
Comments (0)
Comments and upvotes open when this product launches on ProductPerch.
More Finance launches
CryptoIsland — Crypto Ticker & Price Alerts for Mac
Non-custodial Solana exchange front end with Jupiter swaps
Compare SME business funding offers in one place
Wallets and rails that let AI agents spend money safely.
Multi-timeframe Z-score stock scanner with AI analysis