Bangladesh Youth Tax Calculator logo

Bangladesh Youth Tax Calculator

AI Agent Skill & Deterministic Engine for NBR e-Return (etaxnbr.gov.bd)

Made for students, interns, fresh graduates, and first-time filers entering the tax net under the Income Tax Act 2023. Helps you keep tax expense at minimum, claim eligible TDS refunds, and achieve zero-difference balance sheet reconciliation.

Income Tax Act 2023etaxnbr.gov.bd VerifiedMinimized Tax LiabilityZero-Difference Balance Sheet100% Open Source MIT

Why I Built This: The Student Tax Problem

Having an e-TIN, filing a tax return is something we all face. But being a student still, with no budget to hire a professional tax consultant or chartered accounting firm, many of us turn to AI.

When I tried doing that myself, I found so many issues along the way. LLMs, especially Gemini, Claude, and GPT models, struggled to understand how the actual NBR e-Return system UI looks like. They missed exemption toggles, hallucinated where to enter university scholarships, and repeatedly failed at basic multi-line balance sheet arithmetic.

For that, I built this SKILL for your LLM.

No, this does not simply calculate your taxes. By implementing this skill, your AI becomes equipped with the substantive statutory law (Income Tax Act 2023) and the screen-by-screen architecture of Bangladesh's e-Return system. It walks you through every screen and calls a deterministic Python engine so your balance sheet balances to an exact difference of 0.00 while keeping your tax expense at the legal minimum.

Deployment & Tooling

How to Install & Run

This project is an AI Skill first. Instead of asking generic LLMs that hallucinate portal screens, this skill loads the complete statutory rules of the Income Tax Act 2023, the official NBR e-Return portal architecture, and delegates all multi-line arithmetic to Python to keep your tax expense at minimum.

Windows (PowerShell) One-Click
.\install.ps1
macOS / Linux (Bash) One-Click
chmod +x install.sh && ./install.sh
Direct Ingestion for AI Agents (Claude Code / Cursor / CLI):
curl -s https://raw.githubusercontent.com/zaifears/youth-tax-calculator/main/llms-full.txt > tax_skill.md
Ask Your AI to Calculate (ChatGPT, Claude, Gemini)

Paste this into your AI chat window so it uses the official Income Tax Act 2023 rules and avoids common filing mistakes:

I am filing my Bangladesh individual income tax return on etaxnbr.gov.bd under the Income Tax Act 2023. Please load and use the youth-tax-calculator skill (GitHub: https://github.com/zaifears/youth-tax-calculator, or read https://raw.githubusercontent.com/zaifears/youth-tax-calculator/main/llms-full.txt) to calculate my tax liability, maximize legal exemptions (Sixth Schedule Part 1 Para 8 stipends, Section 32 salary exemption), claim bank TDS refunds, and reconcile my IT-10B balance sheet to an exact difference of 0.00.
What to ask your AI after installation:
  • I am a university student in Bangladesh with an internship, walk me through my return on etaxnbr.gov.bd
  • Calculate my parent support figure under Section 56(g) so my IT-10B difference is exactly 0.00
Live Statutory Simulation

The Zero-Difference Balance Sheet Engine

Adjust the sliders below to see how Form IT-10B keeps tax expense at minimum and automatically solves for parental support under Section 56(g).

Annual Internship Salary: BDT 35,0001/3rd Auto-Exempt (Sec 32)
University Stipend / Scholarship: BDT 18,000100% Tax-Free (6th Sch)
Annual Living Expenses (IT-10BB): BDT 170,000Food, rent, tuition
Net Taxable IncomeBDT 23,561
Tax PayableBDT 0 (Kept at Minimum)
Bank TDS StatusBDT 31 (100% Refundable)
Total Fund OutflowBDT 177,105
Enter in Other Receipts (Sec 56g)BDT 135,543.667
NBR Portal Validation Check
Difference = 0.00
Form IT-10B passes submission checks without triggering audit alerts.

Key Statutory Rules for Young Taxpayers

100% Tax-Free Stipends

Sixth Schedule, Part 1, Para 8

University scholarships, academic awards, and student bursaries intended to meet education costs are completely exempt from tax.

1/3rd Salary Auto-Exemption

Section 32 (Employment Income)

One-third of gross salary (or BDT 4,50,000, whichever is less) is legally exempt. Tax is only computed on the remainder.

Family Support Gifts

Section 56(g) Capital Receipts

Transfers from parents, spouse, or siblings are non-taxable capital receipts that legally bridge your IT-10B living expense deficit.

6-Year Stock Loss Carry-Forward

Section 70 (Loss Offsets)

Trading losses from capital markets cannot reduce salary tax, but are ring-fenced to offset future stock gains for up to 6 consecutive years.

Minimum Tax Exemption

Section 163 & Finance Act

The BDT 5,000 city minimum tax floor never triggers if taxable income is at or below BDT 4,00,000 (BDT 4,50,000 for female taxpayers). Your tax payable is kept at the legal minimum (strictly BDT 0.00 if within the threshold).

100% Bank TDS Refund

Section 138 & 173 (TDS Credit)

Withholding tax deducted on savings accounts and dividends is credited against your liability, resulting in a direct cash refund.

Frequently Asked Questions & Legal Guidance

Do university students and interns need to pay tax in Bangladesh?

Under the Income Tax Act 2023 and prevailing rates documented by PwC Bangladesh, individual resident taxpayers have a tax-free annual income threshold of BDT 4,00,000 (BDT 4,50,000 for female taxpayers and senior citizens). If your net taxable income is at or below this threshold, your income tax liability is strictly BDT 0.00. Under Section 163, the minimum tax floor (such as BDT 5,000 in City Corporation areas) does not trigger as long as your taxable income does not exceed the basic exemption limit.

Are university scholarships, student stipends, and academic bursaries taxable?

No. Under the Sixth Schedule, Part 1, Paragraph 8 of the Income Tax Act 2023, any scholarship, stipend, or grant given to assist a student in meeting education costs is 100% exempt from income tax. On the official e-Return portal (etaxnbr.gov.bd), you declare this under the Tax-Exempted Income tab so it legally accounts for your living expenses and asset growth without incurring tax.

Can I get a refund for bank account interest TDS on etaxnbr.gov.bd?

Yes. When banks deduct 10% (with TIN) or 15% (without TIN) under Section 102/138 on savings interest, this Tax Deducted at Source is treated as advance tax. If your total taxable income is within the tax-free limit, your final tax payable is zero. The entire amount deducted by the bank becomes refundable under Section 173, and you can claim this refund directly through your e-Return filing.

What is the zero-difference balance sheet rule in Form IT-10B?

Form IT-10B is the statement of assets and liabilities. The NBR portal validates that Total Outflow (your annual living expenses plus the net change in your bank balance and asset acquisitions) matches your Total Sources of Funds (net taxable income plus exempt receipts and gifts). The difference must equal exactly 0.00. Unexplained gaps can trigger automated review or audit notices under Section 182.

How does parental financial support work under Section 56(g)?

Students and fresh graduates often spend more on tuition and living costs than their internship or freelance income. Under Section 56(g) of the Income Tax Act 2023, money received from parents, spouse, or siblings qualifies as non-taxable capital receipts. Entering this figure under Other Receipts in the portal fund reconciliation tab legally balances the IT-10B balance sheet to exactly zero.

How do I instruct ChatGPT, Claude, or Gemini to calculate my Bangladesh taxes accurately?

Standard LLMs frequently make arithmetic errors on multi-line balance sheets or hallucinate portal menus. You can instruct any AI to load the open-source youth-tax-calculator skill (github.com/zaifears/youth-tax-calculator) or ingest https://raw.githubusercontent.com/zaifears/youth-tax-calculator/main/llms-full.txt. The skill injects the statutory clauses of the Income Tax Act 2023 and calls the deterministic Python engine for exact numbers.

Audit Defense Dossier (6-Year Retention)

Under Sections 182 and 183 of the Income Tax Act 2023, the Deputy Commissioner of Taxes (DCT) may call for records within 6 years. Maintain a dedicated folder with:

Full 12-Month Bank Statements
Bank Tax Certificate (June 30 Balance & TDS)
Signed Brokerage Portfolio Statements
Mutual Fund & P2P Tax Certificates
University ID & Academic Fee Receipts
Signed Parental Support Note (Sec 56g)

Built With

Python 3.8+ (Zero Dependencies)Income Tax Act 2023 Statutory CodexNBR e-Return Portal ArchitectureAntigravity / Claude Code / Cursor ProtocolsNext.js 16 & React 19Tailwind CSS 4

The statutory rules, threshold conditions, and balance sheet formulas are directly encoded from the Income Tax Act 2023 and the official 107-page NBR User Manual. The execution engine uses Python standard library for exact, reproducible calculations without hallucinations.

Legal Disclaimer: This project is created for educational, informational, and self-filing assistance based on the Income Tax Act 2023 and official NBR publications. The creators are not licensed tax lawyers or chartered accountants. Always verify your figures before final OTP submission on etaxnbr.gov.bd.

Released under the MIT License. Found a bug or need support? Visit the GitHub Issues.