karanb192/itr-wala

itr‑wala – ターミナルからインドの所得税申告書を作成

概要 – インドの個人所得税申告書（ITR‑1/2/3/4）を完全にローカル環境で準備（提出は不可）できるオープンソースのコマンドラインツールです。 複雑な計算はテスト済みの決定論的Pythonエンジンが担当し、言語モデルはForm 16やAIS（年間情報ステートメント）のPDFを読み取り、数値を説明するためにのみ使用されます。

重要性 – 多くの「AI税務申告ツール」は、大規模言語モデルに計算を任せていますが、1桁の誤りでも税務通知書を引き起こす可能性があるためリスクがあります。 itr‑walaは役割を分離しています：

• AI部分 – PDFから数値を抽出し、質問に回答します。
• Python部分 – 2026‑27課税年度の財務法で定義された通り、すべての税率区分、減税、超過累進課税、限界軽減、資本利得非課税、利息、延滞料などを正確に計算します。

計算は、すべてのコミット時に実行される3層のテストで保護されています：

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. ユーザーによる完了 – ユーザーが数値を手動で入力し、政府ポータルで「支払う」、「提出」、「e-Verify」をクリック。 ツールはパスワード、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を使用してください。 申告と検証は自分で行うか、生成されたパックをCAにレビューしてもらう必要があります。