iris.dev

Create Your First Sprite

This guide walks through registering a sprite, fetching it back, and verifying its fingerprint.

1. Start IRIS Core

Run the service locally (default base URL:http://localhost:8000).

2. Create a sprite

POST a sprite payload to/v1/sprites.

curl -s http://localhost:8000/v1/sprites \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "SOL-FORGE-01",
    "version": "1.0.0",
    "role": "architect",
    "capabilities": [
      {"name":"code_generation","description":"Generate production code","scope":"council"}
    ],
    "system_prompt": "You are FORGE...",
    "metadata": {"author": "you", "tags": ["core", "demo"]}
  }'

3. Fetch the sprite

Use the returnedid.

curl -s http://localhost:8000/v1/sprites/{id}

4. Verify the fingerprint

IRIS stores a hash of the canonical sprite representation.

curl -s http://localhost:8000/v1/sprites/{id}/fingerprint

Next

Go to theAPI explorerto create a council and execute a chain.