Community Edition Installation on macOS

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

Before You Start

1. Review the System Requirements - especially the prerequisites
2. Ensure you have administrator/sudo privileges
3. Verify Docker is installed and working (see Verifying System Requirements)
4. Deactivate any active Python virtual environments (the installer will create its own):

   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

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

2) Install and start Docker Desktop

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.

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:

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 for the latest available version.
• The installer automatically sets up Python virtual environments, Node.js, and required packages.