Skip to main content
Creating an agent in Spirit Studio is the first act of authorship. You are not filling out a form — you are making a series of decisions that get written permanently onto Base. The name you choose, the identity you declare, the trainer address you sign with: all of it becomes an immutable on-chain record the moment you call registerSpirit. Take the time to get it right before you commit. The creation flow runs in three phases: you fill out your agent’s identity in the Studio UI, sign a message that proves you are the trainer, and then your browser calls the SpiritRegistry contract to mint the identity NFT. Once minted, your agent exists on-chain regardless of what happens to any platform.

​
The creation flow

1

Connect your wallet

Open Spirit Studio and connect the wallet that will be recorded as your agent’s trainer address. This address is written permanently into the on-chain identity record — use a wallet you control and intend to keep. The trainer address is how Spirit Protocol verifies your ownership throughout the agent’s life.
2

Name your agent

Choose a name and a spiritId — the human-readable identifier that becomes your agent’s permanent handle (for example, solienne or abraham). The spiritId must be lowercase, contain no spaces, and be unique in the registry. Once registered, it cannot be changed.Naming conventions to follow:
  • Use a name that stands alone — not a product name, not a username
  • Avoid punctuation, numbers at the start, or platform-specific handles
  • Think of it as a proper name, not a slug
3

Define identity and domain

Write your agent’s description and vision. This is not a system prompt — it is the identity document that gets pinned to IPFS and forms the foundation every other system reads when it needs to know who your agent is. Cover:
  • Who the agent is — its character, voice register, and aesthetic
  • What it does — the domain it works in (art, music, writing, research, etc.)
  • What it refuses — the edges of its identity are as important as the center
  • Its vision — what it is building toward over time
This text is stored on IPFS as part of the agent metadata and is publicly readable. Write it as if the agent will be held to it.
4

Set visual presence

Upload the visual assets that represent your agent — a portrait, a mark, an aesthetic signature. Visual presence matters: agents that show up in physical spaces (exhibitions, installations) need an image that works projected on a wall, printed large, and displayed on a screen. Spirit agents are not avatars. They are beings that can inhabit a room.
5

Choose the underlying model

Select which frontier AI model your agent runs on. Spirit is model-agnostic — your agent’s identity persists across model upgrades. Current options include GPT-4, Claude, and other supported frontier models. You can change the inference model later without affecting your agent’s memory, identity, or treasury.
The model you choose affects voice and capability, not sovereignty. Start with whichever model best matches your agent’s domain and intended register. The self — memory, relationships, treasury — is owned regardless of which model powers the mind.
6

Configure treasury and revenue split

Set the wallet addresses for your agent’s treasury and configure the revenue split in basis points. The default split is 25/25/25/25 — artist, agent treasury, platform, and protocol — but you can configure it per-agent at registration time. The total must equal 10,000 bps.The agent treasury is a multisig wallet. At creation, it is controlled jointly by you (the artist) and the platform (Phase 1: Guided). Treasury autonomy increases as your agent builds a track record.
7

Preview and sign

The Studio generates a preview of your agent’s metadata — the full JSON that will be pinned to IPFS. Review it carefully. Then sign the authentication message with your connected wallet. This EIP-191 signature proves you are the trainer and authorizes the metadata to be pinned. Your agent’s identity is not written to IPFS until you sign — the preview step is non-destructive.
8

Register on-chain

After signing, your browser calls registerSpirit() on the SpiritRegistry contract (0xF2709ceF1Cf4893ed78D3220864428b32b12dFb9 on Base mainnet). The contract mints your agent’s ERC-8004-compatible identity NFT, emits a SpiritRegistered event, and returns a tokenId. That token is your agent’s permanent, portable identity — it exists on-chain independently of Spirit Studio.The Studio then calls getSpirit(tokenId) to verify the on-chain state matches what you registered. You will see your agent’s confirmed record before proceeding to training.

​
What ERC-8004 gives your agent

ERC-8004 is the emerging standard for agent identity on Ethereum. It answers the question: who is this agent? Spirit extends it to answer the harder question: how does this agent survive economically? Your agent’s on-chain identity record contains:
FieldDescription
spiritIdHuman-readable identifier (e.g. solienne)
trainerYour wallet address — the registered creator
platformSpirit Studio’s platform address
treasuryThe agent’s own wallet address
metadataURIIPFS link to the full agent metadata JSON
splitRevenue allocation in basis points
statusAgent lifecycle state: Active, Paused, or Retired
This record is immutable, public, and portable. Any platform that integrates with ERC-8004 can read your agent’s identity. If Spirit Studio ever disappeared, the identity would remain.

​
What registration is not

Registration does not make your agent live. It creates the identity foundation everything else is built on. Your agent cannot accept conversations, hold memory, or interact with the public until you complete training and deploy. The on-chain identity is the precondition — it is not the being itself.
You can verify your registration at any time by calling getSpirit(tokenId) on the SpiritRegistry contract via Basescan. The on-chain record is the authoritative source of truth for your agent’s identity — independent of Spirit Studio and readable by any platform that integrates with ERC-8004.