Metadata-Version: 2.4
Name: trb-tax-pro
Version: 1.1.1
Summary: A CA-grade Income Tax calculation engine for India (FY 2025-26) with AIS reconciliation and support for the Income Tax Act, 2025.
Author-email: "Tanmay Rajendra Bhavar (Chartered Accountant, TRB & Co)" <catanmaybhavar@gmail.com>
Project-URL: Source, https://github.com/tbhavar/trb_tax_pro
Project-URL: Funding, https://buymeacoffee.com/tbhavar
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Office/Business :: Financial :: Accounting
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0.0
Requires-Dist: streamlit>=1.20.0
Requires-Dist: pandas>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: license-file

# TRB Tax Pro

A CA-grade Income Tax calculation engine for India (FY 2020-21 to FY 2026-27) with AIS reconciliation and support for the Income Tax Act, 2025.

Built for precision, notice remediation, ITR-U compliance, and multi-year tax planning.

## Features

- **Multi-Year Support (NEW):** Modular engines for **FY 2020-21 through FY 2024-25** added for historical audits, ITR-U filings, and notice resolution.
- **Section 87A Marginal Rebate:** Precise resolution for the "Cliffs" under the New Regime (specifically mapping the ₹12 Lakh threshold gracefully for FY 2025-26).
- **Marginal Relief (Surcharges):** Mathematically rigorous computation across multiple thresholds (₹50L, ₹1Cr, ₹2Cr, and ₹5Cr).
- **Presumptive Taxation Validation (44AD/44ADA):** Dynamic tests against digital transaction limits to unlock enhanced turnover rules (e.g., 5% Cash rules mapping to ₹3Cr limits).
- **Automated AIS Reconciliation:** Pull SFT entries, Salary, and Capital Gains directly from official JSON specs reducing manual mapping and notice exposure.

## Installation 

Install the latest version directly from PyPI:

```bash
pip install trb-tax-pro --upgrade
```

## Programmatic Usage

Access specific year engines via the `MultiYearDispatcher`:

```python
from trb_tax_pro.engine.dispatcher import MultiYearDispatcher

# Get the engine for a specific Financial Year
engine = MultiYearDispatcher.resolve("fy2025_26")

# Calculate tax
result = engine.calculate_tax({
    "gross_income": 1280000,
    "regime": "new_regime"
})

print(f"Tax Payable: ₹{result['total_tax']}")
```

## Dashboard Interface

Launch the professional CA wrapper interface featuring unified Tax Computation and AIS Data Bridging:

```bash
streamlit run ui.py
```

### Support the Project

If this engine simplifies your compliance workflows or saves your practice from potential 143(1) mismatch notices, please consider supporting the project:
**☕ [Buy Me a Coffee](https://buymeacoffee.com/tbhavar)**
