Quickstart

Three ways to get your first deployment running on Acurast. Pick the one that fits your workflow.

CLI (Interactive)
SDK (Programmatic)
Deploy Agent (x402)

Best for local development and getting started.

# Scaffold a new project
npx @acurast/cli new my-project
cd my-project

# Initialize config (creates acurast.json and .env)
acurast init

# Fund the account shown by the CLI — https://faucet.acurast.com
# Then deploy:
acurast deploy

Full walkthrough: First App Deployment · Command reference: CLI docs.

Best for CI pipelines, backends, and custom deployment flows.

npm install @acurast/sdk

import { deployProject, loadAcurastConfig } from '@acurast/sdk/deploy'

const config = await loadAcurastConfig('./acurast.json')
await deployProject({ config })

Full API: SDK docs.

Best for AI agents and services that pay in USDC on Base — no ACU account needed.

npx awal@latest x402 pay "https://deploy.acu.run/deploy" -X POST -d '{
    "script": "ipfs://QmZ9mvN4RFCqSqivB2LF3VF1qgrDGTW393PJezbdPy7nH2",
    "reward": 77136800000
}'

Full walkthrough: Deploy Agent docs.

Next steps

First App Deployment — step-by-step tutorial with a real Express server.
Example Apps — curated list of ready-to-clone projects.
Runtime Environment — APIs available inside your deployment.
Deployment Config — full acurast.json reference.

Next steps​

Next steps