Full install guide

Install Kira on your platform and verify everything is working.

Choose your platform below, run the installation command, and confirm the toolchain is available in your shell.

macOS

Use Homebrew for the cleanest setup and keep the compiler on your normal PATH.

brew tap kira-lang-com/kira
brew install kira

Requires Homebrew. Then run `kira --version` to verify the install.

Before you install

Use a normal shell session with permission to write to your user toolchain directory. Close older terminals before you verify the install so your PATH is refreshed correctly.

Verify it worked

After installation, open a new terminal and run `kira --version`. If the command is found, the install is successful and your shell can already see the compiler.

Next step

Once Kira is installed, head to the syntax or examples docs. That is the fastest path from a working toolchain to writing your first small program.

Troubleshooting checklist

Command not found

Open a fresh terminal session first. If that still fails, confirm the install directory was added to your PATH and that the install script finished without permission errors.

Wrong shell profile

On Unix-like systems, make sure the PATH export lands in the profile your shell actually reads, such as `.zshrc`, `.bashrc`, or `.profile`.

Windows execution policy

If PowerShell blocks the installer, rerun the command in a shell with the specified execution policy flag and then open a new terminal before verifying.

Installed but outdated

Re-run the same install method you used originally so the existing toolchain is updated in place and your shell path continues to point to the right binary.