Documentation for Kamiwaza 0.9.3

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

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.