Get started

Introduction to Quox

Put AI agents to work on your own systems. Keep a receipt of what they did.

Maturity: Beta overall. This page is an overview. Each capability links to its own page, and each of those pages states its own maturity.

At a glance
What it isQuox is a control plane for AI agents. Agents get real access to your systems, and you decide what they may do, approve what matters, and keep a record of every governed action.
Where it runsQuoxCORE runs on your own server, in Docker. The quox command line talks to it from any machine.
When to reach for itYou want AI agents doing real operational work, and you need to say yes before anything risky happens and prove afterwards what was done.
How to startcurl -fsSL https://get.quox.ai | sh, then follow Install and deploy.

The five ideas

IdeaWhat it meansWhere to try it
AgentsSpecialist AI assistants, each with its own job and toolset, coordinated by CommanderQ. QuoxCORE ships agent definitions for security, infrastructure, networking, monitoring, research and more.quox chat, or the dashboard's chat
ToolsThe actions an agent can take: read a host, run a command, call an integration, start a workflow. An agent can only use the tools it is granted.Agents
ApprovalsRisky actions pause and ask a human. The agent proposes; a person approves or rejects; only then does it run.quox approvals list
Safety levelsAn instance-wide level from GREEN to RED. ORANGE sends autonomous work to a human instead of running it. RED halts new autonomous work and stops running loops.quox safety status, quox safety defcon
EvidenceGoverned actions are recorded as signed envelopes in a hash-chained log, so the record cannot be quietly edited later. You can download a run's evidence and check it yourself.quox volt fetch <runId>, then quox volt verify <file>

How a request flows

You ask, in chat or with `quox chat`
  -> CommanderQ picks the agent for the job
  -> the agent chooses a tool it is granted
  -> policy and the safety level are checked
  -> risky? it waits for your approval
  -> the tool runs: on this server, or on a host through QuoxAgent
  -> the action is recorded as evidence
  -> you get the answer

Hosts you want agents to work on run QuoxAgent, a small per-host daemon. Without it, agents work on the QuoxCORE server and its integrations only.

What is in the box

QuoxCORE installs as eleven containers on one server. The ones you will meet first:

PartJob
DashboardThe web app, over HTTPS on port 3000
CollectorChat, agents, tools, fleet and AI routing
AuthAccounts, organisations, roles
Memory and QortexWhat agents remember, and the knowledge layer they search
QuoxFlowThe workflow engine

The full list, with ports, is in Install and deploy.

You bring the model

Quox does not include an AI model. You connect the provider your organisation already uses, with a key or a self-hosted server:

bash
quox provider connect anthropic --key-from-stdin
quox provider connect ollama http://<host-lan-ip>:11434

Supported kinds in CLI 0.3.1: openai, anthropic, ollama, openrouter, huggingface, groq, together, lmstudio, vllm and custom.

Limits

  • This page is an overview, not proof. The five ideas above are built and ship in QuoxCORE. How far each has been driven live is stated on its own page.
  • A fresh install has not yet been driven to a first chat answer. The install itself is proven; the first-answer step is next. See Install and deploy.
  • No model is included. Agents do nothing until you connect a provider.

Last verified 2026-10-29 against QuoxCORE 1b8bf54d and CLI 0.3.1 (code), plus the install run of 2026-10-27.