karanb192/itr-wala

itr‑wala – 터미널에서 인도 소득세 신고서 작성

개요 – 인도 개인 소득세 신고서(ITR‑1/2/3/4)를 완전히 로컬 컴퓨터에서 준비(제출은 불가)할 수 있는 오픈소스 명령줄 도구입니다. 복잡한 계산은 테스트된 결정론적 Python 엔진이 수행하며, 언어 모델은 Form 16 및 AIS(연간 정보 서명) PDF를 읽고 수치를 설명하는 데만 사용됩니다.

중요성 – 대부분의 "AI 세금 신고 도구"는 대規模 언어 모델에 산술을 맡기지만, 이는 한 자리의 숫자 오류가 세금 통지를 유발할 수 있어 위험합니다. 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에게 검토를 맡겨야 합니다.