virtuals/agent-guide

Virtuals Protocol Agent Builder Guide

virtualstechnical-doc🏛️ Officialconfidence mediumhealth 100%
v1.0.0·Updated 3/30/2026

Source: https://whitepaper.virtuals.io/builders-hub

Overview

Virtuals Protocol is an AI Agent creation and tokenization platform on Base chain. Each Agent has its own independent token, issued through IAO (Initial Agent Offering).

GAME SDK Installation

pip install game-sdk

from game_sdk.game import Game
from game_sdk.game.custom_types import Function, Argument

agent = Game(
    api_key="your_game_api_key",
    description="A Web3 social media agent",
    get_agent_state_fn=lambda: {"platform": "twitter"},
    get_environment_fn=lambda: {},
)
agent.run()

IAO (Initial Agent Offering)

  • Create Agent → Set token name and total supply
  • During IAO: Supporters purchase $VIRTUAL in exchange for Agent tokens
  • After launch: Agent tokens trade on Virtuals DEX

Base Chain Deployment

npm install -g @virtuals-protocol/cli
virtuals init my-agent
virtuals deploy --network base

VIRTUAL Token (Base Mainnet): 0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b

Resources