Skip to content

README.md

Latest commit

 

History

History
55 lines (39 loc) · 1.21 KB

README.md

File metadata and controls

55 lines (39 loc) · 1.21 KB

Waresim

Warehouse simulation tool for personal analysis.

Simple, minimal warehouse simulation to test and compare operational strategies.

Version 0.0.1 - Minimal MVP

Current capabilities:

  • Simulate agents picking products in 2D space
  • Compare strategies (FIFO, Nearest Neighbor, Random)
  • Manual task creation
  • Basic metrics (completion rate, distance, time)

Installation

pip install -e .

Quick Start

from waresim import Warehouse, Agent, Simulation, Task, Location, Product
from waresim.strategies import fifo, nearest_neighbor

# Setup warehouse
warehouse = Warehouse("Test_DC")
loc1 = Location("L1", x=0, y=0)
loc2 = Location("L2", x=10, y=0)

# Add agents
agent = Agent("A1", location=(0, 0), speed=1.5)
warehouse.add_agent(agent)

# Create tasks
product = Product("ABC123", "Widget", weight=1.0)
tasks = [
    Task("T1", product, quantity=5, from_location=loc1, to_location=loc2),
]

# Run simulation
sim = Simulation(warehouse, tasks)
sim.run(duration_seconds=3600)

# Results
metrics = sim.get_metrics()
print(f"Completed: {metrics['tasks_completed']}/{metrics['tasks_total']}")

Status

0.0.1 - MVP in development

See docs/versions/ for detailed scope and roadmap.