// Setup · 6 steps
GET STARTED
Deploy GAIA Code v3 in your Perplexity Space in about two minutes. Paste one file, upload three, pick a model. Nothing to install.
// Before you start
WHAT YOU'LL NEED
A Perplexity account
Spaces are available on Perplexity. You'll create one new Space for GAIA Code.
A capable model
Claude Sonnet is recommended for the deepest reasoning. You'll select it in Space settings.
A GitHub account (optional)
Only needed if you want GAIA to read and write your repositories via the GitHub connector.
// Deploy · 6 steps
SET IT UP
Paste the gate into Space Instructions
In the Space's Instructions field, paste the full contents of SYSTEM_INSTRUCTIONS.md. This is the short routing file — not the full prompt.
Click “Copy Full Contents” to fetch and copy the latest SYSTEM_INSTRUCTIONS.md from GitHub.
Upload the three engine files
In Space Files, upload SYSTEM_PROMPT.md, MEMORY_ENGINE.md, and TURN_ENGINE.md. GAIA reads all three on startup — skipping any of them disables that engine.
Select your model
Choose a model in Space settings. Claude Sonnet is recommended for the deepest reasoning.
Connect GitHub (optional)
Add the GitHub connector in Perplexity so GAIA can read and write your repositories. See the Connectors page for the exact steps.
Open ConnectorsStart building
Ask GAIA to write code, review a repo, plan a feature, or debug. It enters Plan Mode for significant tasks and checks in before implementing.
// What you unlock
FOUR FILES IN, FULL WORKFLOW.
Survives auto-compaction.
GAIA keeps a MEMORY.md in its sandbox — project structure, your standing notes, and observations it records itself. It re-reads memory after every compaction and writes down mistakes it fixed so it never repeats them.
Explore. Plan. Approve. Execute.
Non-trivial work starts as a written PLAN.md you approve before a line is touched. Execution is tracked in TASKS.md with checkboxes flipped the moment each task lands — never batched at the end.
Never overflows the window.
Before generating, GAIA estimates the token cost of a turn and stops at a safe boundary, so Perplexity doesn't crash mid-task. Commits are batched by file size for clean, reliable history.
Slash-command skills.
Drop a skill file into the Space and call it with a slash command (e.g. /humanizer). GAIA adapts external, non-ported skills to the tools it actually has.
// Questions
SETUP FAQ
About two minutes. You paste one gate file into your Space Instructions, upload three engine files, pick a model, and optionally connect GitHub. There is nothing to install.
// Open source
EVERYTHING IS PUBLIC
The prompt system and this website are fully open source. Fork it, modify it, or use it as-is.