Installing Agents

Agents are the heart of Selu. Each agent is a self-contained AI assistant that can handle specific tasks — from answering questions to managing your calendar to monitoring your smart home. You install them from the Selu marketplace.

Browsing the marketplace

Open the Selu dashboard and click Marketplace in the sidebar. You’ll see a catalog of available agents organized by category.

Each listing includes:

• Description — What the agent does and what it’s good at.
• Capabilities — The tools and permissions the agent needs to function.
• Reviews — Ratings and feedback from other Selu users.
• Version history — A changelog so you know what’s changed.

Installing an agent

1. Find an agent you’d like to try and click Install.
2. Review the capabilities the agent is requesting. These are the tools and resources it needs — things like web access, file reading, or API calls.
3. Approve the capabilities you’re comfortable with. You can always change these later under Tool Policies.
4. Click Confirm to begin installation.

Selu pulls the agent’s Docker image and starts it in its own container. This usually takes under a minute, depending on the agent’s size and your internet speed.

What happens during installation

Image pull

The agent’s Docker image is downloaded from the registry. Each agent is isolated in its own container.

gRPC registration

The agent registers with Selu over gRPC, announcing its capabilities and the tools it provides.

Configuration

Default settings are applied. You can customize the agent’s behavior from its settings page after installation.

Health check

Selu verifies the agent is running and responsive before marking it as ready.

Managing installed agents

Go to Settings → Agents to see everything you’ve installed. From here you can:

• Start / Stop an agent without uninstalling it.
• Update to a newer version when one is available.
• Configure agent-specific settings like model preference or personality.
• Uninstall to remove the agent and its container entirely.

Assigning agents to channels

After installation, assign the agent to one or more channels so it can receive messages. Go to Settings → Channels, select a channel, and pick the agent from the dropdown.

You can also set up routing rules in Agent Sessions if you want multiple agents sharing the same channel.