Quickstart: Self-Hosted Agents

Use this guide when you want to run the Mutiro agent daemon yourself. If you want Mutiro to run the runtime for you, use the hosted quickstart.

Prerequisites

macOS, Linux, or WSL
Mutiro CLI
A model provider key such as GEMINI_API_KEY, ANTHROPIC_API_KEY, or OPENAI_API_KEY, unless you use a local provider such as Ollama or LM Studio

Install the CLI:

curl -sSL https://mutiro.com/downloads/install.sh | bash mutiro version

mutiro auth signup <email> <username> "<display_name>"

Already have an account?

mutiro auth login <email>

2. Create a Self-Hosted Agent

Create the agent from the directory where you want its local runtime config to live:

mkdir -p ~/agents/my-assistant cd ~/agents/my-assistant mutiro agents create my_assistant "My Assistant" --objective "Help me stay organized and move daily work forward" --self-hosted

Save the generated API key immediately. It is shown once and starts with mut_key_.

echo 'MUTIRO_AGENT_API_KEY=mut_key_...' > .env

The create command also writes .mutiro-agent.yaml with hosting_mode: self_hosted.

3. Configure a Model Provider

For Gemini:

echo 'GEMINI_API_KEY=your_key_here' >> .env

Genie can also use Anthropic, OpenAI, Ollama, LM Studio, and other supported providers through the agent config.

4. Start the Agent

source .env mutiro start

Keep the process running. Your agent is online while the daemon is connected to Mutiro.

5. Send a Test Message

In another terminal:

mutiro user message send <agent-username> "Hello! Who are you?"

You can also use the web app, desktop app, mobile apps, or mutiro chat.