🇧🇩 বাংলা সংস্করণের জন্য এখানে ক্লিক করুন (Read in Bangla)

This is an AI-powered guide to help you fill out your Bangladesh NBR e-Return (etaxnbr.gov.bd). Think of it as having a smart, digital assistant that reads your tax documents, carefully types the numbers into the government website for you, and stops right before saving. You are always in control—you review everything, pay, and click the final submit button yourself.

What started as a fun Facebook post has now become a real, working tool to save you time and headache.

Disclaimer: This is not professional tax advice. This guide helps you navigate the website's mechanics. The numbers you enter are your responsibility. Our built-in safety rules ensure the AI can never pay or submit the form for you.

Use any AI you like. While I used opencode, this method works perfectly with any modern AI agent (like Claude Code, Gemini CLI, Cursor, etc.). It uses a standard bridge called "MCP" that simply allows the AI to control a web browser.

Even as a high-tech professional, I realized I had very little financial literacy when it came to managing my own taxes. I wanted to change that. I wanted to build true financial confidence, so I decided to tackle filing my own tax return on the online portal myself.

As I started working through the form, I struggled to wrap my head around the underlying logic—why certain figures needed to go in specific boxes, and how the portal’s internal rules were actually set up. On top of that, navigating the website and typing everything in was confusing and frustrating.

That is when the lightbulb went off: I could use an AI agent to guide me through the mechanics of this whole process.

It took me nearly a whole month of part-time work—late nights and weekends, juggling my day job and family time—to figure out how to make this work safely. Having spent years in the AI industry and writing 11 books on AI in Bangla to help everyday people use AI in their daily lives, building this tool felt like a natural next step.

This is my gift to the community. You shouldn't have to spend a month trying to decipher this system. Take what I have built, skip the headache, and save your valuable time.

This isn't a magical software you buy; it is a blueprint for using AI to safely interact with government websites. Here is the simple breakdown of how it works:

1. The Brain (AI Agent): You give it instructions.
2. The Hands (Playwright MCP): A tool that lets the AI "click" and "type" on a web browser.
3. The Memory (JSON Files): Simple text files where you keep your numbers (like last year's data and this year's income) so the AI knows exactly what to type.

It is basically a starter kit for building your own personal "digital tax lawyer." And once you learn how it works here, you can use the same trick for passport portals, utility bills, or any online form.

This repository (repo) is a template. The idea is to copy it (which is called "forking"), customize it with your own numbers, and use the safety rules I have already set up.

What you keep from me:

• The strict safety rules (the AI can navigate and fill, but never submit).
• The step-by-step workflow.
• The setup files that connect the AI to your browser.

What you change for yourself:

• The simple data files where you put your actual income numbers.
• Your personal login details (which you type yourself).

Are you completely new to AI? Stop here and read the Basic Guide (Start from Zero) first. It is written for absolute beginners.

If you are ready, here is the flow after you copy (fork) this project:

1. Read up: Skim the tax guide and the agent runbook so you know the plan.
2. Prepare your data: Don't type numbers by hand! Put your tax PDFs in a folder and run our helper tool:

   python tools/extract.py --docs /path/to/your-documents --out payload/staging

   This reads your files and helps you fill out your baseline and deltas JSON templates.
3. Optimize: Run our optimization tool to see if you can save money on your taxes this year.
4. Connect the browser: Run the setup command (npx @playwright/mcp install-browser chrome-for-testing) so the AI has a browser to work with.
5. Recon & Fill: Ask the AI to log in. You type your password. Then, sit back and watch as the AI navigates the portal, fills in the boxes based on your files, and safely clicks Save Draft.
6. You take the wheel: Review the draft, pay any taxes owed, and hit Submit yourself.

• The AI is allowed to: click around, navigate pages, type your numbers, and click Save Draft.
• The AI will NEVER: click Pay Now, click Submit Return, or reset your calculations.
• Your passwords and OTP pins are always typed by you. The AI never sees them or stores them.

Your real tax numbers are completely private. We have set up the system (using .gitignore) so your personal files, passwords, and screenshots are never accidentally uploaded to the internet.

Built by Rakibul Hassan in my spare time. I have written 11 books on AI in Bangla and I believe technology should make our lives easier, not harder.

If this saves you a stressful weekend, please star the project, share it with friends, and enjoy your free time!

MIT License