HomeoVault is a specialized, secure, and intuitive inventory management system designed specifically for Homeopathic Pharmacies and Practitioners. Built with reliability and ease of use in mind, it handles the unique requirements of medical inventory, including potency tracking, expiry management, and strict stock control.
- Detailed Tracking: Record Medicine Name, Potency (e.g., 30C, 200C), Form (Dilution, Globules), Bottle Size, Manufacturer, and Batch Number.
- Unique SKU System: Automatically prevents duplicate entries for the same batch/product combination.
- Negative Stock Protection: Ensures your inventory count never drops below zero.
- Expiry Awareness: Automatically flags expired medicines and prevents accidental sales (with manager override).
- Startup Health Scan: Runs a comprehensive diagnostic on every launch to identify expired batches and low-stock items.
- Data Integrity: Performs database integrity checks on startup to prevent data corruption.
- Real-Time Analytics: View low-stock alerts and expiry warnings instantly.
- Transaction History: Complete audit trail of all stock additions, sales, and adjustments.
- One-Click Export: Export your entire inventory to CSV for external reporting or auditing.
- Auto-Backups: Automatically backs up the database to
backups/on every restart. - Cross-Platform: Runs seamlessly on macOS, Windows, and Linux.
- Standalone Mode: Can be compiled into a single executable file.
- Backend: FastAPI (Python) - High performance, easy to maintain.
- Database: SQLModel (SQLite) - Simple, file-based, reliable.
- Frontend: Vanilla JavaScript / HTML5 / CSS3 - Lightweight, fast, no build step required for UI.
- Distribution: PyInstaller - For creating standalone executables.
- Python 3.9 or higher
-
Clone the Repository
git clone https://github.com/pronzzz/homeovault.git cd homeovault -
Create a Virtual Environment
python3 -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
-
Install Dependencies
pip install -r requirements.txt
To start the server and automatically launch the dashboard:
macOS / Linux:
./run.shWindows:
Double-click run.bat or run:
run.batThe application will be available at http://localhost:8000.
- User Guide - Detailed instructions on using the application.
- Contributing Guidelines - How to contribute to HomeoVault.
- Code of Conduct - Our community standards.
You can package HomeoVault into a single file for distribution:
python3 build.pyThe executable will be created in the dist/ folder.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by Pranav Dwivedi