项目的 README,来自 github.com/IamRamgarhia/Free-GST-Billing-Software。合并为一个 markdown 文件:README.md。
GST invoices, GSTR-1 and GSTR-3B files, GSTR-2B matching, TDS / TCS, stock, purchases and reports — free, on your own computer.
Free forever. Works offline. No tracking. No ads. No signup. Open source, so you can check every claim yourself.
A free invoice maker for shop owners, freelancers, consultants, traders and small businesses in India: make a GST invoice, quotation, bill of supply, credit note or delivery challan in minutes and save it as a PDF. A free, open-source alternative to Tally, Vyapar, Zoho and myBillBook.
Each button always gets the newest version · Windows: the Setup program (about 35 MB) · Apple Mac: one line in Terminal · Linux: the AppImage, or the .deb on the release page · steps for every system
Every link gets the newest version. Your invoices stay on your computer, whichever way you pick. All files are on the latest release page, under Assets.
Free-GST-Billing-Windows-Setup.exe (about 35 MB).No administrator password and nothing else to install. Updates: the app shows Update to vX → Update Now. Removing: Windows Settings → Apps → Installed apps → Free GST Billing → Uninstall (your books are kept unless you choose to delete them). Full guide: Install on Windows.
Open Terminal: press Cmd + Space, type Terminal, press Return.
Paste this line and press Return:
curl -fsSL https://raw.githubusercontent.com/IamRamgarhia/Free-GST-Billing-Software/main/install.sh | bash
It installs in a few minutes and opens the app. macOS shows no warning. From then on, open Free GST Billing from Launchpad or the Dock. To update, use Update in the app, or paste the same line again; your books are kept.
For Intel and Apple silicon Macs, macOS 11 or newer. Full guide: Install on a Mac.
.deb (Ubuntu, Linux Mint, Debian)
free-gst-billing_<version>_amd64.deb.sudo apt install ~/Downloads/free-gst-billing_*_amd64.debAppImage (any 64-bit Linux)
Free-GST-Billing-Linux-x86_64.AppImage.chmod +x Free-GST-Billing-Linux-x86_64.AppImage).Both keep your books in ~/.local/share/free-gst-billing-data. To update, install or use the new file the same way. Full guide: Install on Linux.
docker-compose.yml from the latest release. It uses the image ghcr.io/iamramgarhia/free-gst-billing.FGSB_PIN, then run docker compose up -d.docker logs free-gst-billing shows, on your phone or PC.Every device is paired with a one-time code and the PIN, over HTTPS; nothing gets in without pairing. Never forward its port on your router. To update: put the new version in the image: line, then docker compose pull and docker compose up -d; the books stay in the volume. Step by step: On a NAS: Docker.
One line on Windows (no download box to click through): press Windows + R, paste, press Enter:
powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol='Tls12'; irm https://raw.githubusercontent.com/IamRamgarhia/Free-GST-Billing-Software/main/install.ps1 | iex"
It installs to %LOCALAPPDATA%\Programs\Free GST Billing, adds the icons and opens the app. The same line updates or repairs it; your data is backed up first and never touched.
The ZIP (Linux or a NAS without Docker, or a Windows PC where you would rather not install anything):
Free-GST-Billing.zip and extract it first (right-click → Extract All).From the source code (developers):
git clone https://github.com/IamRamgarhia/Free-GST-Billing-Software.git
cd Free-GST-Billing-Software
npm install
npm start # builds and serves on http://localhost:47371
npm run dev # live reload on http://localhost:5173
Every install puts a Free GST Billing icon on your computer (the blue B). Click it every day: it starts the app if needed and opens it. Update, backup, restart and stop are in the app's ⚙ Control Panel. Don't use the browser's own Install app button: that icon cannot start the app.
127.0.0.1).resmon → Network) shows no outside connections with Offline mode on. Block it in the firewall if you like: the app keeps working, only the update check stops.| What | When | Offline mode |
|---|---|---|
| Check for a new version (asks GitHub for the version number; nothing about you is sent) | A few seconds after opening, then every 6 hours | Stopped |
| The public supporters list (read from GitHub; nothing is sent) | When Support & About shows | Stopped |
| Your own Google Drive | Only if you set it up | Automatic copies stopped |
| Installing and updating | When you click Install / Update | Only when you click |
| Help pages, Report a problem, WhatsApp, GST portal links | When you click them | Only when you click |
| Phone / tablet access: your own Wi-Fi only, never the internet | Only if you turn it on | Not affected |
That is the complete list. Every address the app connects to
Real screens from the app, with a made-up demo business (DiceCodes, fake GSTIN and bank details).
![]() Dashboard: overdue invoices, totals, low stock and every invoice in one list. |
![]() New invoice: fill in the form, the preview updates as you type. |
![]() Exports under LUT: bill in dollars, no IGST, the declaration printed for you. |
![]() GST returns: GSTR-1 and GSTR-3B built from your invoices. |
![]() Cash book: cash in and out, with the cash in hand. |
![]() Dark mode: invoices still print in normal colours. |
More screenshots, next to the steps they show, in the documentation.
Next: GST Returns in the sidebar makes the GSTR-1 and GSTR-3B files for the month. Every screen is explained in the documentation; the ? next to each section opens its page.
Enter your invoices and purchase bills as usual. At the end of the month open GST Returns: check GSTR-1, download its JSON and upload it on gst.gov.in; then check GSTR-3B and download its JSON or copy the figures. GSTR-2B matching shows which purchase bills your suppliers have filed. A step-by-step filing guide is in the app, including nil returns. Close the books after filing so a filed month cannot change by mistake.
One update every Saturday. Dates are plans: if a week fills up, the least-used item moves to the next week, and we say so on its issue.
Next: 21 November: an MRP column (#189, #192), a statement for each supplier (#148, #194), add GSTR-2B bills as purchase bills (#175), invoices that always fit A4 (#188), and easier phone pairing and updates. 28 November: TDS / TCS part 2 (#180). December: a balance sheet and separate bank and cash ledgers (#148, #189).
Just released: v1.10.85 (14 November 2026)
Waiting for more requests (add a 👍 to the issue if you need it; we build first what most users ask for): staff logins with roles (#155), warranty tracking (#122), batch and expiry (#192).
Not planned: anything that needs an online account, a paid GST provider (GSP) or a server of ours and would send your data out of your computer: filing or fetching data directly from the GST portal (#139, #173), live bank feeds, payment-gateway links, an online store, cloud sync. Also a separate Android app (use the app on your phone over Wi-Fi instead) and a separate POS screen.
Every change: CHANGELOG.md, also in the app under Support & About → What's new.
Support the project: ⭐ star this repo · tell another business · report a bug or ask for a feature · 💛 UPI, any amount: princeramgarhiaa-1@okaxis (also as a QR code in the app, under Support & About).
Work with DiceCodes: custom software and web apps, customising this app for your business, setup and data migration, support plans. [email protected]
None of these touch your invoices.
| You see | What to do |
|---|---|
| "Windows protected your PC" | The Setup isn't code-signed yet. Click More info → Run anyway. |
| "Some files are missing" or "extract the ZIP first" | The app can't run from inside the ZIP. Right-click the ZIP → Extract All, open the new folder, then double-click Free GST Billing - WINDOWS. |
| "Cannot connect to server", "This site can't be reached", or a blank page | The app isn't running. Click the Free GST Billing icon. |
| "Still starting…" | The first start after an install or update is slow while antivirus checks the new files. Wait a minute, then open the app from its icon again. |
| The update finished but nothing changed | Reload the page with Ctrl + F5. |
| "The app cannot write to its own folder" | Don't keep the ZIP copy in C:\Program Files. Move the folder to Documents or D:\ and open it from there. |
| "Free GST Billing is already installed on this computer, in: …" | You extracted a new ZIP into a new folder. Your invoices are in the folder it names: click Update the installed copy, then delete the new folder. |
| Forgot the app PIN | In the app folder, create an empty text file named RESET-PIN and reload the app. The PIN is removed; invoices aren't touched. |
| Mac / Linux: "Node.js … is too old" or "not installed" | The message lists the command for your system (apt, dnf, pacman, apk, brew). Install Node.js 20, then run the install again. |
Still stuck? Report a problem with the message and a screenshot (hide your GSTIN and bank details). More answers: troubleshooting guide.
Yes. MIT-licensed open source: no subscription, no premium tier, no trial that expires, no limits.
No. Your invoices, clients, products and settings are files on your computer. Nothing leaves it unless you turn on the optional Google Drive copy, and then it goes to your own Drive.
The app makes the GSTR-1 and GSTR-3B files in the GST portal's format, and the GSTR-2B matching. You upload them on gst.gov.in yourself; no third party in between. Filing straight from the app would need a paid GST provider and would send your data out, so it is not planned.
Yes. Only installing, updates, help pages and the optional Google Drive copy use the internet. Turn on Offline mode and it never goes online by itself.
Yes: 23 countries and 20 currencies, with the right tax name (GST, VAT, SST and others) and the amount in words in that currency. Exports from India under LUT print the declaration for you. Choose Outside India or Both in the first-run setup, or later in Settings.
Yes. Add your business once, pick a client and items, and save the invoice as a PDF or print it. Not GST-registered? Use Bill of Supply. Quotations turn into an invoice in one click.
Yes, as many as you like, each with its own GSTIN, bank accounts, logo, numbering and separate books (Settings → Profiles). Switch from the business name at the top of the sidebar.
Updates replace only the app's own files. Your invoices, clients, products, settings and saved PDFs are never touched, and a backup is made first.
Not as a separate app. Since v1.10.85 you can use the app from a phone or tablet on the same Wi-Fi as your computer: Use on a phone or tablet.
Yes. Clients, products, invoices and purchases import from CSV or Excel (.xlsx), and from Vyapar and Tally exports (Dashboard → CSV import / export). A template is there to download.
Not yet. The app has no logins on its server, so anyone who found the address could read your books. Why, and what to do instead. For other devices, use it on your own Wi-Fi.
Tech stack: React 19 and Vite 7 (the screens), Express 5 on Node.js (the local server), jsPDF + html2canvas (PDFs), tesseract.js (reading bill photos), qrcode, DOMPurify. Data is stored as JSON files; there is no database.
Project layout
server.js the local server (port 47371)
src/ the app: App.jsx, components/, utils/, store.js
tests/ the browser test suite (smoke.mjs)
scripts/ builds and unit tests
docs-site/ the online documentation
installer/ the Windows Setup
packaging/ the Linux packages and the Docker image
release-templates/ the ZIP's launchers and scripts
data/ your books when run from the source (not in git)
Google Drive (optional): in the Google Cloud Console create a project, enable the Google Drive API, create an OAuth 2.0 Client ID (Web application) with http://localhost:47371 as an authorised JavaScript origin, then paste the Client ID in Settings → Data & Backups and click Connect Google Drive.
Contributing: fork the repository, make a branch, commit, and open a pull request. Bug reports, feature ideas and documentation fixes are welcome on Issues.
MIT License: free to use, change and share.
⬇ Download · ⭐ Star on GitHub · 📖 Documentation · 🐛 Report a problem
Free GST billing software India · Free GST invoice software for small business · Open source GST billing software · Free alternative to Tally Prime Vyapar Zoho Books ClearTax myBillBook Marg ERP · No subscription invoice software · Offline billing software India · GSTR-1 GSTR-3B filing software free · GSTR-2B reconciliation tool free · TDS Form 26Q TCS Form 27EQ software · Section 194Q 206C(1H) TCS calculator with ₹50 lakh threshold · UTGST invoice software · CGST SGST IGST auto calculator · E-way bill JSON generator free · HSN SAC code invoice generator · Bill of Supply generator · Delivery Challan software · Credit Note Debit Note software · Proforma invoice estimate software · Composition scheme invoice · UPI QR invoice maker · Thermal receipt printer software 58mm 80mm · Direct vector thermal print software · POS billing software free India · Retail shop kirana billing software · Restaurant cafe billing software · Freelancer consultant invoice software India · Multi-currency invoice generator (USD EUR GBP AED SGD AUD) 23 countries · Country-aware VAT SST MwSt TVA PPN tax labels · Recurring invoice software · Payment receipt voucher software · Bulk PDF invoice export · Google Drive backup billing software · Automatic daily backup + Trash bin · Multi-business multi-GSTIN switcher · Multi-language invoice Hindi Tamil Marathi Bengali · Dark mode PWA billing app · Rich-text Terms & Conditions with 13 India presets · OCR bill scan tesseract · Ctrl+K command palette · Split-view live PDF preview · Income Tax (ITR) computation old vs new regime 234B 234C · Client credit balance carry-forward · Watermark DUPLICATE DRAFT PDF · Rule 48 multi-copy (Original Duplicate Triplicate) · WhatsApp share invoice PDF · Self-file GST return software · GST invoice software without subscription · No signup no login billing software · Vyapar alternative open source · Tally alternative free · Zoho Books alternative · ClearTax alternative · myBillBook alternative · Marg ERP alternative · Made in India
Made in India 🇮🇳 · DiceCodes