Inventory Toolkit is an open-source toolkit for retail inventory processing.
It automates Stock Processing, Inventory Reconciliation (Cruces), and Year-over-Year (YoY) Sales Analysis using Microsoft Excel workbooks while keeping business rules outside the source code through a profile-based configuration system.
The project was originally developed to solve real-world inventory problems and has since evolved into a reusable toolkit.
- 📦 Stock Processing
- 🔄 Inventory Reconciliation (Cruces)
- 📊 Year-over-Year (YoY) Sales Reports with Monthly/Annual Segmentation
- 👤 Multiple Profiles
- ⚙ JSON-based Configuration
- 🖥 Interactive Command Line Interface (with Unicode/Emoji support)
- 📂 Native File Picker
- 📊 Automatic Excel Column Detection
- 🪟 Windows Launcher Scripts
- 🔧 Configuration Wizard
InventoryToolkit/
cli/ core/ engine/ profiles/ examples/
README.md CHANGELOG.md LICENSE
Inventory Toolkit includes two Windows launcher scripts.
Run this only once after cloning the repository.
It will:
- create the Python virtual environment
- install dependencies
- prepare the project
Launches Inventory Toolkit.
This is the file intended for everyday use, optimized with UTF-8 encoding support for terminal rendering.
- Run Setup Environment.bat (first time only).
- Run Inventory Toolkit.bat.
- Create or select a profile.
- Choose:
- Stock Processing
- Inventory Reconciliation
- Generate YoY Sales Report
- Select the required Excel files and parameters.
- Wait for processing to finish.
Inventory Toolkit separates business rules from the processing engine.
Each company can have its own independent profile.
Documentation:
➡ profiles/demo/README.md
A complete example dataset is included for testing.
Documentation:
➡ examples/demo/README.md
Additional documentation is available inside each module.
| Module | Description |
|---|---|
| cli | User Interface |
| core | Shared utilities |
| engine | Processing engines (Stock, Cruces, YoY Reports) |
| profiles/demo | Example configuration profile |
| examples/demo | Example spreadsheets |
- v1.3.0 Reports ✅
- v1.3.1 English migration
- v1.3.2 Stock/Cruces modularization
- v1.3.3 Logging
- v1.3.4 Testing
- v1.3.5 Documentation
MIT License