Quickstart - agtOS

Prerequisites

git clone https://github.com/agtos-ai/agtos.git
cd agtos
npm install

echo "ANTHROPIC_API_KEY=sk-ant-api03-your-key" >> .env.local

claude setup-token
# Copy the token, then:
echo "ANTHROPIC_AUTH_TOKEN=sk-ant-oat01-your-token" >> .env.local

agtOS spawns the claude CLI as a subprocess — no external proxy needed.

npx tsx src/server.ts

The health endpoint is available immediately at http://localhost:4102/health.

curl -X POST http://localhost:4102/api/chat \
  -H 'Content-Type: application/json' \
  -d '{"text": "Hello, what is 2+2?"}'

docker compose up -d redis speaches

Then open the dashboard at http://localhost:4102 and try voice chat.