# Installation ## Install from package managers [![Packaging status](https://repology.org/badge/vertical-allrepos/maturin.svg?columns=4)](https://repology.org/project/maturin/versions) ### PyPI maturin is published as Python binary wheel to PyPI, you can install it using [pipx](https://pypa.github.io/pipx/): ```bash pipx install maturin ``` There are some extra dependencies for certain scenarios: * `zig`: use zig as linker for easier cross compiling and manylinux compliance. * `patchelf`: repair wheels that links other shared libraries. For example, to install patchelf dependencies: `pipx install maturin[patchelf]`. > **Note** > > `pip install maturin` should also work if you don't want to use pipx. ### Homebrew On macOS [maturin is in Homebrew](https://formulae.brew.sh/formula/maturin#default) and you can install maturin from Homebrew: ```bash brew install maturin ``` **Note**: Installing maturin with Homebrew will also install Rust as a dependency, even if you already have Rust installed via [rustup](https://www.rust-lang.org/tools/install). This results in two separate Rust installations, which can cause conflicts. If you've already installed Rust with `rustup`, consider installing maturin with a method other than Homebrew (such as from source with cargo). ### conda Installing from the `conda-forge` channel can be achieved by adding `conda-forge` to your conda channels with: ``` conda config --add channels conda-forge conda config --set channel_priority strict ``` Once the `conda-forge` channel has been enabled, `maturin` can be installed with: ``` conda install maturin ``` ### Alpine Linux On Alpine Linux, [maturin is in community repository](https://pkgs.alpinelinux.org/packages?name=maturin&branch=edge&repo=community) and can be installed with `apk` after [enabling the community repository](https://wiki.alpinelinux.org/wiki/Enable_Community_Repository): ```bash apk add maturin ``` ## Download from GitHub Releases You can download precompiled maturin binaries from the latest [GitHub Releases](https://github.com/PyO3/maturin/releases/latest). You can also use [cargo-binstall](https://github.com/cargo-bins/cargo-binstall) to install maturin from GitHub Releases: ```bash # Run `cargo install cargo-binstall` first if you don't have cargo-binstall installed. cargo binstall maturin ``` ## Build from source ### crates.io You can install maturin from [crates.io](https://crates.io/crates/maturin) using cargo: ```bash cargo install --locked maturin ``` ### Git repository ```bash cargo install --locked --git https://github.com/PyO3/maturin.git maturin ```