Inventory Toolkit is an open-source toolkit for retail inventory processing.
It automates Stock Processing and Inventory Reconciliation (Cruces) 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)
- 👤 Multiple Profiles
- ⚙ JSON-based Configuration
- 🖥 Interactive Command Line Interface
- 📂 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.
- Run Setup Environment.bat (first time only).
- Run Inventory Toolkit.bat.
- Create or select a profile.
- Choose:
- Stock Processing
- Inventory Reconciliation
- Select the required Excel files.
- 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 |
| profiles/demo | Example configuration profile |
| examples/demo | Example spreadsheets |
- GUI
- Additional documentation
- Configuration templates
- Engine improvements
- Additional validation
MIT License