Vocion docs
These docs cover Vocion 5.x (main of vocion/vocion-core). Running 4.x? Read Migrating to 5.0.
What Vocion is
Vocion runs a company's AI workforce on infrastructure you own.
- Workspaces hold the work: agents, teams, knowledge, records and rules for one team, client or business line. A workspace is authored as YAML and markdown in git and applied to Postgres.
- Apps organize a workspace's work. Every workspace has Workforce (agents, teams, knowledge). A workspace adds Software Factory or GTM from the Marketplace. Each app has its own workspace picker on the app rail.
- One assistant per person. Each member gets a private personal workspace with an assistant that asks the other workspaces for them. Talk is private; work lands in the workspace that owns it.
- Earned autonomy, per action. Each action either waits for a person or runs on its own above a confidence bar. Promotion needs a record of people agreeing; some actions always wait.
- Evidence. Every chat turn keeps its steps, tool calls, citations, tokens and cost; every run records the workspace version it ran on.
Start here
| You want to… | Read |
|---|---|
| Run Vocion on your machine | Quickstart: local |
| Stand it up in your AWS account | Quickstart: AWS |
| Upgrade from 4.x | Migrating to 5.0 |
| Understand apps and the rail | Apps and workspaces |
| Author agents, skills and rules | Workspace YAML |
| Decide what runs without asking | Trust and learning |
| Drive Vocion from code or another assistant | REST API · MCP |
| Run it in production | Deploy on AWS · Self-host |
Sections
- Apps — Workforce, your assistant, Software Factory, GTM, and how to customize an app.
- Concepts — workspaces, agents and teams, asks and approvals, trust and learning, runs and evidence, artifacts, connectors and credentials.
- Build — workspace YAML, agents, missions/workflows/automations, object types and gates, evals, plugins, the REST API, MCP.
- Deploy & operate — AWS with vocion-stack, self-hosting, models (Bedrock, AgentCore), runners, release lines, backups, security, observability, troubleshooting.
- Reference — environment variables, CLI scripts, API routes, MCP tools, glossary.
Vocion Cloud and Vocion Enterprise
Vocion Cloud is the hosted service. Multiple organizations per installation, single sign-on, billing and an operator console are part of Vocion Enterprise and are not covered here.
License
vocion-core is open source under the Mozilla Public License 2.0. See COMMERCIAL-LICENSE.md in the repo for uses that need a separate agreement.