Enterprise Resource Planning System — Offline-first GST billing & full ERP suite
Developed by David |
Nexuzy Lab |
Version 3.0.0
Hype ERP is a complete desktop ERP + billing software built with Python & Tkinter, developed by Nexuzy Lab and led by David (DevilOne).
It runs fully offline, syncs to Firebase when online, generates GST-compliant PDF invoices, and includes a full suite of 20 enterprise modules covering billing, accounting, inventory, HR, payroll, CRM, manufacturing, and more — all in one system.
Every invoice, bill, and PDF generated by this software is permanently branded Hype ERP — this branding cannot be removed.
- GST-compliant invoice generation (SGST, CGST, IGST)
- Barcode / SKU product lookup during billing
- Walk-in and named customer support
- Multiple payment methods — Cash, Card, UPI, Credit
- Invoice PDF export with permanent Hype ERP header/footer
- Auto invoice numbering with custom prefix (e.g.
INV-202506-0001) - Customer GSTIN capture on invoice
- Per-item GST rate on each invoice line
- Payment status tracking — Paid, Unpaid, Partial
- Invoice notes / remarks field
- Offline-first — all data stored in local SQLite database
- Add, edit, and delete products with full details:
- Product name, barcode/SKU, category, category code, unit
- Purchase price and selling price
- Stock quantity and minimum stock threshold per product
- GST rate and HSN code
- Auto low-stock alerts — products below minimum threshold highlighted in red/yellow
- Dead stock analysis — detects items unsold for 90+ days
- Quick Price Adjust — change selling price of any product directly from the product list
- Quick Restock — add stock quantity in one click
- Stock adjustment and purchase price tracking
- Custom product categories — create and manage your own category list
- Auto GST rate population when a category is selected
- Auto HSN code population from category-to-HSN mapping
- Immediate Firebase sync when a new product is saved
- 20 pre-loaded GST rate profiles: Cosmetics, Grocery, Drinks, Electronics, Clothing, Food & Beverage, Dairy, Pharmaceuticals, Automotive, Furniture, Books, Education Services, Healthcare, Agriculture, Construction, Metals, Chemicals, Tobacco, Services, Petroleum Products
- Custom GST rate manager — Add, Edit, Delete category-wise SGST, CGST, IGST rates
- GST rates saved to local database — persist across sessions
- Full Tax / GST ERP module for advanced tax management
- 20 default HSN codes pre-mapped to standard product categories at startup
- Dedicated HSN Config window — add, edit, delete category-to-HSN-code mappings
- Auto-fills HSN code when a product category is selected during product creation
- Standalone HSN setup wizard (
setup_hsn_config.py) for initial configuration
- Full Tally-style accounting window (separate module, 31KB+)
- Double-entry bookkeeping
- Chart of accounts
- Journal entries
- Trial balance
- Profit & Loss statement
- Balance sheet
- Ledger views
- Day-book style daily business transaction recording
- Full accounting module available from ERP menu
All modules are available from the ERP Main Menu and open as separate windows:
| Module | What It Does |
|---|---|
| 🏦 Accounting | Core business ledger and accounts |
| 🧾 Invoice | Invoice and account-invoice management |
| 🏛️ Asset | Fixed asset tracking |
| 💰 Tax / GST | Tax and GST rate configuration |
| 🏦 Banking | Bank account and statement management |
| 📈 Sales | Sales orders and sales pipeline |
| 🛍️ Purchase | Purchase orders and supplier buying |
| 👥 Vendors | Supplier and vendor management |
| 📦 Inventory | Full stock and inventory control |
| 🏭 Manufacturing | Production and manufacturing workflows |
| 👷 HR | Human resources and employee management |
| 💸 Payroll | Salary processing and payroll management |
| 🤝 CRM | Customer relationship management |
| 📁 Projects | Project tracking and management |
| ⏱️ Timesheet | Employee work-time recording |
| 🔵 POS | Point-of-sale retail billing terminal |
| 🚚 Shipping | Package and delivery management |
| ✅ Quality Control | Product and process quality checks |
| 📣 Marketing | Business marketing and campaign management |
| 📊 Reporting | Business analytics and report generation |
- Save and manage customer details — name, phone, email, address, GSTIN
- Track total purchases and visit count per customer
- Customer history view sorted by total spending
- CRM module for relationship management and follow-up workflows
- Dedicated vendor/supplier module (separate from CRM)
- Manage supplier records, contacts, and purchasing information
- Vendor-linked purchase tracking
- Employee records management from HR module
- Payroll processing and salary management from Payroll module
- Timesheet recording for work-time tracking
- Create and track projects from the Projects module
- Record and monitor employee time using the Timesheet module
- Production workflow management
- Supports manufacturing-related business operations
- Package and delivery tracking from the Shipping module
- Quality control checklists and verification workflows
- Business marketing campaign management
- Separate module for marketing-related business activities
- Live dashboard showing:
- Total invoices
- Total products
- Low stock item count
- Total revenue (all time)
- Today's revenue
- Sales report with invoice number, date, customer, subtotal, GST, total, payment method, and status
- Business analytics from dedicated Reporting ERP module
- 7-day AI sales prediction — forecasts the next 7 days of sales based on historical data
- Smart product search — fuzzy matching for fast product lookup during billing
- Anomaly detection — identifies suspicious or unusual transactions automatically
- AI price suggestions — recommends selling prices based on purchase price and market patterns
- Full AI Assistant window for model management and AI chat-style interaction
- Bi-directional sync between local SQLite and Firebase Firestore
- Offline-first — works fully without internet; syncs when connection is available
- Auto-restore — if local database is blank on first launch, automatically pulls all data from Firebase
- One-click full sync and one-click cloud backup
- Firebase Settings GUI — configure Firebase from inside the app without editing config files
- Encrypted service account key (
.encfile) — Firebase credentials are never stored as plaintext - Cloud data scoped per store under
stores/{store_id}/path - Firebase Deep Dashboard — advanced Firestore viewer with manual sync controls
- Firebase Upload Manager — bulk data upload for large datasets
- Firebase CLI sync tool — run sync without launching the GUI (useful for scheduled backups)
- Multi-store support — each store has name, address, phone, email, GSTIN, owner name, state code, and logo
- State code configuration for correct intra/inter-state GST calculation (default: 29 Karnataka)
- Custom invoice prefix per store
- Active/inactive store switching
- Shop name
- Owner name
- Shop address
- Phone number
- GSTIN
- Invoice prefix
- State code
- Firebase configuration (GUI-based, no file editing required)
- Multi-user login with username and password
- Role-based access — Admin, Manager, Cashier
- SHA-256 hashed passwords (auto-migrated from plain text on first run)
- Login runs in background thread — UI never freezes
- Firebase-fallback login — if user not found locally, restores from Firebase automatically
- Windows single-instance lock — prevents opening two copies of the app simultaneously
- Auto-installer (
auto_install.py) — checks and installs missing dependencies at startup - Works as a standalone Windows
.exe(built with PyInstaller + Inno Setup) - Database stored at
%LOCALAPPDATA%\HypeERP\in EXE mode for safe multi-user Windows installs - Crash logs written automatically to
%LOCALAPPDATA%\HypeERP\hype_erp.log - Silent database schema migration on every startup — safe upgrades without data loss
hype-billing-system/
├── main.py # Main application entry point
├── billing_window.py # Dedicated billing screen (35KB)
├── tally_features.py # Tally-like accounting suite (31KB)
├── ai_assistant.py # AI features and assistant (21KB)
├── firebase_sync.py # Firebase sync manager
├── firebase_deep.py # Advanced Firebase dashboard (20KB)
├── firebase_upload_manager.py # Bulk Firebase upload manager (18KB)
├── firebase_sync_cli.py # CLI sync tool
├── auto_install.py # Dependency auto-installer
├── encrypt_key.py # Firebase key encryption tool
├── serviceAccountKey.enc # Encrypted Firebase credentials
├── setup_hsn_config.py # Standalone HSN setup wizard
├── modules/
│ ├── erp_main_menu.py # 20-module ERP launcher
│ ├── account.py # Accounting module
│ ├── account_invoice.py # Invoice module
│ ├── account_asset.py # Asset module
│ ├── account_tax.py # Tax / GST module
│ ├── account_statement.py # Banking module
│ ├── sale.py # Sales module
│ ├── purchase.py # Purchase module
│ ├── vendor_module.py # Vendor management (16KB)
│ ├── stock.py # Inventory module
│ ├── production.py # Manufacturing module
│ ├── hr_module.py # HR module
│ ├── payroll_module.py # Payroll module
│ ├── crm_module.py # CRM module
│ ├── projects_module.py # Projects module
│ ├── timesheet.py # Timesheet module
│ ├── pos_module.py # POS module
│ ├── stock_package.py # Shipping module
│ ├── quality_control.py # Quality control module
│ ├── marketing.py # Marketing module
│ ├── reporting_module.py # Reporting module
│ ├── hsn_config.py # HSN code configuration (16KB)
│ ├── data_service.py # Data service layer (20KB)
│ ├── mode_selector.py # Online/Offline/Hybrid mode switcher
│ ├── firebase_settings_ui.py# Firebase GUI config
│ ├── scrollable_frame.py # Reusable scrollable frame widget
│ └── window_utils.py # Window icon utilities
├── tests/
│ ├── test_firebase_upload.py
│ ├── test_fixes.py
│ └── verify_fixes.py
├── add_bill_column.py # DB migration: add bill column
├── add_product_codes.py # Batch add product codes
├── check_product_codes.py # Product code audit tool
└── main_integration_patch.py # Integration patch for upgrades
- Python 3.8+
- Windows 10 / 11 (recommended)
- Internet connection (optional — for Firebase sync)
git clone https://github.com/david0154/hype-billing-system.git
cd hype-billing-system
python auto_install.py # installs all required packages automatically
python main.py| Username | Password | Role |
|---|---|---|
| admin | admin123 | Admin |
Change the default password immediately after first login.
- Create a Firebase project at console.firebase.google.com
- Download
serviceAccountKey.json - Place the file in the project root folder OR use the in-app Firebase Settings screen
- The app will automatically encrypt the key and sync data to Firestore
MIT License — see LICENSE for details.
Every invoice and PDF generated by this software includes permanent Hype ERP branding that cannot be removed.
 David Lead Developer & DevilOne Nexuzy Lab |
 Nexuzy Lab Organization & Publisher |
⭐ Star this repo if you find it useful! 🐛 Found a bug? Open an issue
Powered by Hype ERP v3.0.0 — Developed by Nexuzy Lab & Lead Developer David (DevilOne)