Vocion docs
These docs cover Vocion 7.x (main of vocion/vocion-core). 7.2 shows when an agent is working, with one AI colour and a theme that follows your device. 7.0 lets effort pick the model and runs goals as sprints. 6.0 added Routines. 7.3 adds client decks and docs. 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, GTM, Routines or Marketing 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 6.x | Vocion 7.0, under "What changed" |
| Upgrade from 5.x | Vocion 6.0: Routines, under "What changed for browser runs" |
| 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 |
| Do work on a site that has no API | Browser runs |
| Teach a task once and run it for a list | Routines |
| Run Google Ads with every change approved | Marketing |
| Set up Marketing for a Cloud client | Marketing for a Cloud client |
| Choose how hard a turn works, and on which model | Effort and models |
| Run a plan week by week | Goals and sprints |
| Build a client deck or document, and edit it anywhere | Decks and docs |
| Run it in production | Deploy on AWS · Self-host |
Sections
- Apps — Workforce, your assistant, Software Factory, GTM, Routines, Decks and docs, Marketing, and how to customize an app.
- Concepts — workspaces, agents and teams, asks and approvals, trust and learning, runs and evidence, artifacts, connectors and credentials, browser runs, effort and models, goals and sprints.
- 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.