Skip to content
Minion Docs

Quick Start

Follow these steps to create a minion from the HQ dashboard and run your first skill.

1. Log in to HQ

Section titled “1. Log in to HQ”

Sign in to the HQ dashboard using Google OAuth.

2. Create a minion

Section titled “2. Create a minion”

Click “New Minion” from the dashboard. Once provisioning completes, the minion’s status will change to online.

3. Connect to your minion

Section titled “3. Connect to your minion”

From the minion detail page, you can connect using:

  • Web terminal — Operate the minion’s shell in your browser
  • VNC — View the minion’s desktop from your browser (useful for checking browser operations)

4. Create a skill

Section titled “4. Create a skill”

Skills are reusable task instruction templates for minions. Create one from the skill management page in HQ.

---
name: hello-world
display_name: Hello World
description: My first skill
---


Please output "Hello, Minion!"

5. Run a workflow

Section titled “5. Run a workflow”

Open the HQ visual workflow editor and drop a Skill node referencing the skill you just created onto the canvas, wiring it between the Start and End nodes. Run the graph on demand, or attach a cron schedule to run it automatically. For tasks a single minion can handle autonomously, a Routine is a lighter-weight alternative.

Next steps

Section titled “Next steps”