# Install

## Quick start

One-click install (recommended - macOS only):

```bash
curl -fsSL https://wlfi.sh | bash
```

To install the latest version explicitly, or pin a specific release:

```bash
# latest
curl -fsSL https://wlfi.sh/latest | bash

# specific version
curl -fsSL https://wlfi.sh/0.1.0 | bash
```

The script downloads a prebuilt runtime bundle, installs `agentpay`, and auto-detects supported AI host integrations (Codex, OpenClaw, Claude Code, Cursor). No Rust, Cargo, or pnpm required. After install, run `agentpay admin setup` to create a wallet.

Or install from source (requires Node.js `20+`, `pnpm`, Rust `1.87.0+`, and Xcode CLI Tools):

```bash
git clone https://github.com/worldliberty/agentpay-sdk.git
cd agentpay-sdk
pnpm install
pnpm run build
pnpm run install:cli-launcher
pnpm run install:rust-binaries
```

On macOS, add `export PATH="$HOME/.agentpay/bin:$PATH"` to `~/.zshrc`, then reload your shell with `source ~/.zshrc`.

On Linux, add `export PATH="$HOME/.agentpay/bin:$PATH"` to your shell startup file such as `~/.bashrc`, `~/.zshrc`, or `~/.profile`, then reload that file or open a new shell.

Then set up the wallet:

```bash
agentpay admin setup
```

From here, continue to [Wallet setup](/agentpay-sdk/workflows/wallet-setup.md) -> [Funding](/agentpay-sdk/workflows/funding.md) -> [Policy](/agentpay-sdk/workflows/policy.md) -> [Transfers](/agentpay-sdk/workflows/transfers.md).

## Prerequisites

### One-click install

* macOS
* Network access to download installer assets
* Homebrew only when the machine does not already have Node.js `20+`

The one-click installer downloads a prebuilt macOS runtime bundle. It installs Node `20+` locally when a compatible version is not already available.

### Install from source

* macOS or Linux
* Node.js `20+`
* `pnpm`
* Rust `1.87.0+` (`rustup` recommended)
* Xcode Command Line Tools on macOS (`xcode-select --install`)

`pnpm run install:cli-launcher` installs the `agentpay` launcher into `~/.agentpay/bin`, and `pnpm run install:rust-binaries` installs the Rust runtime into the same directory.

## Skill pack

The one-click installer auto-detects supported hosts and copies the skill pack for you. To install **only** the skill pack and adapters without the full runtime, pass `--skills-only`:

```bash
curl -fsSL https://wlfi.sh/ | bash -s -- --skills-only
```

See [Install the skill pack](/agentpay-sdk/install/skill-pack-install.md) for what the script does and which hosts it supports.

If you installed from source or need to update the pack manually:

```bash
mkdir -p ~/.codex/skills
cp -R agentpay-sdk/skills/agentpay-sdk ~/.codex/skills/
```

The source path is [`skills/agentpay-sdk/`](https://github.com/worldliberty/agentpay-sdk/tree/main/skills/agentpay-sdk) inside the SDK repository checkout.

See [Skill pack](/agentpay-sdk/install/skill-pack.md) and [Install the skill pack](/agentpay-sdk/install/skill-pack-install.md) for details.

## What's next

| Step                         | Page                                                                    |
| ---------------------------- | ----------------------------------------------------------------------- |
| Machine-side install details | [CLI and local daemon](/agentpay-sdk/install/cli-and-daemon-install.md) |
| Set up or reuse a wallet     | [Wallet setup](/agentpay-sdk/workflows/wallet-setup.md)                 |
| Fund the wallet              | [Funding](/agentpay-sdk/workflows/funding.md)                           |
| Configure spending limits    | [Policy](/agentpay-sdk/workflows/policy.md)                             |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.worldlibertyfinancial.com/agentpay-sdk/install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.