# Launch the Visual Builder

### Prerequisites

Before getting started, ensure you have the following installed on your system:

* [Node.js](https://nodejs.org/en/download/) version 22.18 or higher (matches `.node-version`)
* [Docker](https://docs.docker.com/get-docker/)
* [pnpm](https://pnpm.io/installation) version 10.10 or higher (matches `packageManager`)

### Step 1: Clone the repository

```
git clone https://github.com/inkeep/agents.git
cd agents
```

### Step 2: Run the setup script

For first-time setup, run:

```bash
pnpm setup-dev
```

This will:

* Create `.env` from `.env.example` if missing
* Create `~/.inkeep/config` for user-global settings if missing
* Add `.env` to `.gitignore` if needed
* Install dependencies
* Start Doltgres (manage) + Postgres (runtime) + SpiceDB (authorization) via `docker-compose.dbs.yml` and run migrations

Add API keys for the AI providers you want to use in the root `.env` or `~/.inkeep/config`. `ANTHROPIC_API_KEY` is required.

```dotenv
ANTHROPIC_API_KEY=sk-ant-xyz789
OPENAI_API_KEY=sk-xxx # optional
GOOGLE_GENERATIVE_AI_API_KEY=sk-xxx # optional
```

### Step 3: Run the agent framework

```bash
pnpm dev
```

### Step 4: Start building!

Open `http://localhost:3000` in the browser and start building agents.