---
id: xatlas
version: "0.0.11"
license: MIT License Copyright (c) 2021 Markus Worchel Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# xatlas — Python bindings for xatlas

License: permissive · Maintenance: aging · Downloads: 685.9K/mo

## What it is and what it does

xatlas is a Python binding for the xatlas C++ library, which solves the texture coordinate generation problem for 3D triangle meshes. It takes raw mesh geometry (vertices and face indices) and produces UV coordinates suitable for texture mapping, along with a potentially modified vertex list and face indices to accommodate the parametrization. The library handles both single-mesh parametrization and multi-mesh atlas generation, where multiple meshes can be packed into a shared texture space.

The package is used in graphics pipelines where meshes need texture coordinates for rendering or baking. It offers two main workflows: direct parametrization of a single mesh, or incremental atlas construction where meshes are added one at a time and then generated together. It also supports repacking already-parametrized meshes and provides query methods to inspect atlas properties like utilization and chart structure. The library has no runtime dependencies and ships prebuilt wheels for common platforms.

Use it for:

- Automatically generate UV coordinates for 3D models loaded from OBJ or other formats before rendering or texture baking.
- Pack multiple game assets into a single texture atlas to reduce draw calls and memory overhead.
- Prepare mesh geometry for machine learning pipelines that require texture coordinates as input features.
- Repack existing UV-mapped meshes to optimize texture space utilization across a shared atlas.
- Debug mesh parametrization by exporting chart images to visualize how the atlas divides geometry.

## Worth the install?

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

Generates UV texture coordinates for 3D triangle meshes, enabling texture mapping through parametrization and atlas packing.

Yes, if you need automatic UV generation for 3D meshes. The package is stable (MIT licensed, no known vulnerabilities), has prebuilt wheels for modern Python, and fills a specific niche in graphics and geometry processing. Install friction is moderate due to compiled bindings, but wheels eliminate most friction for standard platforms. Maintenance is aging but the library is not archived and the underlying algorithm is mature.

## Install

pip install xatlas
uv add xatlas
poetry add xatlas

## Installing xatlas

Before you install: Medium install friction due to compiled bindings; prebuilt wheels cover modern Python versions and major platforms (Linux, macOS, Windows, including ARM64), but source builds require a C++ compiler and recursive git clone.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal obligations—only requiring preservation of copyright and license notices.

Quickstart:

import xatlas

# Parametrize a mesh
vmapping, indices, uvs = xatlas.parametrize(vertices, faces)

# Or use an atlas for multiple meshes
atlas = xatlas.Atlas()
atlas.add_mesh(vertices, faces)
atlas.generate()
vmapping, indices, uvs = atlas[0]

Requires a 3D mesh as input (vertices and face indices); no built-in mesh loading—use another library to load geometry first.

Verify before relying:

- Performance characteristics or scalability limits for very large meshes.
- Whether parametrization preserves mesh topology or can introduce artifacts in specific cases.
- Supported Python versions below the stated minimum of 3.8.

## Package facts

- License: MIT License Copyright (c) 2021 Markus Worchel Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: aging
- Downloads: 685.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

uv texture coordinate generation, mesh parametrization, texture atlas packing, 3d mesh uv mapping, unwrap mesh for texturing, 3d-graphics, mesh-processing, texture-mapping

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