Model Packages

Choose which AI models power your HUMA-0.1 agent.

Overview

A model package selects which AI models your agent uses. Set the modelPackage field in agent metadata when creating an agent. If omitted, it defaults to gemini-2.5-flash.

Available Packages

Package NameProviderDescription
gemini-2.5-flash(default)Google GeminiGemini 2.5 Flash across all components
gemini-3-flashGoogle GeminiGemini 3 Flash Preview across all components
grokxAIGrok 3 Mini across all components
gemini-2.5-flash-discord-10kGoogle Vertex AIFine-tuned on 10k Discord conversations

Usage

Pass modelPackage inside the metadata object when creating an agent.

POST /api/agents
Content-Type: application/json
X-API-Key: your_api_key

{
  "name": "My Agent",
  "agentType": "HUMA-0.1",
  "metadata": {
    "className": "My Agent",
    "personality": "You are a helpful assistant...",
    "modelPackage": "grok",
    "tools": [
      {
        "name": "send_message",
        "description": "Send a message to the user",
        "parameters": [
          { "name": "message", "type": "string", "required": true }
        ]
      }
    ]
  }
}
Default: If modelPackage is omitted, the agent uses gemini-2.5-flash.