supplycm

A pure-Python library of 397 supply chain management algorithms with zero external dependencies. All algorithms are public-domain / patent-free implementations suitable for educational and commercial use.

Quick Start

pip install supplycm

from supplycm.inventory import economic_order_quantity

# Compute optimal order quantity
q = economic_order_quantity(demand=10000, ordering_cost=100, holding_cost=5)
print(f'Order {q:.0f} units each cycle')

Installation

From PyPI

pip install supplycm

From source

git clone https://github.com/atqatq/supplycm.git
cd supplycm
pip install .

Note: Python 3.6 or later is required. Check your version with python --version.

Categories

Python Version Compatibility

Running Tests

# Run all unit tests
python tests/run_tests.py

# Run doctests
python tests/run_doctests.py

Design Principles

1. Pure Python - no NumPy, pandas, or any third-party dependency. Only the standard library.
2. Self-contained - each algorithm lives in its own module and can be imported independently.
3. Documented - every function has a docstring with usage examples.
4. Tested - comprehensive test suite using Python's built-in unittest framework.
5. Consistent - all modules follow the same style and structure.

Community

• Discussions - Ask questions, share ideas, show your projects
• Issues - Report bugs or request features
• Contributing Guide - How to contribute code, documentation, or algorithms

Learning the Package

Tutorials, learning paths, and interactive notebooks are available in the companion repository: atqatq/supplycm-learning

License

MIT - see LICENSE.