Quickstart

MIG Quick Start

This quick start gets you to a working MIG runtime and a successful HELLO / DISCOVER / INVOKE flow.

Estimated time: about 10 minutes.

Prerequisites

Running MIG runtime (migd)
curl

1) Start the runtime

Start your MIG runtime on http://localhost:8080.

2) Check runtime health

curl -sS http://localhost:8080/admin/v0.1/health/conformance

Expected shape:

{"core":true,"streaming":true,"evented":true,"full":true}

3) Run core MIG calls

HELLO

curl -sS -X POST http://localhost:8080/mig/v0.1/hello \
  -H 'Content-Type: application/json' \
  -H 'X-Tenant-ID: acme' \
  -d '{
    "header": {"tenant_id": "acme"},
    "supported_versions": ["0.1"],
    "requested_bindings": ["http"]
  }'

DISCOVER

curl -sS -X POST http://localhost:8080/mig/v0.1/discover \
  -H 'Content-Type: application/json' \
  -H 'X-Tenant-ID: acme' \
  -d '{"header": {"tenant_id": "acme"}}'

INVOKE

curl -sS -X POST http://localhost:8080/mig/v0.1/invoke/observatory.models.infer \
  -H 'Content-Type: application/json' \
  -H 'X-Tenant-ID: acme' \
  -d '{
    "header": {"tenant_id": "acme"},
    "payload": {"input": "hello MIG"}
  }'

4) Optional: verify event flow

Open an SSE subscription:

curl -N http://localhost:8080/mig/v0.1/subscribe/observatory.inference.completed \
  -H 'X-Tenant-ID: acme'

Publish an event:

curl -sS -X POST http://localhost:8080/mig/v0.1/publish/observatory.inference.completed \
  -H 'Content-Type: application/json' \
  -H 'X-Tenant-ID: acme' \
  -d '{
    "header": {"tenant_id": "acme"},
    "payload": {"status": "done", "job_id": "job-1"}
  }'

The subscription terminal should receive the event.

5) Optional: JWT mode

Start runtime with JWT auth enabled and a strong secret value:

MIGD_AUTH_MODE=jwt \
MIGD_JWT_HS256_SECRET=<set-a-strong-secret> \
migd

In JWT mode, include:

Authorization: Bearer <token>
X-Tenant-ID: <tenant>

Troubleshooting

tenant_id is required: include tenant in header and request body.
missing bearer token or invalid bearer token: check JWT mode and token claims.
capability not found: run DISCOVER and invoke an advertised capability ID.