Skip to main content

​
Prerequisites

Before setting up ActumX, ensure you have the following tools installed:

Bun

Required for running the API serverInstall Bun

pnpm

Required for the dashboard frontendInstall pnpm

Docker

Required for running PostgreSQLInstall Docker

​
Setup Steps

1

Start PostgreSQL Database

Create and start a PostgreSQL container using Docker:
This creates a database named x402 accessible at:
2

Configure the API

Navigate to the API directory and set up environment variables:
Your api/.env file should contain:
.env
In production, use a strong random secret for BETTER_AUTH_SECRET (minimum 32 characters).
3

Install Dependencies and Run Migrations

Install the API dependencies and set up the database schema:
The db:migrate command creates all necessary tables for agents, API keys, billing, and x402 transactions.
4

Start the API Server

Launch the API in development mode:
The API will be available at http://localhost:3001.
Other useful commands:
  • bun run start - Run without watch mode
  • bun run check - Type-check the codebase
  • bun run db:reset - Reset and re-run migrations
5

Configure the Dashboard

In a new terminal, navigate to the dashboard directory:
Your dashboard/.env.local file should contain:
.env.local
6

Start the Dashboard

Install dependencies and launch the dashboard:
The dashboard will be available at http://localhost:3000.

​
Verify Installation

Once both servers are running, you should be able to:
  1. Access the dashboard at http://localhost:3000
  2. Create a new account
  3. Navigate through the dashboard UI
  4. Access API health check at http://localhost:3001/health
Your ActumX development environment is now ready! Proceed to create your first agent.

​
Project Structure

​
Next Steps

Create Agents

Set up your first AI agent with a Solana wallet

Manage API Keys

Generate API keys for authenticating requests