FAQ

Everything you need to know about OpenPersona. Can't find your answer? Ask Ember — click the in the bottom-right corner.

Getting Started

What is OpenPersona?+

OpenPersona is an open platform and emerging standard for defining, composing, sharing, and deploying AI agent personas. Think of it like OpenAPI, but for agent personalities. You compose personas from modular building blocks and export them as standardized files ready for any AI project.

How do I create a persona?+

Head to The Forge and walk through the 7-step wizard. Pick qualities from each bucket — identity, communication style, personality, expertise, and more. You'll see a live preview as you build. Download as JSON or Markdown when you're done, no account required.

Do I need an account?+

No — you can browse the library, compose personas in The Forge, and download files without an account. An account lets you save personas, bookmark favorites, star content, and manage API keys.

Is it free?+

Browsing, composing, and downloading personas is completely free. The REST API has tiered rate limits (Free/Pro/Team/Enterprise). The OpenPersona Standard itself is licensed under Apache 2.0 — fully open.

Personas & Qualities

What are qualities?+

Qualities are modular personality building blocks organized into 7 categorical buckets. Each quality represents a specific trait, skill, or characteristic. You assemble qualities like puzzle pieces to build a complete persona.

What are the 7 quality buckets?+
  1. Core Identity — who they are (pick 1)
  2. Communication Style — how they talk (pick 1)
  3. Personality & Philosophy — what drives them (pick 1-3)
  4. Expertise & Specialization — what they know (pick 1-3)
  5. Technology & Tools — their tech stack (optional, 0-3)
  6. Team Configuration — their team role (optional, 0-2)
  7. Personal Life — the human side (optional, 0-2)
What's the difference between Standard and Custom qualities?+

Standard qualities are generic, reusable building blocks that appear in The Forge — things like "Warm & Encouraging" or "Testing & QA Specialist." Custom qualities are persona-specific details crafted by admins that make curated personas unique — specific catchphrases, detailed methodology, backstory specifics.

How do I use a downloaded persona?+

Drop the .openpersona.json or .openpersona.md file into your AI agent's configuration. The system prompt is included and ready to use with Claude, ChatGPT, or any LLM. For team-based agents, download the ZIP which includes all member personas plus a coordination document.

Teams

What are teams?+

Teams are coordinated groups of personas that work together. Each team has a coordination document, routing matrix (who handles what), and defined member roles. Download a team as a ZIP file with all member personas included.

How many teams are available?+

We currently have 15+ curated teams spanning development, operations, finance, legal, medical, and more. Browse them all at /browse/teams.

For Developers

What's the OpenPersona Standard?+

A dual-format specification (JSON Schema + Markdown with YAML frontmatter) for representing AI agent personas. Both formats are first-class citizens. The standard is versioned independently and licensed under Apache 2.0. Full spec at /docs/standard.

Is there an API?+

Yes — a full REST API at /api/v1/ with endpoints for personas, teams, qualities, categories, search, and leaderboard. Public endpoints need no auth. Authenticated endpoints use Bearer tokens with op_live_ prefixed API keys. Docs at /docs/api.

What's the MCP server?+

A Model Context Protocol server at /mcp that lets AI agents browse and retrieve personas programmatically. It exposes tools like list_personas, get_persona, list_teams, get_team, list_categories, and search. Config and docs at /docs/mcp.

Can I integrate OpenPersona into my app?+

Absolutely. Use the REST API for web/mobile apps, the MCP server for AI agent frameworks, or simply download persona files and bundle them with your project. The Standard is designed to be consumed by any system.

The Forge

What is The Forge?+

The Forge is the interactive persona composer. Walk through 7 steps, picking qualities from each bucket. A live preview panel shows your persona taking shape in real-time. Export as JSON or Markdown when done, or save to your account.

Can I edit a persona after saving?+

Yes — saved personas appear in your dashboard at /dashboard/personas. You can chat with them to test the personality, and Enhancement templates let you add depth (catchphrases, backstory, methodology) beyond the base qualities.

About

Who created OpenPersona?+

OpenPersona was created by Jaye Miller at Liquidstyle Digital. It's a passion project to establish the open standard for AI agent personalities.

Can I contribute or submit personas?+

We're working on community submission features. For now, you can compose and share personas via The Forge. If you're a developer interested in contributing to the standard, the spec is open source under Apache 2.0.

What's the licensing?+

The OpenPersona Standard (JSON Schema, format spec) is Apache 2.0 — use it freely. The platform (openpersona.io codebase) is proprietary. Example personas from partners are CC BY 4.0 (shareable with attribution).