Two-Brain Studio

Desktop GUI for two-brain-audit — configure, run, and review audits without touching the CLI.

What It Does

• Open any folder as an audit project (or create a new one)
• Pick a preset (Python, API, Database, Infrastructure, ML) or register custom dimensions
• Run audits at any tier (light/medium/daily/weekly) with one click
• View results — grade ring, score bars, divergence alerts, confidence levels
• Edit manual grades — the "right brain" baseline editor with grade dropdowns and notes
• Export reports — Markdown, JSON, CSV with one click
• Recent projects — quick access to your last 10 projects

Install

pip install two-brain-studio

Launch

two-brain-studio

Or on Windows, double-click launch.bat (uses pythonw.exe — no console flash).

Screenshots

Coming soon — the app is a dark-mode native window with sidebar navigation.

Requirements

• Python 3.10+
• two-brain-audit >= 0.1.2
• Flask >= 3.0
• PyWebView >= 5.0 (falls back to browser if unavailable)

How It Works

Studio is a PyWebView native window hosting a Flask server. The UI is a single-page app with sidebar navigation — all rendering happens client-side via safe DOM construction. The Flask backend wraps two-brain-audit's Python API for project management, dimension configuration, baseline editing, and audit execution.

┌─────────────────────────────────────┐
│  PyWebView (native window)          │
│  ┌───────────────────────────────┐  │
│  │  Flask Server (localhost)     │  │
│  │  ┌─────────────────────────┐  │  │
│  │  │  two-brain-audit engine │  │  │
│  │  │  (scores, baseline, DB) │  │  │
│  │  └─────────────────────────┘  │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

Development

git clone https://github.com/SwiftWing21/two-brain-studio.git
cd two-brain-studio
pip install -e ".[dev]"
python -m two_brain_studio.app

License

MIT