3 / 13My First AI AgentPart I · 10 min read

Let’s get ready

Pick where you’ll run Hermes (your laptop is fine). Sign up for one free AI account — we’ll link the exact page. Copy the long string the site calls an “API key.” Treat it like a password.

Host paths (same Desktop cockpit)
Advanced tabs exist — don’t configure them for Part I proofs
Day one
Your PC
Awake for gateway
Desktop app
Course cockpit
Local terminal
Default tools
Providers
Free cloud route + API key
When relevant (Settings)
Advanced · Docker
Isolate shell tools
Local models
Open weights on your GPU
Gateway host
Always-on / VPS later

Your machine

This course assumes you install Hermes on a machine that exists for the agent — a spare PC, mini-PC, old laptop wiped for this purpose, or similar. Not the computer that holds banking, work SSO, password vaults, and family photos.

Why: once tools are on, the agent can act like a capable operator with a shell on that OS. Treat the host as something you can wipe and rebuild without wrecking daily life.

  • Windows, macOS, or Linux Desktop as offered for your build
  • Hermes home is a folder on that host — everything the agent keeps is plain files
  • Next lesson (03) installs Desktop on this box
Spare machine already ready? You have the baseline. If you want a different shape later — local weights, Docker, a VPS that stays awake, or a privacy-oriented provider — open Curated alternatives at the bottom of this page. Otherwise go straight to install.
Exercise · Check yourself

Default host for this course?

Pick one — the answer is revealed straight away.

Exercise · Check yourself

Using free cloud models means…

Pick one — the answer is revealed straight away.

Where the brain runs (day one)

Hermes on your dedicated box is the cockpit, but the brain runs elsewhere on day one. Pick one free route — OpenRouter or OpenCode — and create the account now, so install in lesson 03 is copy-paste instead of a detour.

Steps · tap the number to check0/3
  1. Create a free account on either OpenRouter or OpenCode. One is enough — you can add the other later.
  2. Generate an API key in that account. OpenRouter hands you one during signup; on OpenCode, open API Keys and create one (screenshot below).
  3. Copy it somewhere you can paste from in lesson 03 — a password manager, not a sticky note or a chat window.
OpenCode → API KeysCreate API Key. Name it something you will recognise later (“Hermes Agent”), then copy the key once — it is shown in full only at creation.
That key is a credential: anyone holding it can spend on your account. Never paste it into a chat with the agent, a public repo, or a screenshot.
  • Your prompts, replies, and often tool context leave the host on these routes. Useful for learning — not private.
  • Do not paste secrets, customer data, or keys into cloud chats “just to try”

You are ready for install when

Checklist · this device0/5

Next: lesson 03 — install Hermes on that host and get one chat reply.

Other ways to deploy

Curated alternatives

Day one is Hermes Desktop on a spare machine with a free cloud model, and that is enough to finish the course. Everything below is for when you want a different shape — and each one needs setup work this course does not walk through.

If you want…We point you toExtra steps this course does not cover
The agent running locallyOpen weights via Hugging Face, run on a GPU box you ownGPU sizing, downloading weights, running an inference server
Docker on a personal PCOfficial Hermes Docker / terminal backends — never a bare host shellContainer setup, volume mapping, which mounted folders to back up
A VPS, alive 24/7Infomaniak (Swiss jurisdiction) for the host, Nous Portal for modelsRenting and hardening a server, SSH keys, firewall, jurisdiction choice
Anonymity or privacyVenice.ai as a provider, or local weights if you can run themProvider policy, payment and identity hygiene, what still leaks
These are preferences, not contracts, and we deliberately do not turn them into full tutorials — each depends on your hardware, budget, and threat model. The links below are the right starting points. If you would rather have it set up properly for your situation, ask us — that is the kind of thing we do.
No spare box yet? Pause install, rent a small VPS (or wipe an old machine), then continue. Do not “just try it” bare on the daily laptop.
Checklist · this device0/1
Checklist · this device0/1

You are done when

Proof · this device0/1

Stored on this device only — not sent anywhere.