# 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](https://docs.worldlibertyfinancial.com/agentpay-sdk/workflows/wallet-setup) -> [Funding](https://docs.worldlibertyfinancial.com/agentpay-sdk/workflows/funding) -> [Policy](https://docs.worldlibertyfinancial.com/agentpay-sdk/workflows/policy) -> [Transfers](https://docs.worldlibertyfinancial.com/agentpay-sdk/workflows/transfers).

## 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](https://docs.worldlibertyfinancial.com/agentpay-sdk/install/skill-pack-install) 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](https://docs.worldlibertyfinancial.com/agentpay-sdk/install/skill-pack) and [Install the skill pack](https://docs.worldlibertyfinancial.com/agentpay-sdk/install/skill-pack-install) for details.

## What's next

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