Parts Packing Generator

Description

Desktop tool to autogenerate 3D-printable trays to hold parts for storage/shipping. Load a STEP file, generate and export a tray ready for the slicer.

Features

• TBD

Requirements

• Python: 3.10 to 3.12
• Linux/Windows (includes script to generate a PyInstaller binary for Windows machines)

Installation

1. Clone the repository

git clone https://github.com/InPoint-Automation/Parts-Packing-Generator.git
cd PartsPackingGenerator

2. Create a Python 3.12 virtual environment and install dependencies

python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Launch the app

python PartsPack.py

Usage

Load a STEP part, set parameters in the dock, Preview or Generate, then Export.

Contributing

Feel free to fork this project or contribute a PR. Build instructions can be found in the developer readme DEV.md

Licenses

Main code

This project is licensed under the GPLv3+

See LICENSE file for details.

Third-Party Components

Full license texts for all bundled and depended-on components are in the Third Party Licenses directory.

Bundled assets:

• Lucide - ISC License (portions derived from Feather, MIT) - Toolbar and ribbon icons, recolored at runtime into Qt icons

Runtime dependencies (installed via pip, bundled into the Windows binary by PyInstaller):

• build123d - Apache-2.0 License - STEP file loading and B-rep geometry
• Shapely - BSD-3-Clause License - 2D footprint and polygon operations
• PyVista - MIT License - 3D mesh rendering and preview
• pyvistaqt - MIT License - Embedding the PyVista viewer in Qt
• PySide6 (Qt for Python) - LGPL-3.0 License - GUI framework. Qt ships several licenses Third Party Licenses/pyside6
• NumPy - BSD-3-Clause License - Array and numerical operations
• pydantic - MIT License - Parameter models and validation
• manifold3d - Apache-2.0 License - Mesh boolean operations
• scikit-image - BSD-3-Clause License - Heightmap morphology
• pydelatin - MIT License - Heightmap-to-mesh conversion (wraps hmm, MIT)
• trimesh - MIT License - mesh loading and processing ([mesh] extra)

Credits

This project was developed by InPoint Automation Sp. z o.o. https://inpointautomation.com/

Changelog

See CHANGELOG.md for the full version history.