FAQ
Frequently asked questions about Hybrix. Can't find your answer here? Check the troubleshooting guide or open a discussion on GitHub.
General
What is Hybrix?
Hybrix is an open-source multi-agent framework that lets you create, manage, and deploy AI agents. Each agent has its own LLM backend, skills, personality, and a procedurally generated pixel-art mascot. Agents connect to platforms like Discord, Slack, and Telegram through a unified gateway.
Is Hybrix free?
Hybrix itself is free and open source under the MIT license. You will need API keys from LLM providers (Anthropic, OpenAI, etc.), which have their own pricing. You can also use free local models via Ollama.
Can I use multiple LLM providers at the same time?
Yes. Each agent independently configures its own provider and model. You can have one agent running Claude, another using GPT-4o, and a third using a local Llama model, all in the same gateway.
Agents
How many agents can I run simultaneously?
There is no hard limit on agent count. The practical limit depends on your LLM API rate limits and the maxConcurrent setting in the gateway config. Most setups work well with 3-10 agents.
Can agents talk to each other?
Yes, in Live Room mode. Multiple agents can join the same room and collaborate on tasks. They see each other's messages and can respond to each other. This is useful for multi-agent workflows like code review chains or research teams.
Can I change an agent's mascot after creation?
Yes. Use the mascot editor in the dashboard or run hybrix agent mascot <name> from the CLI. You can pick new base animals or choose from preset hybrids.
Skills & Channels
Are shell commands safe to enable?
Shell execution is powerful and should be configured carefully. Always define an explicit allowlist of permitted commands and never run the gateway as root. See the Security guide for best practices.
Can I connect multiple Discord servers?
Yes. Leave the allowlist empty to respond in all guilds the bot is invited to, or list specific guild IDs to restrict access.
Do I need the mobile app for device skills?
Yes. Device skills (camera, location, contacts, SMS) require the Hybrix companion app installed on a paired mobile device. The app bridges your phone's hardware to the gateway via a secure WebSocket connection.