Install Hermes Agent and get your bot replying

Also in: 中文Bahasa Melayu

Which computer will run your agent?

Your agent lives on your laptop

10 stages, about 1 hour. You finish with a bot that replies to you.

Join a free AI agent class

Learn what an AI agent can do for your business.

Get ChatGPT Plus

Use your own Plus account for the workshop.

You’ll needYour ChatGPT account
  1. Open ChatGPT and log in.

    Use the same account as your paid phone subscription. A different email will not show Plus.

    Open ChatGPT ↗
  2. Click your account name, then Upgrade plan.

    On desktop, look at the bottom-left. Some screens say Upgrade to Plus.

  3. Choose Plus and read the price before paying.

    Already on Plus? Skip payment. Your own checkout price is the one that applies.

    The Plus plan and its displayed monthly price. Prices change; check your own screen.Your screen may look a little different.Tap the image to enlarge
  4. Complete payment only on ChatGPT’s checkout screen.

    Card rejected? Enable online or overseas transactions in your banking app. Still rejected? Ask Sean.

  5. Check that your account now shows Plus.

    You cancel it yourself in Settings → Account. The workshop fee does not include this subscription.

  6. Open Settings → Security and login.

    Look under Advanced security. Your settings labels may differ slightly.

  7. Turn on Enable device code authorization for Codex.

    This lets Hermes connect later. Never share its login code with anyone.

    The device-code authorization switch in ChatGPT security settings.Your screen may look a little different.Tap the image to enlarge

Can you see this?

Does your account show Plus, with device code authorization turned on?

Install Telegram

Link your phone and laptop to the same Telegram account.

You’ll needYour phoneYour laptop
  1. Install Telegram from your phone’s App Store or Play Store.

    Search Telegram Messenger. Check the maker: Telegram FZ-LLC. Already using Telegram? Continue to the laptop part.

    Open Telegram downloads ↗
    Telegram Messenger in the app store, with Telegram FZ-LLC shown as the maker.Your screen may look a little different.Tap the image to enlarge
  2. Sign in to Telegram on your phone.

    Enter login codes only in the official login screen. Never send them to a person.

  3. If Telegram asks, choose your personal username.

    This @name belongs to you. It is different from the bot username you will create later.

  4. Install Telegram Desktop on your laptop.

    Open it. The login screen shows a QR code.

    Open Telegram downloads ↗
    The Telegram Desktop page with its computer download button.Your screen may look a little different.Tap the image to enlarge
  5. On iPhone, open Telegram Settings → Devices.

    Choose Link Desktop Device or Add Device, whichever your version shows.

  6. On Android, open Telegram’s menu → Settings → Devices.

    Choose Link Desktop Device or Add Device, whichever your version shows.

  7. Tap Add Device or Link Desktop Device on your phone.

    Your camera opens to scan the laptop’s QR code. If Devices is absent, check Privacy and Security.

  8. Scan the laptop’s QR code with your phone.

    Your chats appear on the laptop. QR expired? Close and reopen the laptop app for a fresh code.

    Telegram Desktop’s sign-in QR code and phone-linking instructions.Your screen may look a little different.Tap the image to enlarge

Can you see this?

Can you see your same chats on the phone and laptop?

Create your agent bot

BotFather creates your own bot and its token, the secret key.

You’ll needTelegram
  1. Open Telegram’s search and find @BotFather.

    Check the exact name and blue verified tick. Fake accounts may ask for money; close those chats.

    Open BotFather ↗
    BotFather’s settings show group-related controls.Your screen may look a little different.Tap the image to enlarge
  2. Tap START.

    BotFather can now reply to you.

  3. Send /newbot.

    BotFather asks for the name first, then the username.

    /newbot
    BotFather asks for a display name, then a username ending in bot.Your screen may look a little different.Tap the image to enlarge
  4. Send your agent’s name using Copy above.

    This is the display name. You can change it later with /setname.

  5. Send the username using Copy above.

    Write it down first; it cannot change. Taken? Add a number before _bot, then try again.

  6. Find BotFather’s confirmation message.

    It contains your bot link and token: a private key. Never forward it to another person or group.

    BotFather’s confirmation contains the bot link and a covered token.Your screen may look a little different.Tap the image to enlarge
  7. On iPhone, long-press the message → Forward → Saved Messages.

    Choose your own Saved Messages. Keep it private.

  8. On Android, long-press the message → Forward → Saved Messages.

    Choose your own Saved Messages. Keep it private.

  9. On Telegram Desktop, right-click the message → Forward → Saved Messages.

    Use this route if you are already on the laptop.

  10. Keep your confirmation in Saved Messages.

    Find it again through /mybots in BotFather. If the token leaked, use /revoke and open Help.

    /mybots

Can you see this?

Are your bot username and token saved in your own Saved Messages?

Find your Telegram user ID

This number tells Hermes who may talk to your bot.

You’ll needTelegram Saved Messages
  1. Open @userinfobot.

    Check the exact username. It should not ask for payment or login codes.

    @userinfobot
    Open userinfobot ↗
    The userinfobot profile and reply show the Id field.Your screen may look a little different.Tap the image to enlarge
  2. Tap START.

    It replies with your account information. Find the line labelled Id.

  3. Save the Id digits in your own Saved Messages.

    Copy every digit. The length can vary; do not add your name or @username.

  4. Open Saved Messages on the laptop.

    Check your bot username, token and user ID are all there. Keep this one place open.

Can you see this?

Can you see three things on the laptop: bot username, token and your user ID?

Install Hermes on your laptop

Install from the official Hermes website.

You’ll needLaptop with chargerSaved Messages
  1. Open the official Hermes download page.

    Keep Wi-Fi on and your laptop plugged in. Use only this official address.

    Open Hermes downloads ↗
  2. Under Mac OS, click Download desktop app.

    Your browser downloads Hermes-Setup.dmg.

    The official Mac OS and Windows download cards. The outlined button matches your computer.Your screen may look a little different.Tap the image to enlarge
  3. Open Finder → Downloads, then double-click Hermes-Setup.dmg.

    Two quick clicks open a window containing Hermes and an Applications shortcut.

  4. Drag Hermes into Applications.

    Wait for copying to finish. This DMG contains Hermes.app, not an Install Hermes app.

  5. Open Hermes from Applications.

    This opens Hermes Setup. Choose Open if macOS asks about this official download. Then follow its installation screen.

  6. If the installer lists jobs, let them finish.

    Build desktop app can pause for several minutes. One student waited eight minutes at 57%; it finished.

    The older installer lists automatic jobs, including Build desktop app.Your screen may look a little different.Tap the image to enlarge
  7. When HERMES IS READY appears, click Launch Hermes.

    Some installers open Hermes directly. Continue when the welcome or provider screen appears.

    The older installer shows HERMES IS READY and Launch Hermes.Your screen may look a little different.Tap the image to enlarge
  8. Under Windows, click Download desktop app.

    You may see Windows protected your PC after opening the file. The next steps explain it.

    The official Mac OS and Windows download cards. The outlined button matches your computer.Your screen may look a little different.Tap the image to enlarge
  9. Open File Explorer → Downloads.

    File Explorer is the yellow folder icon. Look for Hermes-Setup.exe.

    File Explorer’s Downloads folder contains Hermes-Setup.exe.Your screen may look a little different.Tap the image to enlarge
  10. Double-click Hermes-Setup.exe.

    Double-click means two quick left clicks. A company laptop needs IT permission before installing.

    The blue Windows protected your PC box has a More info link.Your screen may look a little different.Tap the image to enlarge
  11. If Windows protected your PC appears, click More info.

    Check that this is your Hermes download from the official page. The next screen adds Run anyway.

    The expanded protection box shows the Run anyway button.Your screen may look a little different.Tap the image to enlarge
  12. Click Run anyway for that official Hermes file.

    Do not use this route for other downloads. If antivirus quarantines Hermes, open Help.

  13. In User Account Control, click Yes for the Hermes installer.

    Windows asks permission to install this app. Confirm the app is your official Hermes download.

    User Account Control asks permission, with Yes and No buttons.Your screen may look a little different.Tap the image to enlarge
  14. Follow the installer and keep its default choices.

    Click Next when offered. Leave the installer open while its progress moves.

    The Windows installer shows its progress bar.Your screen may look a little different.Tap the image to enlarge
  15. If the installer lists jobs, let them finish.

    Build desktop app can pause for several minutes. One student waited eight minutes at 57%; it finished.

    The older installer lists automatic jobs, including Build desktop app.Your screen may look a little different.Tap the image to enlarge
  16. When HERMES IS READY appears, click Launch Hermes.

    Some installers open Hermes directly. Continue when the welcome or provider screen appears.

    The older installer shows HERMES IS READY and Launch Hermes.Your screen may look a little different.Tap the image to enlarge

Can you see this?

Is Hermes open and ready for you to choose a provider?

Connect ChatGPT and choose Luna

Luna is the model we use for setup. Leave it selected tonight.

You’ll needYour Plus account
  1. In Hermes, open the model-provider choices.

    A provider supplies the model, your agent’s brain. Hermes is installed but needs this connection.

    Hermes’ welcome screen asks which model provider to connect.Your screen may look a little different.Tap the image to enlarge
  2. Choose ChatGPT or Codex Subscription.

    If absent, open Other providers. Look for the same subscription option.

    The provider list includes ChatGPT or Codex Subscription.Your screen may look a little different.Tap the image to enlarge
  3. Wait when Hermes shows Starting sign-in.

    Hermes is preparing your code, not frozen. Keep its window open.

    Hermes shows Starting sign-in while it prepares the browser code.Your screen may look a little different.Tap the image to enlarge
  4. Open the official device sign-in page.

    Copy the short code from Hermes into that page. Never send the code into a chat.

    Open device sign-in ↗
  5. Choose the account with your Plus subscription.

    Check the email before continuing. A wrong account will connect the wrong subscription.

  6. Click Continue on the Codex access screen.

    Only continue on the official OpenAI sign-in page you opened.

  7. When you see Signed in to Codex, return to Hermes.

    You can close that browser tab. If the code expired, choose sign-in again for a fresh code.

    The browser confirms Signed in to Codex and says this page can close.Your screen may look a little different.Tap the image to enlarge
  8. Wait for the subscription-connected confirmation.

    Hermes confirms your ChatGPT or Codex subscription is connected.

    The Telegram connection row shows Connected.Your screen may look a little different.Tap the image to enlarge
  9. Open Switch model and choose GPT-5.6 Luna.

    Check that the model name contains Luna. Tonight, leave it there; the workshop covers smarter models.

    The Switch model list shows GPT-5.6 Luna.Your screen may look a little different.Tap the image to enlarge
  10. Click BEGIN when it appears.

    Your Hermes workspace opens. Some versions open it directly.

    The connected setup screen has a BEGIN button.Your screen may look a little different.Tap the image to enlarge
  11. Look for Gateway ready in the bottom-left corner.

    This means the gateway, your message receiver, is running. If it differs, open Help.

    Gateway ready appears in the workspace’s bottom-left corner.Your screen may look a little different.Tap the image to enlarge

Can you see this?

Does Hermes show your connected account and a model name containing Luna?

Connect Telegram

Your bot token connects the bot. Your user ID controls who can use it.

You’ll needSaved Messages on laptop
  1. Open Hermes’ Telegram messaging settings.

    Look for Messaging or Telegram under Settings. The gateway is the connection to Telegram.

    Hermes’ Telegram settings show the token and allowed-ID fields.Your screen may look a little different.Tap the image to enlarge
  2. Copy your bot token from Saved Messages into the bot-token field.

    Use the token for this bot. Keep it out of chats and screenshots.

  3. Put your user ID digits into Allowed user IDs.

    This is your personal Id number from Stage 4, not the bot’s username.

  4. Save the Telegram settings.

    Use Save if shown. A Restart now banner may appear after credentials change.

    The saved-settings message offers Restart now.Your screen may look a little different.Tap the image to enlarge
  5. Click Restart now when Hermes offers it.

    This restarts the gateway, not your laptop. If no gateway runs, use the recovery in Stage 9.

    The Telegram connection row shows Connected.Your screen may look a little different.Tap the image to enlarge

Can you see this?

Are Telegram settings saved, with the gateway running?

Get your first reply

Use your bot’s private chat on your phone.

You’ll needYour bot username
  1. Open the bot username saved in Saved Messages.

    Check the exact @username. Tap START if shown.

  2. Tap START in your own bot chat.

    Your bot cannot message you before you start the chat.

  3. Send /new.

    Wait for New session started. Read approval actions before choosing Always tonight.

    /new
    The bot chat confirms New session started after /new.Your screen may look a little different.Tap the image to enlarge
  4. Send /sethome.

    This sets this chat as your home for scheduled messages. It does not guarantee every reply.

    /sethome
  5. Send the message hi.

    Wait up to two minutes. Your bot should answer. Type for now; voice comes later.

    hi
  6. On Windows, send this house rule to your bot.

    Wait for it to confirm. You will handle restarts yourself.

    House rule for this Windows laptop: never restart your own gateway or Hermes. If a restart is needed, stop and tell me 'Please restart my gateway', and I will do it.
  7. Wait up to a minute for the first reply.

    Typing or thinking messages mean your agent is working. Still silent? Open Help.

Read the action first. Tonight, choose Always for actions you understand.

Allow OnceThis action only
SessionMatching commands in this conversation
AlwaysAlways means your agent won’t ask again for this kind of action.
DenyDoes not run the action

Money, deleting or messaging other people? Choose Deny and ask in the workshop.

Can you see this?

Did your own bot reply to hi?

Keep it replying tonight

The laptop must stay awake, online and plugged in.

You’ll needChargerWi-FiPhone
  1. Keep the lid open and the charger connected.

    Keep Wi-Fi on. Opening Telegram Web cannot wake a sleeping laptop.

  2. On Mac, open System Settings → Battery → Options.

    Turn on Prevent automatic sleeping on power adapter when the display is off.

  3. On Mac, open System Settings → Lock Screen.

    Set Turn display off on power adapter when inactive to one minute for this test.

  4. On Windows, open Settings → System → Power & battery.

    Open Screen, sleep & hibernate timeouts. Older versions call it Screen and sleep.

  5. For plugged in, set Make my device sleep after to Never.

    Set Turn my screen off after to one minute for this test. Leave battery settings as they are.

  6. Leave the laptop untouched until the display turns off.

    Do not select Sleep or close the lid. Keep Hermes and its gateway running.

  7. Wait two minutes after the display turns off.

    Use your phone now. Leave the laptop untouched.

  8. Send hi from your phone.

    A reply proves the agent stayed awake. If silent, tap My bot stopped replying below.

    hi

Can you see this?

Did the bot reply from your phone after the laptop display stayed off for two minutes?

Your agent is alive 🎉

Keep your first reply. You’re ready to bring it to the workshop.

Save your first reply

Screenshot it. Cover tokens and personal details.

Keep tonight’s settings

Leave the model and skills unchanged until class.

Bring your bot to the group

Your trainer will tell you when to open the group guide.

Join a free AI agent class

Learn what an AI agent can do for your business.

All stages