This is documentation for Kamiwaza **0.13.0**, which is no longer actively maintained. For the current GA release, see [**1.0.1**](https://docs.kamiwaza.ai/).

Version: 0.13.0

This guide covers installing Kamiwaza Community Edition on macOS using the pre-built tarball bundle.

## Before You Start

1. Review the [System Requirements](https://docs.kamiwaza.ai/0.13.0/installation/system_requirements) - especially the prerequisites
2. Ensure you have administrator/sudo privileges
3. Verify Docker is installed and working (see [Verifying System Requirements](https://docs.kamiwaza.ai/0.13.0/installation/system_requirements#verifying-system-requirements))
4. Deactivate any active Python virtual environments (the installer will create its own):

```bash
deactivate 2>/dev/null || true  # Deactivate venv if active

conda deactivate 2>/dev/null || true  # Deactivate conda if active
```

* * *

## macOS (Sequoia 15+)

### 1) Install Homebrew

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

### 2) Install and start Docker Desktop

```bash
brew install --cask docker

open -a Docker

# Wait for Docker to start, then verify:

docker --version && docker compose version
```

### 3) Download and install Kamiwaza

The installer automatically handles Python (via pyenv), Node.js (via nvm), and other dependencies.

```bash
mkdir -p ~/kamiwaza && cd ~/kamiwaza

curl -L -O https://packages.kamiwaza.ai/macos/kamiwaza-community-0.9.3-OSX.tar.gz

tar -xvf kamiwaza-community-0.9.3-OSX.tar.gz

bash install.sh --community
```

* * *

## Start the Platform

After installation completes:

```bash
cd ~/kamiwaza  # or your install directory

source .venv/bin/activate

bash startup/kamiwazad.sh restart
```

Access the web console at `https://localhost`

- **Default Username:**`admin`
- **Default Password:**`kamiwaza`

* * *

## Troubleshooting

| Issue | Solution |
| --- | --- |
| Docker permission denied | Ensure Docker Desktop is running |
| Python version errors | Kamiwaza supports Python 3.10-3.12. Python 3.13+ is not yet supported. |

## Notes

- Check the [Kamiwaza Community Edition releases](https://github.com/kamiwaza-ai/kamiwaza-community-edition) for the latest available version.
- The installer automatically sets up Python virtual environments, Node.js, and required packages.
- **Local Dev Alternative:** For developers building from source using the deploy repository scripts, an experimental `k0s` runtime via Podman VM (`--k0s-podman`) or Lima VM (`--k0s-lima`) is available as an alternative to Docker Desktop for local deployments. See [`scripts/k0s-dev-install.sh`](https://github.com/kamiwaza-ai/deploy/blob/develop/scripts/k0s-dev-install.sh) and [`scripts/k0s-lima-install.sh`](https://github.com/kamiwaza-ai/deploy/blob/develop/scripts/k0s-lima-install.sh) in the deploy repo for details and performance benchmarks.