Axis Install and Run

Prerequisites

• Node.js 22+ (source usage)
• pnpm (workspace build and scripts)
• Bun (standalone compile/release packaging)
• One model provider API key (for example ANTHROPIC_API_KEY)

Install (Public Binary)

Install latest release:

curl -fsSL https://github.com/bibliothecadao/eternum/releases/latest/download/install-axis.sh | bash

Install a pinned version:

curl -fsSL https://github.com/bibliothecadao/eternum/releases/latest/download/install-axis.sh | VERSION=v0.1.0 bash

Verify:

axis --version

Run from Source

git clone https://github.com/bibliothecadao/eternum.git
cd eternum
pnpm install
 
# Build required workspace dependencies
pnpm --dir packages/types build
pnpm --dir packages/torii build
pnpm --dir packages/provider build
pnpm --dir packages/client build
pnpm --dir packages/game-agent build
 
# Run Axis
cd client/apps/onchain-agent
cp .env.example .env
pnpm dev

First-Time Setup

Initialize runtime directories and local .env (if missing):

axis init

Set at least one provider key, for example:

ANTHROPIC_API_KEY=sk-ant-...

Start Axis in TUI mode:

axis run

On first run, Axis will:

1. Discover active worlds
2. Let you select a world (unless SLOT_NAME is set)
3. Open browser-based Cartridge session approval
4. Start the agent loop

Standalone Binary from Source

cd client/apps/onchain-agent
bun run build.ts --compile
cp axis ~/.local/bin/
axis --version

Install Lifecycle

• Roll back: reinstall with VERSION=vX.Y.Z
• Uninstall: remove ~/.local/bin/axis, ~/.local/share/eternum-agent, and optionally ~/.eternum-agent