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。 您仍需自行申報和驗證，或將生成的申報包交給特許會計師審查。