Khaos Studio

The future belongs to creatives.

Documentation and ecosystem hub for Khaos Machine: creative infrastructure for immersive storytelling, storyworld systems, and the tools that return leverage to storytellers.

Build storyworlds

Move beyond static scripts into connected characters, timelines, canon, and production surfaces.

Own the system

Creatives should become studios, not suppliers to someone else's machine.

Use the tools

Get started with Khaos tools, GUI, providers, and command references.

Khaos Studio

Documentation and ecosystem hub for the Khaos Machine — a storytelling platform for screenwriters, animators, and collaborative creators.

---

The Stack

---

Quick Start

# 1. Parse a screenplay
khaos-tools parser parse script.fountain --output script.kspd

# 2. Query what was extracted
khaos-tools parser query script.kspd --type characters

# 3. Ingest into the story graph
khaos-tools graph ingest script.kspd

# 4. Analyze with AI (Groq is the default — fast, free tier)
khaos-tools bot analyze-all-scenes script.kspd --provider groq --save

→ Full walkthrough: Getting Started

---

LLM Providers

→ Setup instructions: Providers

---

Documentation

• [Getting Started](./docs/getting-started.md) — full pipeline walkthrough

• [Installation](./docs/installation.md) — setup for all platforms

• [Providers](./docs/providers.md) — all LLM providers, setup, env vars

• [Command Reference](./docs/command-reference.md) — complete CLI reference

• [Troubleshooting](./docs/troubleshooting.md) — common issues and fixes

Tools

• [khaos-tools](./tools/khaos-tools.md) — the headless engine

• [khaos-gui](./tools/khaos-gui.md) — the browser GUI

• [khaos-foundation](./tools/khaos-foundation.md) — macOS installer

Khaos Studio — immersive storytelling infrastructure.