autoresearch-worker

Autoresearch Worker

Run a single-GPU worker that accepts train.py experiments over HTTP, executes them one at a time, stores results on disk, and exposes a simple API that can be gated with x402 using obol sell http.

When to Use

• Selling GPU-backed autoresearch experiment execution
• Exposing a remote POST /experiment endpoint for the autoresearch coordinator
• Running a worker on a Linux GPU host with k3s
• Testing the sell-side of the GPU marketplace locally before exposing it publicly

When NOT to Use

• Coordinating experiments across many workers — use autoresearch-coordinator
• Publishing optimized checkpoints as inference — use autoresearch
• Selling a generic HTTP app — use sell

What the Worker Exposes

• GET /health / GET /healthz — worker health
• GET /status — busy/idle plus current, last, and best result
• GET /best — best known result
• GET /experiments/<id> — fetch a stored result
• POST /experiment — submit a train.py experiment

The worker is intentionally simple:

• one experiment at a time
• one GPU worker process
• local disk for logs/results
• no distributed queue or scheduler inside the worker

Quick Start

1. Start the worker API

python3 scripts/worker_api.py serve \
  --repo /path/to/autoresearch \
  --data-dir /data \
  --host 0.0.0.0 \
  --port 8080 \
  --timeout 300

The repo path should point at a prepared autoresearch workdir/repo with the dependencies already available via uv.

2. Verify the worker locally

curl -s http://127.0.0.1:8080/health | jq .
curl -s http://127.0.0.1:8080/status | jq .

3. Deploy the worker behind a Kubernetes Service

For production GPU sellers, prefer k3s on the GPU host. The monetization path is cluster-based, so the worker should be reachable as a Kubernetes Service.

4. Monetize it with x402

obol sell http autoresearch-worker \
  --namespace autoresearch \
  --upstream autoresearch-worker \
  --port 8080 \
  --health-path /health \
  --wallet 0xYourWalletAddress \
  --chain base-sepolia \
  --per-hour 0.50 \
  --path /services/autoresearch-worker \
  --register-name "GPU Worker Alpha" \
  --register-description "A GPU worker for paid autoresearch experiments" \
  --register-skills devops_mlops/model_versioning \
  --register-domains research_and_development/scientific_research