Guides

Task-oriented walkthroughs for everything you can do with Hoziron. Each guide starts with what you'll accomplish and ends with next steps.

Deployment

Get Hoziron running in your target environment:

Bare metal / VM — systemd, TLS, dedicated user
Docker Compose — compose file, volumes, health checks
Air-gapped — Local models, offline package transfer
TLS and networking — TLS config, IP allowlist, CORS, Unix sockets
Observability — Logging, Prometheus metrics, OpenTelemetry
Backup and restore — Create, list, and restore platform backups

Security

Lock down your deployment:

Authentication — API keys, OIDC/SSO configuration
RBAC — Roles, permissions, key management
Hardening checklist — Production security checklist
Audit trail — Enable, query, verify integrity

Agents

Create and manage AI agents:

Creating agents — Agent-template packages, AGENT.md format, auto-load
Lifecycle — Two-state machine: Suspended ⇄ Running (activate/suspend)
Sending messages — Chat, one-shot, API, channels
Scheduling — Cron jobs, event triggers

Competencies

Define agent behavior:

Using competencies — Install, declare on an agent, configure per-binding settings
Authoring — COMPETENCY.md, system prompts, testing
Publishing — Package, publish to registry (registry signs at publish time)

Workflows

Orchestrate multi-agent pipelines:

Creating workflows — workflow-template packages, workflow.json format, agent references, variables
Step modes — Sequential, FanOut, Collect, Conditional, Loop
Error handling — Fail, Skip, Retry with timeout configuration

Data Integration

Connect agents to your data:

Databases — PostgreSQL, MySQL, MSSQL patterns
APIs — REST, GraphQL, SOAP connections
File systems — Document processing, S3
Credentials — Vault, env vars, security patterns

Providers

Configure LLM providers:

Configuring providers — config.toml, API keys, testing
Local models — Ollama, vLLM, Docker networking
Complexity routing — Thresholds, model selection

Catalog

Manage packages and registries:

Browsing and installing — Search, install, update
Publishing packages — init, build, lint, sign, publish
Private registries — Add registries, auth tokens, scoped packages
Collections — COLLECTION.toml, closure invariant, install sets

Related: