ITR-3/4 (non-audit) due 31 Aug 2026. Missed 31 Jul? Belated returns work until 31 Dec 2026.
itr-wala

File your ITR from the terminal.
Every rupee computed, not guessed.

Free and open source. The AI reads your Form 16 and AIS and interviews you for missed deductions; a tested Python engine does all the math. No CA, no ₹3,000 fee, and only you ever click Pay, Submit, or e-Verify.

/plugin marketplace add karanb192/itr-wala

The AI never does the math. That is the whole point.

Every AI tax demo this season had the same silent flaw: the model was doing the arithmetic. LLMs are magnificent at reading a Form 16 and terrible at applying s.87A marginal relief. itr-wala splits the work the way it should be split.

The AI reads and explains

  • Reads your Form 16, AIS, broker P&L
  • Interviews you for missed deductions
  • Explains every number in plain language
  • Walks you through the portal, field by field

Tested Python computes

  • Every slab, rebate, surcharge, cess figure
  • Old vs new regime, to the exact rupee
  • 87A relief, 111A/112A/VDA special rates, 234A/B/C interest
  • Cross-checks your TDS against 26AS and AIS totals
47
golden tests, every expected value hand-derived from the statute
104
validator tests gating malformed or PAN-bearing inputs
350k+
randomized returns fuzzed against invariants the law implies
0
pip installs: stdlib Python 3.9+, runs entirely on your machine

These layers catch real bugs. The fuzzer found a one-in-350,000 rounding edge where ₹52,880 more salary computed ₹10 less tax. Fixed, pinned as a regression test. That find-fix-pin loop is the thing a prompt-only tax tool cannot run. If your CA can show you their test suite, hire them.

What a session looks like

Self-test first, so the engine proves its math before touching your return. Then documents, extraction with validation, a deduction hunt, both regimes computed, and a filing pack that maps every portal field to its value.

itr-wala demo: golden tests pass, income validates against document totals, both regimes computed, Rs 42,811 found

Privacy, honestly

What stays on your machine

  • All tax math: the Python scripts run locally, nothing computed leaves
  • PAN, Aadhaar, account numbers: not needed, and the validator refuses any input containing a PAN-shaped or Aadhaar-shaped string
  • Your portal password and OTP: never seen, never asked for
  • The three final acts: only you click Pay, Submit, e-Verify

What you should know

  • Documents you ask the AI to read are processed by the model, so that part leaves your machine, like anything you paste into an AI tool
  • The skill tells you this up front and invites you to redact identifiers first
  • A generated .gitignore keeps tax documents out of your repos

Out of scope, and it says so instead of guessing: non-residents, F&O and intraday, audit cases, foreign tax credit, ESOP deferral. Built by someone who files his own taxes with it and does security for a living.

Questions people actually ask

Can I trust an LLM with my taxes?

No, and that is the point. You are trusting a tested Python engine with the math and an LLM with reading PDFs and explaining things, which are the two things each is actually good at. The test suite runs in front of you before your return is touched, and you can run it yourself.

Is this allowed?

Yes. You prepare your own return and file it yourself on the government portal, same as using the portal's own forms, just with better preparation. The tool never submits anything on your behalf.

What does it cost?

Nothing. MIT-licensed, free forever. The only cost is your existing Claude Code (or Codex/Gemini CLI) subscription doing the document reading. The tax math is plain Python and costs nothing no matter how many times you recheck.

Why not just use ClearTax, Quicko, or a CA?

Use whatever you trust. This is for people who would rather review every number themselves than pay ₹3,000+ to hope someone else did. The filing pack it generates is also a great ₹0 first draft to hand a CA for a cheap review, it is built to be handed over.

Which forms and situations does it cover?

Resident individuals, AY 2026-27, ITR-1 through ITR-4 with the form picked for you: salary and multiple employers, house property, equity and MF capital gains, crypto, interest and dividends, family pension, presumptive income basics, both regimes with surcharge and marginal relief, advance-tax interest, late fees, and belated returns. What it cannot compute safely, it names and points you to a CA for.