Viewer - Getting Started
The Quale Viewer is the browser-based tool for inspecting evolved connectomes, watching replay simulations, and exploring how brains grow over evolutionary time.
Open quale.run in any modern browser. The landing page shows available experiments as cards with domain badges, fitness scores, and generation counts.
Data Source Modes
Section titled “Data Source Modes”The viewer has three data source modes, selectable from the header tabs:
| Mode | Description | Backend Required |
|---|---|---|
| Demos | Browse pre-run experiments hosted on Cloudflare R2. Always available, no setup needed. | No |
| Local | Connect to a quale serve instance running on your machine. See your own evolution results. | Yes |
| Sandbox | Run experiments on a remote engine. | Coming soon |
Connecting Locally
Section titled “Connecting Locally”To view your own evolution results:
- Run an evolution experiment:
quale evolve your-experiment.quale - Start the API server:
quale serve --port 8094 --dir checkpoints - Open quale.run (or
localhostif running the viewer locally) - Click Local in the header tabs
- Your experiments appear as cards - click one to inspect
The viewer auto-detects localhost and defaults to Local mode when accessed from localhost or 127.0.0.1.
Demo Experiments
Section titled “Demo Experiments”The Demos mode shows pre-run experiments with full replay data. Currently available:
| Experiment | Domain | Description |
|---|---|---|
| Survival Forager | Survival | 8-directional food/water sensing agent evolved over 441 generations |
| Signal Compliance | Rail | QLD Rail driver brain with AWS alerts, fatigue management, and signal obedience |
Domain filter tabs (All / Survival / Human Factors) let you filter experiments by domain.