pyworkforcePractical workforce optimization in Python

Queue staffing, multi-skill staffing, shift scheduling, rostering and break scheduling for operations that need the right people at the right time.

Get Started

Quick Start

Recipes

View on GitHub

Queue staffing

Size your team with Erlang C (infinite queue), Erlang A (abandonment), or Erlang B (loss/trunk sizing). Sweep many scenarios at once with the Multi* variants.

Shift scheduling

Given the resources required per period, decide how many people to place on each shift using constraint-programming solvers built on OR-Tools.

Rostering & break scheduling

Assign named people to days and shifts while respecting rest days, banned shifts, minimum hours and preferences. Then schedule breaks to maintain coverage.

Friendly, scikit-learn-like API

Consistent constructors, helpful validation messages, get_params() and readable reprs, plus helpers to build shift coverage without hand-writing 0/1 arrays.

Planning pipeline

text

Forecast demand -> Queue staffing -> Multi-skill staffing -> Shift scheduling -> Rostering -> Break scheduling

pyworkforce is useful beyond contact centers: healthcare staffing, retail operations, logistics, support teams, service desks and field operations all share the same planning problem of matching variable demand to finite resources.

Where should I start?

Goal	Page
Install and run the first example	Quick Start
Understand the full workflow	End-to-end planning tutorial
Size call-center agents for 80/20	Erlang C
Model abandonment	Erlang A
Size SIP trunks or channels	Erlang B
Solve short practical tasks	Recipes
Check constructor and output details	API Reference
Contribute examples, docs or solvers	Contributing