SarahWeiii/CoACD

Health v2 · maintenance only

Adoption not part of the score

1134 stars · 152 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

CoACD is a C++ library (with Python bindings and a Unity package) that performs approximate convex decomposition of 3D triangle meshes using a collision-aware concavity metric and tree search, published at SIGGRAPH 2022. It splits meshes into nearly convex components whose convex hulls preserve collision conditions for efficient physics simulation and interaction.

Use cases

• decompose a 3D mesh into convex parts for collision detection
• prepare game engine assets for physics simulation
• generate collision hulls for robot simulation environments
• convert scanned or CAD meshes into convex components with real-world metric thresholds
• preprocess meshes for articulated object simulation in Unity

When to choose

• you need collision-aware convex decomposition that preserves fine details like slots or holes
• you want a pip-installable Python API or Unity package for mesh decomposition
• you need intersection-free convex hulls without voxelization errors
• you work with real-world scale meshes and want thresholds in meters

When to avoid

• you need exact convex decomposition rather than an approximation
• your input meshes are not triangle meshes and you cannot triangulate them
• you need manifold mesh repair or low-poly conversion (use the companion PaMO library instead)

Facets

library · maturity active

graphics simulation machine-learning cli computer-vision graphics robotics simulation windows python cpp cross-platform convex-decomposition 3d-meshes collision-detection physics-simulation siggraph unity geometry-processing game-development linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="SarahWeiii/CoACD")