Perseuss

Demo Playground

Send live requests and see 3D visualizations.

Basics

Basic Packing

Simplest possible request with one bin type

Multiple Bin Sizes

Let the solver choose the best bin combination

Simple Multi Bin Packing

Minimize bins with multiple sizes and items

Optimization

These three examples use the same items and bins — only the objective function changes. Run each to see how the solver picks a different strategy.

Minimize Bin Cost

Optimize for lowest total bin cost

Minimize Bin Count

Use the fewest bins possible

Minimize Bin Volume

Minimize total wasted space across all bins

Constraints

Weight Limits Per Bin

Enforce maximum weight capacity

Partial Fill (Fragile Items)

Leave room for cushioning material

Keep Items Upright

Restrict rotation to keep items vertical

Keep Items Flat

Keep flat items horizontal (like pizza boxes)

Advanced

Separate Incompatible Items

Prevent certain items from being packed together

Restrict Items to Bins

Prevent items from going into certain bin types

Squishable Items (Clothing)

Pack flexible items that deform to fit

Poly Mailers

Flexible containers that reshape to contents

Mixed Solid & Squishable

Pack rigid and flexible items together

Multiple T-Shirts in Polymailer

Pack 3 t-shirts with 50% volume compression

Mixed Packaging Types

Choose between carton boxes and poly mailers

Pallets

Simple Pallet Stacking

Stack identical boxes on a standard GMA pallet

Mixed Boxes on Pallet

Different box sizes optimized for cost on pallets

Height-Constrained Pallet

Low max_height forces items across multiple pallets

Standard GMA Pallet

Common 48×40 pallet with min_bin_count optimization

Real-World

E-commerce Fulfillment

Realistic scenario with varied products

Complete Feature Showcase

All features in one complex request

Tight-Fit Clothes in a Mailer

Verified: large folded clothing fits in medium polymailer

Request Payload
Live Playground
Test requests directly from the interactive playground.

Simple Multi Bin Packing

What This Demonstrates

A balanced example showing bin count minimization with multiple bin sizes.

The Scenario

Packing frozen food items:

  • 4 frozen pizzas (11×8.5×2)
  • 6 frozen burger boxes (4×4×4)

    • Into two box sizes:

  • 9×12×4 box ($0.25)
  • 9×12×6 box ($0.35)

    • Key Fields Used

  • objective_function: "min_bin_count"
  • Multiple bin sizes with costs
  • Multiple item types

    • Expected Result

    Items are consolidated into the minimum number of boxes.

    Key Features

    min_bin_countMultiple binsFood packing

    Live playground mode with built-in request handling.

    Ready to Test?

    Click "Run Request" to execute the cartonization logic and see the results here.