gitwtfhub

wtf is india-itr3-filing-assistant?

karthikeyanranasthala/india-itr3-filing-assistant — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5Setup · easy

TL;DR

An AI agent skill that helps reconcile and prepare India's ITR-3 tax return safely, without ever submitting or signing anything on its own.

Mindmap

mindmap
  root((india-itr3-filing-assistant))
    What it does
      Reconciles tax data sources
      Guides ITR-3 schedules
      Reviews before filing
    Tech stack
      Python
      Agent Skills
      Codex
    Use cases
      Prepare ITR-3 tax return
      Cross-check broker tax reports
      Review capital gains data
    Audience
      Indian taxpayers
      Freelancers
      Business income filers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Reconcile prefilled tax data with broker reports before filing an ITR-3 return.

REASON 2

Get guided help selecting the right ITR-3 schedules for capital gains and other income.

REASON 3

Review tax data for errors before signing, e-verifying, or submitting a return.

REASON 4

Use with Codex to safely automate parts of the Income Tax portal or offline utility workflow.

What's in the stack?

PythonAgent SkillsCodex

How it stacks up

karthikeyanranasthala/india-itr3-filing-assistant0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Works with any Agent Skills-compatible host, but needs Codex with browser or computer control for the fullest automation.

The README does not state a license.

Wtf does this do

This project is an AI agent skill built to help someone review, reconcile, and prepare India's ITR-3 income tax return. ITR-3 is used by individuals with business or professional income, and this skill is designed to make gathering and checking that information less error prone, while being careful never to take irreversible actions on its own. It works by comparing several sources of financial information against each other, including the government's prefilled tax data, reports from stock brokers such as Zerodha's Tax P&L statements, other tax certificates, tax payments already made, and the ITR-3 data file being generated. It also guides the user through choosing the correct schedules within the return, handling presumptive taxation under section 44ADA, capital gains, income from other sources, and reviewing everything before the final verification step. The skill is built to work with any AI agent platform that supports Agent Skills, but it works best with Codex, since Codex can control a Chrome browser to interact with an already signed-in Income Tax portal or broker account, use computer control to operate the official offline filing tool, and use spreadsheet tools to check uploaded financial data. If an agent cannot safely control a browser or desktop, the skill falls back to just reviewing files rather than attempting automation it cannot do reliably. Safety is treated as central to the design. The skill will never ask for or handle passwords, one-time passwords, CAPTCHAs, PAN numbers, Aadhaar numbers, or full bank account credentials. It also will not pay tax, sign a declaration, upload a return, e-verify it, or submit anything without a separate, explicit confirmation from the user right before that action happens. The README reminds users that tax rules and government portal behavior change over time, so results should be checked against official Income Tax Department sources, and a qualified tax professional should be consulted when needed.

Yoink these prompts

Prompt 1
Install the india-itr3-filing-assistant skill and help me reconcile my broker tax report with my prefilled data.
Prompt 2
Walk me through selecting the correct ITR-3 schedules for my capital gains and business income.
Prompt 3
Review my ITR-3 JSON file for errors before I submit it.
Prompt 4
Explain what safety boundaries this skill follows before filing my tax return.

Frequently asked questions

wtf is india-itr3-filing-assistant?

An AI agent skill that helps reconcile and prepare India's ITR-3 tax return safely, without ever submitting or signing anything on its own.

What language is india-itr3-filing-assistant written in?

Mainly Python. The stack also includes Python, Agent Skills, Codex.

What license does india-itr3-filing-assistant use?

The README does not state a license.

How hard is india-itr3-filing-assistant to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is india-itr3-filing-assistant for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.