Welcome to Hoziron
Hey there — glad you're here. Whether you're setting up your first instance, deploying to production, or building custom agent competencies, this documentation has you covered.
Hoziron is an enterprise AI agent infrastructure platform. It gives you a model-agnostic runtime for deploying, managing, and orchestrating AI agents with built-in data sovereignty, compliance guardrails, and multi-provider support.
Before anything else: the carrier licence
Every Hoziron instance — binary or Docker, cloud-routed or fully air-gapped — requires a signed carrier licence at $HOZIRON_HOME/licence.json before it will start serving traffic. There is no bypass. If you're setting up your first instance, read Getting Started: the carrier licence gate before you do anything else — it explains how a licence gets issued and where the file goes.
Where should I start?
That depends on what you're trying to do:
| I want to... | Start here |
|---|---|
| Get a running, licensed instance in under 20 minutes | Getting Started |
| Deploy to production (Docker, bare metal) | Deployment Guides |
| Create agents and competencies | Agent Guides |
| Connect to databases and APIs | Data Integration |
| Lock down security and auth | Security Guides |
| Understand the architecture | Architecture |
| Use the web dashboard | Dashboard |
| Fix something that's broken | Troubleshooting |
| Look up a CLI command or API endpoint | Reference |
| Get quick answers | FAQ |
Documentation structure
- Getting Started — Your first 20 minutes: install, get licensed, configure a provider, run your first agent.
- Guides — Task-oriented walkthroughs organized by topic: deployment, security, agents, competencies, workflows, data integration, providers, and catalog.
- Reference — Technical lookup: CLI commands, API endpoints, config file schema, error codes.
- Architecture — System design, data flow, object model, deployment topology.
- Internals — Deep dives into subsystems: provider routing, workflow engine, PII pipeline, security model.
- Dashboard — The web operations console (agents, workflows, catalog, observability, security, settings) — a real, shipping surface, not a future feature.
- Troubleshooting — Something went wrong? Diagnostics, common fixes, recovery procedures.
- FAQ — Quick answers to the questions everyone asks, including licensing.
- Compliance — Regulatory alignment documentation (in progress).
- Case Studies — Real-world deployment examples (coming soon).
A note on tone
We wrote this documentation for the carrier operators running Hoziron day to day — not for Hoziron's own engineering team. It's meant to be clear, practical, and respectful of your time. If something's confusing or missing, that's on us — please open an issue.
Related: