---
id: manifold3d
version: "3.5.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# manifold3d — Library for geometric robustness

License: permissive · Maintenance: active · Downloads: 3.1M/mo

## What it is and what it does

Manifold3d is a Python binding to a C++ geometry library for creating and manipulating manifold triangle meshes—meshes that represent solid, watertight 3D objects. It is designed for CAD, manufacturing, 3D printing, and structural analysis workflows where mesh validity is critical. The library guarantees manifold output from its operations, eliminating a long-standing open problem in mesh Boolean operations (union, intersection, difference). It supports constructive solid geometry workflows, arbitrary vertex properties, material mapping, and a suite of mesh refinement and smoothing functions.

The package depends only on numpy and has no other required dependencies. It ships with precompiled wheels for current Python versions on macOS (Intel and ARM), Linux (x86_64 and aarch64), and Windows, making installation straightforward on modern systems. The library is actively maintained, with recent releases and integration into projects like OpenSCAD, Blender, Godot Engine, and Babylon.js.

Use it for:

- Perform robust Boolean operations (union, intersection, difference) on 3D meshes for CAD and design automation.
- Generate watertight manifold meshes from signed-distance functions (SDFs) as an alternative to Marching Cubes.
- Prepare 3D models for 3D printing by ensuring mesh validity and combining multiple objects with guaranteed manifold output.
- Smooth and refine triangle meshes while preserving sharp edges and controlling curvature for rendering or analysis.
- Combine geometry from multiple sources with unique materials and track object/face provenance using mesh IDs.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Manifold3d creates and operates on manifold triangle meshes—solid 3D geometry guaranteed to be topologically valid—with support for mesh Boolean operations, smoothing, and arbitrary vertex properties.

Yes. Manifold3d is a mature, actively maintained library (Production/Stable status, 2220 GitHub stars) with no known vulnerabilities, permissive licensing, and straightforward installation via prebuilt wheels. Install it if you need reliable mesh Boolean operations, CAD workflows, or 3D printing preparation; skip it if you only need basic mesh I/O or visualization.

## Install

pip install manifold3d
uv add manifold3d
poetry add manifold3d

## Installing manifold3d

Before you install: Medium install friction due to compiled wheels; however, prebuilt binaries are available for current Python versions across macOS, Linux, and Windows, and the package is actively maintained with a recent release.

License in practice: Licensed under Apache Software License (permissive), allowing use in both open-source and commercial projects with minimal restrictions.

Quickstart:

pip install manifold3d

import manifold3d as m3d
import numpy as np

# Create a simple cube and sphere, then compute their union
cube = m3d.Manifold.cube()
sphere = m3d.Manifold.sphere()
union_mesh = cube + sphere  # Boolean union

Requires Python 3.9 or later; precompiled wheels available for current Python versions on common platforms (macOS, Linux, Windows).

Verify before relying:

- Whether the package's mesh repair capabilities can handle all common non-manifold input formats without manual preprocessing.
- Performance characteristics and parallelization benefits when running on systems without TBB enabled.
- Specific Python versions supported beyond the minimum requirement of 3.9.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 3.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

3d mesh boolean operations, manifold mesh generation, cad geometry library python, solid 3d modeling, mesh repair and validation, constructive solid geometry, 3d-geometry, cad-kernel, mesh-processing

[View on SkillFed](https://skillfed.io/packages/manifold3d) · [View on PyPI](https://pypi.org/project/manifold3d/)