Sprite quickstart

Steps

1. Create a Sprite and open a shell on it.
2. Download the template with bootstrap.sh.
3. Put your model in model.mts and describe it in manifest.json, under your team's namespace, which ShockAI assigns. Start the server with the Sprite's own address as PUBLIC_ORIGIN.
4. Make the Sprite's address reachable without a Fly login: sprite url update --auth public. Every request to your model is still checked by its signature.
5. Connect it from your team's Models page with the Sprite's address and /shockai/v0 after it. What your team needs first.

# On the Sprite
curl -fsSL https://app.shockai.co/developers/templates/v0/bootstrap.sh | sh -s -- node
PUBLIC_ORIGIN=https://<your-sprite-url> BUILD_HASH=<your build> node shockai-model/server.mts

# From your machine: let the platform reach it without a Fly login
sprite url update --auth public

Why the platform sends no Authorization header

Fly's edge reads any Authorization: Bearer header as its own access token. The platform authenticates with ShockAI-Signature instead, so your address stays public and your server checks every request itself.

A Sprite that sleeps

A Sprite may sleep when idle. The platform may call /healthz first to wake it, and asks once more after a pause when a request finds it asleep. Keep your runs in data/, so a restart fails a run honestly rather than losing it.