Your First Agent

What you'll accomplish: Create an agent, chat with it interactively, send one-shot messages, and equip a competency.

Prerequisites

You should have a running Hoziron instance. If not, pick an install method:

Create an agent from a template

hoziron agent new assistant

This spawns an agent using the built-in assistant template and starts it automatically.

Chat interactively

hoziron chat

This opens an interactive chat session with your default agent. Type messages and get responses. Press Ctrl+C to exit.

Send a one-shot message

hoziron message my-agent "Summarize the key points of our insurance policy renewal process"

One-shot messages are great for scripting and automation.

Create an agent via the API

If you're running Hoziron as a container or prefer the REST API:

curl -X POST http://localhost:4200/agents \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-first-agent",
    "triggers": [{"lifecycle": {}}]
  }'

Then start it:

curl -X POST http://localhost:4200/agents/{id}/start

Equip a competency

Competencies define what an agent can do — its personality, tools, and operational parameters.

# List available competencies
hoziron competency list

# Install one from a directory
hoziron competency install ./my-competency/

# Activate it
hoziron competency activate claims-intake

Once activated, the agent takes on the competency's system prompt, skills, and configuration.

Check agent status

hoziron agent list
hoziron agent status <agent-id>

What just happened

When you created an agent, Hoziron:

  1. Registered the agent in the kernel
  2. Assigned it the platform's default model (from config.toml)
  3. Started the agent lifecycle (Created → Running)
  4. Made it available for messages via CLI and API

The agent maintains its own conversation history, memory scope, and lifecycle state.

Next steps

Now that you have a working agent, explore what's possible:

Related: