sim-asset-tools 0.3.0

Portable tools for preparing simulation-ready mesh and model assets

sim-asset-tools

sim-asset-tools prepares portable assets for robotics and physics simulation. Its sim-assets CLI provides standalone mesh processing, object-bundle generation, and reusable primitives for higher-level asset workflows.

Installation

Add the CLI and library to a project:

uv add sim-asset-tools

Project wheels support CPython 3.10–3.13 on Linux x86_64 or ARM64, Windows x86_64, and macOS 12 or newer on Apple Silicon.

Supported workflows

Command family	Support
mesh	Normalize, OpenVDB SDF, ACVD remeshing, CoACD decomposition
prepare object / prepare objects	GLB, OBJ, PLY, STL to MJCF and/or URDF bundles
check object	Object-bundle integrity

See the runnable examples for CLI commands and uv run sim-assets --help for all available options.

Reusable workflow primitives

Higher-level asset packages can build on the public sim_asset_tools.surface module for OpenVDB-to-ACVD surface generation and sim_asset_tools.publish for atomic directory publication. Manifest JSON, path, and hashing helpers in sim_asset_tools.formats.manifest are schema-neutral; each workflow owns and validates its persistent format. Prepared object bundles use the sim-asset/object/v1 schema.

Third-party software

Component	Version or source	Use	License
ACVD	Commit 275554980e466914ae9053c8667006f251989422	Bundled remeshing tools	CeCILL-B
OpenVDB	v8.2.0	Statically linked SDF processing	MPL 2.0
oneTBB	v2022.0.0	Bundled threading library	Apache 2.0
Boost	1.81.0	OpenVDB build dependency	Boost Software License 1.0
VTK	9.6.2	Native mesh processing runtime	BSD 3-Clause
CoACD	>=1.0.11	Convex decomposition	MIT

Code authored for this repository is licensed under the Apache License 2.0. Bundled third-party components retain their respective licenses.