replenishment
github.com
- Free plan
What replenishment is
replenishment is a Python library for simulating stock replenishment, optimizing policies, and visualizing decisions. It is designed for teams that want to model policies against historical or synthetic demand. Optimization workflows include safety stock based on mean forecasts, k*RMSE or k*MAE, and percentile targets. For k*RMSE and k*MAE, safety stock can optionally rise when lead-time forecast quantities exceed a baseline. The library also supports converting between CSV or DataFrame inputs and simulation configurations, and comparing policies on replenishment time series. Installation is available from PyPI with `pip install replenishment`. The project is tested on Python 3.10, 3.11, 3.12, and 3.13; listed dependencies include pandas, Polars, PyArrow, matplotlib, ipykernel, and scienceplots. The package is MIT licensed and classified as Alpha. Repository notebooks cover policy variants, synthetic data generation, and loading stock replenishment data. The project welcomes contributions and links to setup, test, and pull request guidance.
Who it suits
It suits Python teams evaluating replenishment policies with historical or synthetic demand. Teams seeking minimum order quantities, case-pack constraints, or promotion-aware demand handling should note these are identified as areas for future contribution.
Good to know, and what to watch
- Simulates policies against historical or synthetic demand
- Offers mean, error-based, and percentile policy workflows
- Compares policies on replenishment time series
- Works with CSV or DataFrame inputs
- Tested on Python 3.10 through 3.13
- Classified as Alpha
- Minimum order quantities remain future work
- Case-pack constraints remain future work
- Promotion-aware demand handling remains future work
Plans
Every plan and priceOpen source library
Open source
Getting started
- Open the replenishment GitHub repository
- Install the package from PyPI with `pip install replenishment`
- Prepare historical or synthetic demand data as CSV or DataFrame inputs
- Move the inputs into simulation configurations
- Run a policy workflow such as mean-forecast, k*RMSE, k*MAE, or percentile targets
- Use the notebooks for policy variants, synthetic data, or stock-replenishment loading
- Compare policies on replenishment time series
The Club's review
Overview
Replenishment is a Python library for modeling stock decisions rather than running a replenishment operation. It is best suited to analysts and planning teams who want to compare policies in code. Its focused simulation and optimization workflows are useful, but teams that depend on order and promotion constraints will need capabilities beyond its current scope.
Key features
The library simulates policies against historical or synthetic demand and supports visual comparison across replenishment time series. This lets teams examine how candidate approaches behave against different demand scenarios, rather than relying on a single policy in isolation.
Optimization workflows include mean-forecast safety stock, k*RMSE and k*MAE, and percentile-target policies. For the k*RMSE and k*MAE approaches, safety stock can optionally increase when lead-time forecast quantities rise above a baseline. That gives planners a way to make buffers responsive to higher forecasts; it does not address every operational rule that can shape a replenishment decision.
CSV and DataFrame inputs can be moved into simulation configurations, with notebooks covering policy variants, synthetic data generation, and stock data loading. Installation is through PyPI with pip install replenishment. The package is tested on Python 3.10, 3.11, 3.12, and 3.13. Its dependencies include pandas, Polars, PyArrow, matplotlib, ipykernel, and scienceplots, so it belongs in a Python-based analytical workflow rather than a standalone planning interface.
The project welcomes contributions, with guidance for setup, tests, and pull requests. Its MIT license permits open-source use, while its Alpha development status is a reason for teams to assess its maturity before depending on it. Minimum order quantities, case-pack constraints, and promotion-aware demand handling are future contribution areas, making the library a poor fit when those rules are essential.
Pricing
The Open source library plan costs free and includes a Python package under the MIT license. There are no paid tiers or seat-based limits described. It is a straightforward fit for teams able to install and work with the package; the trade-off is that it offers a modeling library, not a complete operational replenishment system.
Platforms
Replenishment is distributed as a Python package through PyPI. Its tested Python versions are 3.10 through 3.13; the project does not describe a separate desktop or web application.
Who it's for
Choose replenishment if your team is comfortable with Python and wants to simulate historical or synthetic demand, compare safety-stock policies, and shape its own data workflows. Look elsewhere if you need built-in handling for order quantities, case packs, or promotion-aware demand, or if you need an operational interface rather than a library to incorporate into your own work.
Pros and cons
- Pros: Multiple policy optimization workflows make it possible to compare mean-forecast, error-based, and percentile-target approaches.
- Pros: Historical and synthetic demand simulation, visual comparisons, and CSV/DataFrame workflows support a range of analysis setups.
- Pros: The free, MIT-licensed package is available from PyPI and is tested across four Python versions.
- Cons: Alpha status makes it a less settled choice for teams seeking a mature dependency for critical planning.
- Cons: Minimum order quantities, case-pack constraints, and promotion-aware demand remain outside its current scope.
- Cons: Python packaging and dependencies make it less suitable for teams seeking a ready-made planning application.
Alternatives
For another free open-source Python package, consider Stockpyl. supplychainpy is another free option, distributed as a source package through PyPI.
For a paid platform with a free plan and free trial, Lokad offers supply-chain optimization on the web. Sophus Inventory Optimization is another paid option, with self-hosted and web availability and pricing discussed through a demo. Flowlity may suit teams looking for a web-based paid service: its Lite plan costs €249 a month, covers up to 5,000 SKUs, and uses CSV upload without ERP integration.
ZebraDesigner focuses on barcode label and tag design and printing, while Creo is a paid design platform. Manhattan Active Inventory Replenishment is another paid option for replenishment. Browse Inventory Optimization Software for more options.
Verdict
Replenishment is a strong fit for Python-capable analysts who want a free, open-source way to model demand scenarios and compare safety-stock policies. Its main reason to choose it is the combination of simulation, optimization workflows, and visual comparison in a package teams can adapt. Look elsewhere if Alpha maturity or the absence of order, case-pack, and promotion handling makes it unsuitable for your planning requirements.
The verdict
replenishment brings policy simulation, optimization workflows, and visual comparison together in a Python library. Its Alpha status and listed future work areas are relevant considerations for teams assessing whether it fits their modeling needs.
Questions people ask
What does replenishment cost?
The open-source library plan is listed as free.
Which Python versions are supported?
The project says it is tested on Python 3.10, 3.11, 3.12, and 3.13.
How is it installed?
The README documents the PyPI command `pip install replenishment`.
What license does it use?
The package metadata identifies the MIT license.
What optimization methods are included?
Workflows cover mean-forecast safety stock, k*RMSE or k*MAE, and percentile-target policies.
Is the project mature?
Its package metadata classifies development status as Alpha.
What the maker publishes
- Contribution
- The README welcomes contributions and links to guidance for setup, tests, and pull requests. source
- Data handling
- The README describes workflows for moving between CSV/DataFrame inputs and simulation configs. source
- Data workflows
- The project describes workflows moving between CSV or DataFrame inputs and simulation configs. source
- Demand scenarios
- It simulates replenishment policies against historical or synthetic demand. source
- Dependencies
- The project metadata lists pandas, Polars, PyArrow, matplotlib, ipykernel, and scienceplots as dependencies. source
- Dependencies
- The package metadata lists pandas, Polars, PyArrow, Matplotlib, and SciencePlots among its dependencies. source
- Development status
- The project metadata classifies the package as Alpha. source
- Distribution
- The README documents installation from PyPI with pip install replenishment. source
- Forecast buffering
- The README says k*RMSE or k*MAE safety stock can optionally increase when lead-time forecast quantities rise above a baseline. source
- Installation
- The README gives `pip install replenishment` as the PyPI installation command. source
- Intended use
- The README says it is designed for teams that simulate replenishment policies against historical or synthetic demand. source
- License
- The project metadata identifies the license as MIT. source
- License and maturity
- The package metadata identifies the license as MIT and development status as Alpha. source
- Notable limits
- The README lists minimum order quantities, case-pack constraints, and promotion-aware demand handling as areas for future contribution. source
- Policy optimization
- The README lists mean-forecast safety stock, k*RMSE/k*MAE, and percentile-target policies as optimization workflows. source
- Policy optimization
- It supports optimizing mean-forecast safety stock, k*RMSE/k*MAE, and percentile-target policies. source
- Purpose
- The project describes replenishment as a Python library for stock replenishment simulation, policy optimization, and decision visualization. source
- Python support
- The project says it is tested on Python 3.10, 3.11, 3.12, and 3.13. source
- Python versions
- The README says the project is tested on Python 3.10, 3.11, 3.12, and 3.13. source
- Support and contribution
- The README welcomes contributions and links to contribution guidance and the repository issue tracker. source
- Visualization
- The README describes comparing policies visually on replenishment time series. source
- Visualization
- It can compare replenishment policies visually on time series. source
- Walkthroughs
- The repository includes notebooks for policy variants, synthetic data generation, and stock replenishment data loading. source
- What it does
- replenishment is a Python library for stock replenishment simulation, policy optimization, and decision visualization. source
Checked against the maker's pages on 10 Oct 2026.