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
• Kubernetes — Helm chart, values-prod, PDB, HPA
• 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 — Templates, manifests, auto-load
• Lifecycle — State machine, start/stop/suspend/resume
• Sending messages — Chat, one-shot, API, channels
• Scheduling — Cron jobs, event triggers

Competencies

Define agent behavior:

• Using competencies — Install, activate, configure, monitor
• Authoring — COMPETENCY.toml, system prompts, testing
• Publishing — Package, sign, publish to registry

Workflows

Orchestrate multi-agent pipelines:

• Creating workflows — 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:

• Getting started
• Reference
• Architecture