@gemwright/ai
@gemwright/ai runs AI residents: headless players that log in to a ServUO shard as real clients do. Each resident runs one loop:
perception → goal/planning → profession loops → action arbiter → networkgemwright shard deploy --ai deploys it for you. It runs on its own against any compatible server; see Existing servers.
Resident service
Section titled “Resident service”Requires Bun 1.4.3 or newer.
npm install @gemwright/aicd node_modules/@gemwright/aiAI_DATA=/path/to/data UO_HOST=127.0.0.1 GEMWRIGHT_SHARD="$(cat /path/to/gemwright.json)" bun dist/serve.js| Variable | Meaning |
|---|---|
AI_DATA |
Persistent directory, including assets/ (default: /app/data) |
UO_HOST |
ServUO endpoint (required) |
UO_PORT |
Server port (default: 2593) |
GEMWRIGHT_SHARD |
Shard configuration JSON (required) |
TYPESAFE_API_KEY |
Required when decisions use Jev |
CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_API_TOKEN |
Required for Clef |
ANTHROPIC_API_KEY |
Required when ai.speech is claude |
bun dist/index.js --help lists commands to validate and plan a population, inspect residents, decisions, skills and dungeon runs, and run single sessions or a whole population against a server.
npm · MIT
