Getting Started

Agentum is a native macOS app. Your agents run inside it as a supervised background process — there are no containers, no runtimes to install, and no configuration files to edit. This page takes you from “I have a Mac” to a working agent hub in about ten minutes.

What you’ll need

  • A Mac with Apple Silicon (M1 or newer) running macOS 12 or later. Intel Macs are not supported.
  • A Google account — used to sign in and start your trial.
  • An internet connection.

That’s the whole list. Agentum ships with a free built-in AI provider, so you don’t need an API key to start — and everything else (Telegram, Google Workspace, a coding CLI) is optional and can be added later. If you want to preview the optional tools, see Companion Tools.

Step 1: Get your account

Visit theagentum.com and sign in with Google. That single step creates your account and issues a 30-day free trial — no credit card, no license key to copy. When you’re ready to keep Agentum, a one-time license ($999 Core, or $1,799 Guided Launch with a private onboarding session) carries the same account over — see Account & Billing.

Step 2: Download and install

Go to theagentum.com/download and grab the DMG (Agentum-<version>-arm64.dmg). Open it, drag Agentum into your Applications folder, and eject the disk image.

The app is signed and notarized. On first launch macOS may still show the standard “downloaded from the Internet” prompt — click Open. If Gatekeeper blocks it outright, right-click the app in Applications and choose Open from the menu.

Step 3: Sign in and meet the setup assistant

Agentum opens to a sign-in screen. Click Sign in with Google — your browser opens, you approve, and the app picks up your trial license automatically within a few seconds. (If the browser hand-back doesn’t fire, just leave Agentum open; it polls for the completed sign-in on its own.)

From there, setup is a conversation, not a form. A built-in assistant walks you through each step in chat, one card at a time, with a progress strip across the top: You → AI → Agents → Integrations → Chat → Chrome → Finish.

  1. You — your name and how the assistant should address you.
  2. AI — pick your LLM. The default, Agentum AI, is free and needs no key or signup. You can also bring your own Claude, Gemini, DeepSeek, or MiniMax key — see Choosing Your LLM & Coding Harness.
  3. Agents — pick a few starter agents to seed your install. Your agents folder defaults to ~/Documents/Agentum/agents — no need to choose one by hand.
  4. Integrations — optionally connect your Google account (Gmail, Calendar, Drive, Docs, Tasks) with one consent screen.
  5. Chat — optionally connect a Telegram bot so your agents can reach you on your phone. See Telegram Setup.
  6. Chrome — optionally pair the Agentum Bridge browser extension.
  7. Finish — confirm and land in Agentum Chat, the app’s home screen.

Only the sign-in is required. Every other step can be skipped and configured later from Settings — the assistant will say so, and nothing breaks if you skip ahead. The right-hand side of the onboarding screen is a free-form chat: ask it anything about Agentum while you set up.

If the setup assistant can’t be reached (offline, provider hiccup), Agentum falls back to a simple screen where you can retry or continue straight into the app. Onboarding never blocks you.

Step 4: Verify it’s working

Quick sanity check, all in the app:

  • The sidebar lists your installed agents.
  • Agentum Chat (the home screen) renders without an error banner — try typing /help in the composer.
  • The account chip shows Trial — N days left (or Lifetime if you’ve bought a license).

If any of those are off, see Troubleshooting. The universal fix for a wedged install is unglamorous but reliable: quit Agentum (⌘Q) and reopen it — the background agent restarts with the app.

Staying up to date

Agentum updates itself. It checks shortly after launch and every few hours after that; when an update is available you’ll see a banner — click Download, then Install & restart (about 30 seconds). You can check manually from System → Services → Software update. Marketplace agents update separately, from the Marketplace’s Updates tab.

Next steps