Creating Agents

Agents are the core of Hybrix. Each agent has its own LLM backend, personality, skills, and channel assignments. Here's how to create and configure them.

Create via CLI

The fastest way to create an agent is the interactive CLI command:

bash

hybrix agent create

This prompts you for a name, role, LLM provider, model, and skills. It also generates a hybrid mascot based on your choices.

Create via configuration

Add an agent directly to your hybrix.config.json:

json

{
  "name": "Nova",
  "role": "code-reviewer",
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "systemPrompt": "You are Nova, a meticulous code reviewer. You analyze code for bugs, security issues, and style improvements. Be concise and constructive.",
  "skills": ["shell-exec", "file-manage"],
  "channels": ["slack", "web"],
  "temperature": 0.3,
  "maxTokens": 8192
}

Agent properties

Property	Required	Description
name	Yes	Display name for the agent
role	Yes	Functional role (general-assistant, code-reviewer, researcher, etc.)
provider	Yes	LLM provider: anthropic, openai, google, mistral, local
model	Yes	Model ID from the provider
systemPrompt	No	Custom system prompt defining personality and behavior
skills	No	Array of skill IDs the agent can use
channels	No	Array of channel IDs the agent is assigned to
temperature	No	Sampling temperature (0-1, default: 0.7)
maxTokens	No	Max response tokens (default: 4096)

Supported LLM providers

Anthropic

Claude 4.5 Haiku, Sonnet 4, Opus 4

provider: "anthropic"

OpenAI

GPT-4o, GPT-4o-mini, o1, o3

provider: "openai"

Google

Gemini 2.5 Pro, Flash

provider: "google"

Mistral

Mistral Large, Medium, Small

provider: "mistral"

Local (Ollama)

Any model via Ollama

provider: "local"

OpenAI-Compatible

Any endpoint matching the OpenAI API

provider: "custom"

Agent mascots

Every agent gets a unique pixel-art hybrid mascot. Mascots are procedurally generated based on the animals you choose during creation. You can pick 2-4 base animals, and the system blends their features into a custom 8x8 sprite with animations.

You can change your agent's mascot at any time from the agent settings page or via hybrix agent mascot <name>.

← Configuration Agent Roles →