# Install on macOS (Apple silicon)

Install Kwker on macOS with Apple silicon (M1 and later) - the Python wheel, the C library and the Rust crate, and what is experimental there.

Web page: https://kwker.io/docs/?p=install-macos - every Kwker documentation page for AI assistants: https://kwker.io/llms.txt

Kwker runs on Macs with Apple silicon (M1 and later), macOS 15 or newer. In 0.1.0 this platform is experimental: the
packages build and pass their tests here, and speed is measured but not promised.

## Python

```sh
pip install kwker
python -m kwker doctor          # prints the engine in use (NEON)
```

The wheel holds the core library and the `kwker` command.

## C and C++

Use the `kwker-c-0.1.0-macos-aarch64.tar.gz` archive: headers, `libkwker_c.dylib`, the static library, pkg-config and
CMake files - the same layout as on Linux (see [Installation](https://kwker.io/docs/md/install.md#c-and-c)).

## Rust

```toml
[dependencies]
kwker = "0.1"
```

The build compiles the NEON engine with Apple clang.

## Not in the macOS packages yet

The PyTorch extensions, the KwkCNN / KwkEncoder / KwkDecoder runners, the Kwker Runtime with its ONNX Runtime provider,
the DuckDB extension and the Polars plugin. Everything else in the package works without them.

## Related

- [Installation](https://kwker.io/docs/md/install.md): every platform and package.
- [Runtime controls](https://kwker.io/docs/md/cpu-runtime.md): see and choose the engine.