We're open-sourcing the Qoc core
The desk runtime, workspace schema, and CLI that power Qoc are now available under an open license. Here's what's in the repo and how to run your own.
Starting today, the core of Qoc — the workspace runtime, the proposal engine, and the qoc CLI — is open source.
Why open source, why now
A trading desk you can't inspect is one you can't fully trust. We built Qoc on the premise that every trade should be auditable — a commit you can read, revert, or question. It would be inconsistent to hold the desk itself to a different standard.
Opening the core also removes the biggest friction point we heard from early users: 'I want to run this entirely on my own infrastructure.' Now you can. The cloud layer remains optional for sync and notifications; the desk itself runs anywhere you can run a terminal.
What's in the repo
The repository at github.com/qoc-app/qoc contains the workspace schema (desk.toml, entities/, inbox/, issues/, schedules/, snapshots/, research/, orders/), the proposal engine that turns agent output into reviewable diffs, the guard layer for pre-trade risk rules, and the full qoc CLI.
What's not in the repo: the hosted sync service and the web dashboard. Those remain proprietary. Everything you need to run a local desk — research, propose, approve, execute — is in the open repo.
Self-host in four steps
- 1
Install the CLI
Run
npm install -g @qoc-app/qocor pull the binary from the releases page on GitHub. Requires Node 20+ or the standalone binary. - 2
Initialize a workspace
Run
qoc initinside an empty directory. This writes adesk.toml, creates the folder scaffold, and sets up a local git repository for history. - 3
Connect a venue
Edit
desk.tomlto add your broker or exchange credentials. Qoc uses an adapter model — community adapters live in theadapters/directory of the repo. - 4
Open the desk to your agent
Point Claude Code or any MCP-capable agent at your workspace directory. The agent can now read context, produce proposals, and wait for your approval before touching an order.
Quick start
npm install -g @qoc-app/qoc
mkdir my-desk && cd my-desk
qoc init
# edit desk.toml to add venue credentials, then:
qoc statusV0.73.0 BETA
The open-source release tracks the same version as the hosted product. Both are currently in beta. The workspace schema is stable; the adapter API may have breaking changes before 1.0.
Check the release notes in the repo before upgrading across minor versions.
How to contribute
The most useful contributions right now are venue adapters and guard rule templates. If you've built a connection to a broker or exchange that isn't in the repo yet, a pull request is welcome.
Bug reports, documentation fixes, and test coverage improvements are equally valued. Open an issue on GitHub or reach us at [email protected] if you want to discuss a larger change before writing code.