Getting Started

Agentum runs on your Mac. This page takes you from “I have an account” to a working dashboard. About 30 minutes, most of it waiting for the first container pull.

What you’ll need

  • A Mac with Apple Silicon (M1 or newer) running macOS 12 or later
  • About 30 minutes
  • An internet connection (the first launch downloads container images)
  • A Google account (used to sign in)

Step 1: Get your account

Visit theagentum.com and sign in with Google. A 14-day trial license is issued automatically the first time you sign in. No credit card.

When you’re ready to keep it, lifetime access is $999, one time. See pricing or upgrade in-app — same license key carries over, no reinstall.

Step 2: Download Agentum

Go to theagentum.com/download and grab the DMG. Open it, then drag Agentum.app into your Applications folder. Eject the DMG.

The app is signed and notarized, so the first time you launch it macOS shows the standard “Agentum is an app downloaded from the Internet. Are you sure you want to open it?” prompt. Click Open. Subsequent launches don’t ask.

Step 3: First launch

Agentum opens to a seven-step wizard. It tracks your progress in persistent settings, so if you quit halfway through it picks up where you left off.

1. Activate license

If your browser is already signed in to theagentum.com, the wizard pulls your license key over OAuth in the system browser and you’re done. If not, sign in when prompted. The key is stored locally at ~/Library/Application Support/YuriClaw/.

If you bought a lifetime key on another machine, click I have a license key and paste it.

2. Runtime check

Agentum needs a container runtime (Podman) to run your agents. The wizard checks for it. If it’s missing, it offers to install the bundled .pkg — click through the installer, then come back to the wizard. Takes about a minute.

3. Plugins folder

Pick the folder on your Mac where your agents will live. The default is ~/Documents/YuristicPlugs. You can change it later, but most people keep the default.

4. Pick your plugins

Agentum ships with a catalog of optional plugins (Scheduling, Reminders, Weather, News, Polymarket, Nanny Tracker, MyVault, …). Tick the ones you want; every box defaults to off. Picking zero is fine — you can install plugins later from the catalog in the sidebar.

Each plugin you install is auto-granted the integrations it declares it needs (Telegram, AI, calendar, etc.). You can revoke specific grants later from the plugin’s Permissions tab.

This step replaces the old “install all the examples” toggle; the system is now opt-in for every plugin.

5. Configure environment

This is the in-app .env editor. Fill in the credentials your installed plugins need:

  • Telegram bot token — for the Telegram interface (get one from @BotFather)
  • LLM API keys — Claude, Gemini, or whichever provider you’re using
  • Anything else specific to plugins you installed in the previous step

Save when you’re done. You can re-open this editor any time from the dashboard.

6. Optional bridges

If you picked plugins that benefit from the Chrome bridge (consumer Gemini web search, Deep Research), the wizard offers to install Chrome Beta + the bridge LaunchAgent here. Skip if you’re not using those features.

7. Start services

Agentum runs compose up and waits for the containers to report healthy. First time, the runtime pulls the images — figure on a minute or two depending on your connection. After that, ~30 seconds.

You land on the dashboard.

Step 4: Verify it’s working

Quick sanity check:

  • The sidebar lists your enabled plugins
  • The dashboard renders without an error banner
  • The sidebar footer shows either Trial — N days left (during your trial) or Lifetime (after upgrade)

If any of those are off, jump to Troubleshooting.

Next steps