Skip to main content

MeshLib logo

MeshLib — an SDK that supercharges your 3D data processing efficiency

Geometry algorithms engineered to revolutionize. We help software engineers process, repair, measure and optimize 3D data with next-generation algorithms, reducing development time and costs — mesh boolean, mesh repair, decimation, offset, point cloud triangulation, ICP registration and voxel processing, in C++, C, C#, Python and JavaScript.

▶ Try it live · Website · Documentation · Quick start · Examples · Benchmarks · Discussions

build-test-distribute PyPI version PyPI downloads Python versions NuGet npm Stars

MeshLib SDK — 3D mesh processing library

Install

pip install meshlib                  # Python
dotnet add package MeshLib           # C#
npm install @meshinspector/meshlib   # JavaScript / WebAssembly

For C++ and C, see the Installation Guide.

60 seconds to your first result

Turn a scan into a triangle mesh:

from meshlib import mrmeshpy as mm

pc   = mm.loadPoints("scan.ply")           # point cloud from any scanner
mesh = mm.triangulatePointCloud(pc)        # point cloud -> triangle mesh
mm.saveMesh(mesh, "model.stl")

Boolean operations that just work, with no non-manifold surprises:

from meshlib import mrmeshpy as mm

a = mm.makeUVSphere(1.0, 64, 64)
b = mm.copyMesh(a)
b.transform(mm.AffineXf3f.translation(mm.Vector3f(0.7, 0.0, 0.0)))

res = mm.boolean(a, b, mm.BooleanOperation.Union)
if not res.valid():
    raise RuntimeError(res.errorString)
mm.saveMesh(res.mesh, "out_boolean.stl")

Heal a broken scan into a watertight, printable model. Voxel-based repair rebuilds the surface through a signed distance field, so holes, self-intersections and non-manifold edges disappear in a single pass:

from meshlib import mrmeshpy as mm

mesh = mm.loadMesh("broken.stl")

params = mm.GeneralOffsetParameters()
params.voxelSize = mesh.computeBoundingBox().diagonal() / 200
params.signDetectionMode = mm.SignDetectionMode.HoleWindingRule
params.closeHolesInHoleWindingNumber = True

fixed = mm.generalOffsetMesh(mm.MeshPart(mesh), 0.0, params)   # watertight
mm.saveMesh(fixed, "fixed.stl")

Voxel repair resamples the surface, so the result is denser than the input — add decimateMesh to bring the triangle count back down within a tolerance you set. Lighter, topological repair (fixMeshDegeneracies, fillHole, fixSelfIntersections) is available when you need to preserve the original vertices.

More in Tutorials and the examples/ folder — including complete, runnable programs for repair, boolean, offset, ICP and triangulation in all five languages.

What MeshLib does

3D Boolean Fast, exact mesh booleans (union, intersection, difference) plus a voxel-based mode for messy input.
Mesh repair Fix self-intersections, degeneracies, tunnels, multiple edges and undercuts; fill and stitch holes on flat and curved surfaces.
Point cloud to mesh Triangulation with accurate normal estimation, uniform and grid sampling, outlier removal.
Simplification Decimation within a set tolerance, remeshing and subdivision that keep the details you care about.
Offset Shell, partial and weighted offsets for 3D printing, machining and hollowing.
Registration Point-to-point and point-to-plane ICP, plus global registration of multiple scans.
Distance & SDF Mesh to signed distance field and back by marching cubes, distance maps, iso-lines, projection and ray intersection.
Voxels & CT DICOM import/export, voxel-grid processing and 3D volume rendering.
Deformation Laplacian, freeform and relaxation smoothing, noise reduction.
Segmentation Semi-automatic mesh segmentation guided by a curvature metric; graph-cut segmentation of voxel volumes.
Collision detection Exact and precise self- and pairwise intersection tests.
Viewer An embeddable OpenGL/ImGui viewer with UI components, or run the algorithms fully headless.
File formats Meshes, point clouds, CT scans, polylines, distance maps and G-code — full list.

Full feature reference: meshlib.io/features.

Why teams pick MeshLib

Measured, not claimed. Our boolean benchmark compares MeshLib across nine libraries on 2M-triangle models — method, data and input meshes. The simplification benchmark does the same for decimation across 11 libraries. Both are public and reproducible.

Manifold by construction. Meshes use a half-edge data structure, in which most non-manifold situations are simply not representable — a non-manifold edge, or a vertex with two closed rings of triangles around it. Broken topology is caught where it happens, not three pipeline stages later.

One engine, five languages. A native C++ core with official APIs for C, C#, Python and JavaScript/WebAssembly. The same algorithms, the same results — on the desktop, on a server, or in a browser tab.

Built for real workloads. Core algorithms are multithreaded; a CUDA module accelerates distance maps, signed distance fields, offsets and swept volumes on NVIDIA GPUs.

We use it ourselves. MeshInspector, our desktop and web application, and SmileInspector, our FDA-cleared clear-aligner platform, are both built entirely on this SDK, so it is exercised every day on real production data.

Supported, not abandoned. Backed by a full-time team with commercial support, regular releases and a responsive issue tracker.

Platforms

Windows · macOS · Linux (Ubuntu/Debian, Fedora/RHEL) · WebAssembly

Built with MeshLib

Project Field What it does
Polyga 3D scanning PointKit scanning platform, built on MeshLib
Verisurf Metrology 3D measurement, inspection and reverse engineering
Brius Technologies Orthodontics Customized lingual orthodontic appliances
Axial3D Medical imaging Scan-to-3D-model services for surgical planning
customed.ai Medical devices AI-driven patient-specific surgical instruments
Relu Digital dentistry AI segmentation for dental CAD workflows
spherene Generative design Adaptive density minimal surfaces for AM
ToffeeX Generative design Physics-driven design optimization
Enhatch Medical devices Intelligent surgery platform
CIMsystem CAM / machining CAD/CAM software for dental and industrial milling
3DONS Digital dentistry Dental treatment planning software
Henning Larsen Architecture / AEC Computational design and terrain modelling
MeshInspector 3D printing / QA STL editor, viewer and mesh repair application
SmileInspector Clear aligners FDA-cleared aligner treatment planning platform

Shipping something built on MeshLib? Open a PR and add it here — we like showing what people build.

Getting started

  1. Try the live demo — booleans, repair, decimation and ICP in the browser. No install, no sign-up.
  2. Evaluate locally. pip install meshlib, then work through the tutorials. Free for non-commercial and educational use under our licence.
  3. See it in an application. MeshInspector is the GUI built on MeshLib — desktop and web, 30-day trial.
  4. Book a call. Integration guidance, architecture questions and commercial licensing tailored to your project.

Licence

MeshLib is source-available: read the code, fork it, and use it free for non-commercial and educational work. Commercial use requires a licence — see the full terms and the licence page.

Citing MeshLib

If MeshLib supports your research, please cite the exact version you used — find it with pip show meshlib.

@software{meshlib,
  author       = {{MeshLib Development Team}},
  title        = {{MeshLib}: 3D Mesh Processing Library},
  organization = {AMV Consulting LLC},
  year         = {2026},
  version      = {3.1.3.429},
  url          = {https://meshlib.io},
  note         = {Please cite the exact version used in your work}
}

Other styles (APA, IEEE, Chicago) and guidance on citing a specific algorithm: meshlib.io/citation-guide. Published something that uses MeshLib? Tell us in Discussions — we keep a list.

Community and support

If MeshLib saves you time, a ⭐ helps other engineers find it.

Release files for meshlib 3.1.4.297

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for meshlib 3.1.4.297
File
meshlib-3.1.4.297-py311.py312.py313.py314-none-win_arm64.whl Python 3.12, Python 3.14, Python 3.11, Python 3.13 none Windows ARM64 Details
meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-win_amd64.whl Python 3.10, Python 3.11, Python 3.13, Python 3.14, Python 3.12, Python 3.8, Python 3.9 none Windows x86-64 Details
meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl Python 3.14, Python 3.13, Python 3.11, Python 3.8, Python 3.12, Python 3.10, Python 3.9 none Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 Details
meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl Python 3.11, Python 3.13, Python 3.9, Python 3.14, Python 3.12, Python 3.8, Python 3.10 none Linux glibc 2.27+ ARM64, Linux glibc 2.28+ ARM64 Details
meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-macosx_12_0_x86_64.whl Python 3.10, Python 3.11, Python 3.13, Python 3.9, Python 3.14, Python 3.8, Python 3.12 none macOS 12.0+ x86-64 Details
meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-macosx_12_0_arm64.whl Python 3.8, Python 3.12, Python 3.10, Python 3.11, Python 3.13, Python 3.9, Python 3.14 none macOS 12.0+ ARM64 Details

Total release size: 153.1 MB

Release files / meshlib-3.1.4.297-py311.py312.py313.py314-none-win_arm64.whl

Download URL meshlib-3.1.4.297-py311.py312.py313.py314-none-win_arm64.whl
Size 19.4 MB
Tags Python 3.11 Python 3.12 Python 3.13 Python 3.14 Windows ARM64
SHA-256 checksum
How to use checksums
e52dbb31c9a5514a5c7f15b584c2710460b3cc1a5db57df06c643747c09a1449
BLAKE2b-256 checksum
How to use checksums
2a99f646604af770983037630c7d97502b210f02c856f5ea83548fe688057810
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-win_amd64.whl

Download URL meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-win_amd64.whl
Size 19.5 MB
Tags Python 3.10 Python 3.11 Python 3.12 Python 3.13 Python 3.14 Python 3.8 Python 3.9 Windows x86-64
SHA-256 checksum
How to use checksums
e5e016ae8b1cec2c2ab75989950a74e09aabe6033f5de0993261c44feccb0e14
BLAKE2b-256 checksum
How to use checksums
4635920a42c1712bc4f8f334904de7d3bd3d8de020e55e4ce55585d79ccb50dd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 22.9 MB
Tags Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 Python 3.10 Python 3.11 Python 3.12 Python 3.13 Python 3.14 Python 3.8 Python 3.9
SHA-256 checksum
How to use checksums
6169ae7e6c0cebbf82caedc86afcc2b9634a76897c69be465adf6b0f3ee008a7
BLAKE2b-256 checksum
How to use checksums
85699e0c65f456bafc6deee013207fb62ca5bcb2de2660601255e19c7458a8c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 22.5 MB
Tags Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 Python 3.10 Python 3.11 Python 3.12 Python 3.13 Python 3.14 Python 3.8 Python 3.9
SHA-256 checksum
How to use checksums
2c5a78e813747b30b1716273dd0777dae2492ab27b91f19cbabc3cb0a17b1bc4
BLAKE2b-256 checksum
How to use checksums
ef16aa4df3e455629cd84d7f599f2cc68c849c09930f80e2d38e58ac7754d5e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-macosx_12_0_x86_64.whl

Download URL meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-macosx_12_0_x86_64.whl
Size 34.6 MB
Tags Python 3.10 Python 3.11 Python 3.12 Python 3.13 Python 3.14 Python 3.8 Python 3.9 macOS 12.0+ x86-64
SHA-256 checksum
How to use checksums
613a4bc424b7e8632c7752cc5ce7e330f1ab94a43278475f5121c2a33f53d17d
BLAKE2b-256 checksum
How to use checksums
7c5ed4802c65d8510ec94a6356a36468ac0e0e9b5fac130de10d44088e83aafc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-macosx_12_0_arm64.whl

Download URL meshlib-3.1.4.297-py38.py39.py310.py311.py312.py313.py314-none-macosx_12_0_arm64.whl
Size 34.2 MB
Tags Python 3.10 Python 3.11 Python 3.12 Python 3.13 Python 3.14 Python 3.8 Python 3.9 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
6d909324fd951451cd25b6f0e52383a3f71e95e8ae043239300e5172ed222dcd
BLAKE2b-256 checksum
How to use checksums
5e0361b3c812f968b2c6b909779f76aaf34b40ddc9dda61601cf270f7053a3f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

3.1.4.297 This release

6 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page