Tamer

Generate or Choose Your Companion

Head to Generations and create a new character, or browse existing characters to find one that speaks to you.

import { PUClient } from 'pu-client';

const client = new PUClient({ apiKey: process.env.PU_API_KEY! });

const generationId = await client.generations.create({
  type: 'character',
  input: { prompt: 'A wise fox spirit with silver fur and glowing blue eyes' },
});

Create Your NPC

Turn the character asset into a living NPC:

const npc = await client.npcs.create({
  name: 'Kitsune',
  src: 'characterlive:your-character-uuid',
});

Customize Personality

Configure your companion's traits, temperament, and behavior through the NPC settings panel at /npcs/{id}/settings, or via the API:

await client.npcs.update(npc.id, {
  tools: {
    web_search: { enabled: true },
  },
});

Start a Conversation

Chat with your companion directly:

const threads = await client.npcs.listThreads(npc.id);
const messages = await client.npcs.getThread(npc.id, threads[0].id);

Or use the Quickchat panel in the app for a real-time conversation.

Watch Them Grow

Your companion remembers past interactions, learns from your conversations, and can act autonomously in the world. Enable autonomous behaviors in the NPC settings to let them explore, interact with other characters, and evolve while you're away.