karanb192/itr-wala

itr‑wala – 从终端申报印度所得税

简介 – 一款开源命令行工具，允许您完全在本地计算机上准备（但不提交）印度个人所得税申报表（ITR‑1/2/3/4）。 复杂的计算由经过测试的确定性 Python 引擎完成，而语言模型仅用于读取您的 Form 16、AIS（年度信息声明）PDF 并解释数字。

重要性 – 大多数“AI 报税工具”让大语言模型进行算术运算，这存在风险，因为单个数字错位就可能触发税务通知。 itr‑wala 分离了关注点：

• AI 部分 – 从 PDF 中提取数字并回答您的问题。
• Python 部分 – 严格按照 2026‑27 评估年度《财政法》的定义，计算所有税率档次、退税、附加税、边际减免、资本利得免税额、利息、滞纳金等。

计算受到三层测试的保护，这些测试在每次提交时运行：

1. 47 个手工推导的黄金测试，涵盖所有法定边缘情况。
2. 104 个输入验证测试，拒绝格式错误或输入错误的数据（包括 PAN/Aadhaar 字符串）。
3. 基于属性的模糊测试器，生成数千个随机申报表并检查不变量（例如，收入增加绝不会导致税款减少）。

典型会话流程

1. 自测 – 运行捆绑的测试套件以验证引擎。
2. 放置文档 – 将您的 Form 16 和 AIS JSON 文件放入文件夹。
3. 提取与验证 – AI 读取 PDF，写入 income.json，验证器将总计与原始文档及 26AS 进行交叉核对。
4. 扣除项访谈 – 助手询问 80C、80D、NPS、HRA、住房贷款利息等。
5. 制度比较 – 计算旧税制和新税制，并显示卢比单位的节省金额。
6. 申报包 – 将门户每个字段映射到计算值的纯文本，以及最终应付/退款金额。
7. 您来完成 – 您手动输入数字，在政府门户上点击支付、提交和电子验证。 该工具从不处理密码、OTP 或点击任何按钮。

安装 – 仓库附带一个 install.sh 脚本，从本地检出运行时从不接触网络；它只是将您刚读取的文件复制到 Claude、Codex、Gemini 或通用 skills.sh CLI 的相应技能目录中。 您可以全局安装（~/.claude/skills/…）或项目本地安装（在您的税务文件夹旁边），甚至可以固定特定的提交或标签，以确保运行您审查过的确切代码。

隐私

• 所有税务计算都在本地运行；数据不会离开您的机器。
• 唯一到达 LLM 的部分是您为其提取而提供的文本。 该工具强制您涂黑 PAN、Aadhaar 或银行账号，验证器将拒绝任何仍包含这些模式的文件。
• 生成的 .gitignore 可防止您的原始文档进入您可能提交的任何仓库。

范围与限制 – 处理 2026‑27 评估年度的居民个人，涵盖工资、房产、资本利得（包括加密货币/VDA）、彩票中奖、家庭养老金、推定收入、所有第 VI-A 章扣除项以及两种税制。 它明确拒绝为非居民、审计案例、外国税收抵免、ESOP 递延、大额农业收入等进行猜测，并会在这些情况下引导您咨询特许会计师。

路线图亮点 – 离线实用程序 JSON 上传、更深入的 RSU/ESPP 支持、修订申报表工作流、原生 Windows 安装程序以及一键式 Claude 桌面捆绑包。

许可证 – MIT。

---

如果您希望以透明、有测试支持的方式准备您的印度税务申报表，同时保持实际计算离线，请使用 itr‑wala。 您仍需自行申报和验证，或将生成的申报包交给特许会计师审查。