Gamut

Getting Started

Quickstart

Create your first Gamut agent and send it a task. Setup takes about two minutes.

1. Open Gamut

Launch the desktop app, or open your Gamut server in a browser (default: http://localhost:47891).

2. Complete setup

On first launch, a short wizard walks you through:

  • LLM provider: Add your Anthropic API key, or configure another provider. If ANTHROPIC_API_KEY is set in your environment, Gamut detects it automatically.
  • Default model: Pick the model new sessions start with.
  • Runtime: Gamut checks for a container runtime (Docker, Podman, or a platform-native option) and pulls the agent image. The first pull takes a minute or two. See Runtime Setup for all supported runtimes.

Any of this can be changed later in Settings.

3. Create an agent

The wizard ends by asking what you want your agent to do. Describe its job in a sentence:

Summarize my unread emails every morning

Press Cmd+Enter (Ctrl+Enter on Windows/Linux) or click Create Agent. Gamut names the agent, creates it, and starts your first session. Agents can also be created from templates or imported from a skillset.

4. Send your first message

Gamut spins up a container for the agent and sends your message. The agent reads it, plans, and works with its tools: running commands, editing files, browsing the web, or calling connected services. Each tool call appears inline so you can follow along.

Send follow-ups at any time. If the agent is still working, your message is queued and picked up when it's ready.

5. Switch models

New agents default to Claude Opus. To change models, use the model selector in the message composer. The selection sticks for the rest of the session. See LLM Providers for the full catalog.

6. Explore the agent home

Click the agent's name in the sidebar to open its home page:

  • New session: Type a prompt to start a fresh conversation.
  • Past sessions: Every previous session, with timestamps and summaries.
  • Dashboards: Any dashboards the agent has built.
  • Scheduled tasks: Recurring or upcoming work the agent has set up.
  • Connections: The accounts and MCP servers this agent can use.

7. Configure the agent

Click Settings on the agent home page:

  • General: Rename, export, or delete the agent.
  • Secrets: Environment variables (API keys, tokens) injected into the agent's container.
  • Agents: Which other agents this one is allowed to invoke.

Next steps