CargoBee is a logistics tool focused on optimally loading palletized cargo into shipping containers. It calculates multi-container shipment plans by generating mixed-height pallet configurations that respect both warehouse and container constraints, helping to maximize cubic space and prevent costly errors.
Screenshot of CargoBee v1.0.0Beta
CargoBee is a shipment planning assistant that provides a detailed and actionable loading plan.
-
Multi-Container Planning: Automatically calculates the total number of containers required for a large shipment and provides a detailed manifest for each one.
-
Dual-Constraint Optimization: Creates an intelligent mix of tall "Base Pallets" (to maximize warehouse height) and shorter "Topper Pallets" (for vertical stacking inside containers).
-
Weight & Safety Compliance: Calculates the total weight for each container—including pallets—and warns if the load exceeds standard road limits.
-
Dynamic Pallet Configuration: Determines the most efficient 2D layout of cartons on a pallet and the optimal number of layers for each distinct pallet type.
-
Profile Management: Save and load different shipment profiles directly in your browser using local storage for quick and repeatable calculations.
The core of CargoBee is its ability to create two different types of pallets to solve the "Two Ceilings" problem—the conflict between the maximum pallet height in the warehouse versus the internal height of a shipping container.
-
Base Pallets: These are built to be as tall as possible without exceeding your specified warehouse height limit. They are the primary, most common pallet type for any given shipment.
-
Topper Pallets: These are intentionally built shorter. Their height is calculated based on the space remaining above a Base Pallet inside a specific container, allowing for efficient double-stacking.
The algorithm then fills containers by prioritizing the most space-efficient combinations first (full stacks of Base + Topper pallets), ensuring a dense and stable load.
- Backend: Python 3.12 with the Flask web framework.
- Frontend: Tailwind CSS for a clean, responsive user interface.
- WSGI Server: Gunicorn for production.
- Containerization: Docker, defined by the Dockerfile in this repository.
- Hosting: Deployed on the Fly.io global application platform.
Want to run or contribute to CargoBee on your own machine? Follow these steps.
-
Clone the Repository:
git clone https://github.com/ToddE/CargoBee.git cd CargoBee -
Ensure you have Python 3.12 installed
python3 --version
-
Create and Activate a Virtual Environment:
python3 -m venv venv source venv/bin/activate -
Install Dependencies:
pip install -r requirements.txt
-
Run the Development Server:
python3 app.py
-
Browse to the App on your local machine
If everything goes well, use your web browser to go to https://127.0.0.1:5000 on your machine.
This project was built to solve a real-world problem. Your input can make it even better!
-
Got an idea or found a bug? Please open an issue on GitHub. We'd appreciate your feedback on new features or improvements.
-
Want to contribute code? We welcome co-development support! Feel free to fork the repository, make your changes, and submit a pull request.