Installation

pnpm add -g aeonsage

npm install -g aeonsage

yarn global add aeonsage

aeonsage --version
# aeonsage/2026.2.15

aeonsage --help

# Initialize configuration
aeonsage init

# Start the Gateway
aeonsage gateway start

# Open in browser (default port)
open http://localhost:3000

docker pull aeonsage/gateway:latest

docker run -d \
  --name aeonsage-gateway \
  -p 18789:18789 \
  -v aeonsage-data:/root/.aeonsage \
  -e GATEWAY_TOKEN=your-secure-token \
  -e OPENAI_API_KEY=your-key \
  aeonsage/gateway:latest

version: '3.8'

services:
  aeonsage:
    image: aeonsage/gateway:latest
    container_name: aeonsage-gateway
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ./config:/root/.aeonsage
      - ./skills:/root/.aeonsage/skills
    environment:
      - GATEWAY_TOKEN=${GATEWAY_TOKEN}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - LOG_LEVEL=info

docker-compose up -d

# Clone the repository
git clone https://github.com/aeonsage/aeonsage.git
cd aeonsage

# Install dependencies
pnpm install

# Build the project
pnpm build

# Run locally
pnpm aeonsage gateway start

# Run in development mode with hot reload
pnpm dev