UPEX (Universal Personality Exchange Format)

English | 中文

UPEX (.ujson) is an open standard for exchanging LLM character personas/agents across different platforms and models.

It is designed to be simple, readable, and extensible, serving as the "glues" between character creation tools, role-play platforms (like SillyTavern), and AI agents.

Why UPEX?

• Universal File Extension (.ujson): Instantly recognizable. JSON syntax with specific schema validation.
• Developer Friendly: Native JSON Schema support means auto-completion and validation in VS Code without plugins.
• Multi-line Support: Solves the JSON string pain point by allowing string arrays for long prompts.
• Schema-First: Built for stability and easy integration into 3rd-party tools.

Quick Start

A minimal valid .ujson file:

{
  "spec": "upex",
  "version": "1.0",
  "character": {
    "name": "Helpful Bot",
    "description": "A basic assistant.",
    "persona_text": [
      "You are a helpful assistant.",
      "You love coding."
    ]
  }
}

See examples/ for more complex scenarios.

Specification

The full technical specification is available in SPEC.md.

The JSON Schema is located at schema/upex.v1.schema.json.

License

• Specification & Schema: CC0 1.0 Universal (Public Domain)
• Tools & Code: MIT License