# Install Bahama

These are the official agent-readable installation instructions for Bahama.
If a user sent you here, complete the installation in their current workspace.
Do not ask them to copy the commands for you.

Bahama has two parts:

- the **Bahama skill**, which teaches you how to choose providers, plan work,
  request approval, recover safely, and report verified results; and
- the **`bahama` CLI**, which performs deterministic provider operations and
  verifies their postconditions.

## 1. Check Node.js

Bahama requires Node.js 20.19 or newer:

```bash
node --version
```

If Node.js is too old or unavailable, explain the requirement before changing
the user's machine.

## 2. Install the Bahama skill

Run this from the user's project workspace:

```bash
npx -y skills add bahamaAI/bahama --skill bahama --yes
```

After installation, read the skill before planning infrastructure or running a
deployment.

## 3. Install the CLI

```bash
npm install --global bahama
```

## 4. Verify the installation

```bash
bahama setup
bahama doctor --json
```

If installation succeeds, return to the outcome the user originally requested.
Inspect the project, consult the live provider catalog, and follow the installed
skill.

Installation alone does not authorize provider login, resource creation,
deployment, migration, paid usage, or destructive work. Handle those boundaries
when they arise in the Bahama workflow.

Documentation: https://bahama.ai/docs

Source: https://github.com/bahamaAI/bahama