Recommended / Windows
Download the starter package
A versioned ZIP with the Qoresence source, installer, launcher, pilot docs and MCP adapter. The installer creates .venv inside the package and keeps the environment local to it.
Windows starter package / local-first
From download
to live plane.
Qoresence ships as a transparent Windows package: source included, dependencies installed into a local virtual environment, and no cloud account required for the core pilot.
Windows 10 / 11Python 3.11+Capture card optional at setup
Choose your lane.
The starter package is the fastest path for a Windows pilot. Developers can clone the repository instead. Both paths run the same code and the same health checks.
Developer / source
Clone from GitHub
Use this path when you want to contribute, inspect the architecture or run the full test suite.
Three steps to ready.
The installer is intentionally boring. It does not hide the Python environment or silently turn on cloud integrations.
STEP / 01
Unzip
Extract the package to a folder you own, for example C:\Qoresence. Avoid a protected system directory.
STEP / 02
Install
Right-click Install-Qoresence.ps1 and run with PowerShell, or use the command below from the package folder.
powershell -ExecutionPolicy Bypass -File .\Install-Qoresence.ps1
STEP / 03
Launch
Connect the capture card when you are ready, then start the local Deck and AgentGlass surface.
.\Start-Qoresence.bat
What the package contains.
Included
- Qoresence source and command-line launcher
- Deck, Monitor, AgentGlass and MCP adapter
- Windows installer and pilot launcher
- Profiles, examples and operational docs
- Streamer, controller, visual, Twitch and MCP dependencies
Not bundled
- Capture-card drivers or vendor firmware
- API keys, Twitch tokens or other secrets
- Large game models and optional OCR stacks
- OBS itself — use Browser Source when Qoresence owns the card
- A signed native EXE; this release is transparent Python packaging
Hardware rule: one physical HDMI/DShow device gets one owner. For the lowest-lag path, close OBS's physical capture source before starting Qoresence. OBS can consume
http://127.0.0.1:8765/overlay.html as a Browser Source.First health check.
You can verify the software and AgentGlass without a capture card. Live video becomes healthy only after the card is enumerated and frames begin flowing.
curl http://127.0.0.1:8765/health
curl http://127.0.0.1:8765/api/agent/health
curl http://127.0.0.1:8765/api/agent/diagnose
Software greenDeck responds, AgentGlass says
running: true, and the sequence advances.Live green
video.age_s < 1, frames and pushes climb, and diagnose returns HEALTHY.Keep the boundary local.
AgentGlass is default-off and read-only. MCP can inspect the session without opening the capture card. Twitch, A2A and research integrations remain opt-in.