Read .char files from the command line

Installing the Python SDK also installs an omnichar-sdk command.

pip install omnichar-sdk

Inspect a character

omnichar-sdk inspect Ada.char

Ada  (2 references, format 1)

Ada, a woman in her thirties with short dark hair and a scar through her left eyebrow.

references: 1 body, 1 face
reference sets: flux2-klein
adapter z-image: rank 16, 600 steps, strength 0.8
  partial: Z-Image adapter keys match 210 of 238 module stems. The remaining 12 percent will not be applied, so the result is a near miss rather than a failure.
hint: Add a profile view.

Add --json to print the whole character record. A tool in any language can read a .char this way without a Python binding.

omnichar-sdk inspect Ada.char --json

Extract its files

Writes the references, the description and any adapters into a folder: refs/000_face.png, description.md, Ada-z-image.safetensors and so on.

omnichar-sdk extract Ada.char -o out/

Print prompt text

omnichar-sdk prompt Ada.char --style token

--style takes ordinal, token, at-image or description-only. See Prompt text for which model reads which. --first-position, --arch and --role-lines match the Python options.

Write a reference sheet

omnichar-sdk sheet Ada.char -o ada.png

Takes --arch, --role, --max-references, --first-position and --columns. Needs the images extra: pip install 'omnichar-sdk[images]'.

Get started

Omnichar Cloud

Omnichar Studio

ComfyUI node

Integrations

Read .char files from the command line

Inspect a character

Extract its files

Print prompt text

Write a reference sheet

​Inspect a character

​Extract its files

​Print prompt text

​Write a reference sheet

Inspect a character

Extract its files

Print prompt text

Write a reference sheet