Back to the Field Manual
Ready to try one

Install a profile with control

Use the documented terminal command, review the installation prompt, and begin with a small test.

7 min readUpdated 2026-08-25Official sources linked

Before the command

  • Update Hermes and note the version you are running.
  • Open the source repository and compare its current version with the version linked by the Registry.
  • Read every required account or credential name and decide whether the job truly needs it.
  • Start with sample material or a copy. Keep client data, private messages, and irreplaceable files out of the first test.

What the install command does

Hermes uses a Git repository as the source for an installable profile package. Open a terminal and replace the example owner and repository below with the exact source shown on a listing.

hermes profile install github.com/OWNER/REPOSITORY --alias

Add your own credentials on your computer

A profile package can list the variable names it needs for account access. Hermes creates .env.EXAMPLE with those names. You add your own values locally. Keep credential values out of public repositories and Registry submissions.

Review every included scheduled task before enabling it. Pay special attention to work that sends messages, publishes content, deletes material, makes purchases, or changes an outside system.

Run one test you can inspect

  • Ask the Bot to restate its job and the actions that require a person’s approval.
  • Give it a tiny representative task.
  • Watch which tools it requests and which files it reads or writes.
  • Confirm it stops where the listing says a human must approve.
  • Keep the profile only if the result matches the documented behavior and your expectations.