← Back to Studio

Documentation

A practical guide to creating, testing, and publishing Venice.AI characters with Character Studio.

Your First Project

Create a new project, choose between local folder and browser storage, and send your first message to a character.

›

Before You Begin Storage Modes: Choosing Where to Keep Your Project Creating Your First Project What Gets Created Your First Conversation What to Do Next

Writing Your Character

The Instructions and System Prompt tabs, using the AI generator, and setting up the Description and Intro for Venice publishing.

›

The Instructions Tab Using Generate and Polish The System Prompt Tab The Description Tab The Intro Tab The Photos Tab Saving and History

Context & World Building

Supply background knowledge the model can draw on without cluttering the Instructions: world lore, NPC lists, location descriptions, and more.

›

What Context Files Do The Context Tab What Belongs in Context Context vs Instructions When Context Is Too Much Agent-Only Files (Dot Prefix) Remapping the Context Location

Testing Your Character

The full chat toolbar: Playtest, Resubmit, Mark Unacceptable, Fork, Collapse to Here, Ignore, and the Input Corrector.

›

The Chat Toolbar Overview Sending Messages Playtest Mode Resubmit Last Mark Unacceptable Editing Messages Truncate Ignore / Restore Fork Conversation Collapse to Here Input Corrector Push-to-Talk

Managing Conversations

Create, rename, fork, collapse, import, and export conversations. Keep your test runs organized without losing any thread.

›

Why Multiple Conversations Creating a New Conversation The Conversations Panel Renaming Conversations Fork: Branch a Conversation Clone: Branch the Whole Project Collapse to Here: Summarize Long Conversations Import & Export Keyboard Shortcuts

Image & Video Sessions

Generate and manage images inside your project, animate them into video, and use Visualize to turn great story moments into image prompts automatically.

›

Overview Creating an Image Session The Visualize Button: From Story to Image Prompt The Prompt Bar Uploading Photos The Gallery Image Action Buttons Editing Images with AI Image-to-Video The Jobs Panel

The Agent System

Persistent memory, character stats, quest logs, NPCs, calendar, events, and more. How to choose the right agents for your character and configure them.

›

What Agents Are Enabling Agents The Agent Command Dialog The Agent Store Panel The Agent Log Default Agent Data Built-in Agents Composable Data Lookup Agents Custom Agent Files Python Agents Lua Agents Library Files The Unverified Agent Warning Choosing the Right Agents Writing Agent-Aware System Prompts

Prompt-defined assistants the model can delegate to — no code required. Frontmatter authoring, agent grants, private state for NPC secrets, the builder, and token-cap protections.

›

What Sub-Agents Are Your First Sub-Agent The Frontmatter Reference Registering in config.json Macros Conversation Visibility Sub-Agents vs. Context Search Testing with @ Commands Agent Grants Default Data for Private Instances The Model Policy Token Caps and Metering The Sub-Agent Builder Generate and Polish Size and Cost Warnings Security and Trust Sub-Agents in the Players

Advanced Configuration

The config.json deep dive: per-project model overrides, file mappings, Live Edits, voice and Push-to-Talk settings, and the Input Corrector.

›

Overview of config.json Model Overrides File Mappings Command Palette Voice and Push-to-Talk Settings Input Corrector Visualize Settings Per-Project Agents Settings Hierarchy The .gitignore Tab

Publishing to Venice.AI

Copy the right fields into Venice's character editor, set up photos, and back up your project before you publish.

›

What Venice Needs The Export Fields Dialog The Description Tab The Intro Tab Portrait and Photos Before You Publish Backing Up Before You Publish Iterating After Publish

Developer Reference

API contracts for the three developer roles: writing agents, building a character player, and embedding a character in a website or application.

›

Architecture Overview The Character Package Part 1 — Agent Authors Part 2 — Player Implementors Part 3 — Character Consumers

The Player and PartyLine

Play characters solo in the Player or together in PartyLine, share them with a URL, and keep everything backed up.

›

Two Ways to Play The Shared Character Library Your Studio Projects Appear Automatically Sharing Characters by URL Playing Solo: The Player PartyLine: Your Party Library Building a Party Talking to the Party Eagerness and Sleep Whispers Editing the History Conversations and Agents in a Party Party Backup and Restore The Menu and Settings