# hermes setup Command

> The Hermes wizard that sets up the model, tools and chat apps, step by step.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** hermes setup --portal, Hermes setup wizard

## Think of it like

It is like a tour on your first day that shows you where things are.

## Definition

hermes setup is the Hermes command that walks you through setting up the agent, step by step. The first time, it runs the full wizard: the model, the terminal, the chat apps and the tools. Later, you can jump to one part, such as hermes setup model. With --portal, one login to Nous Portal sets up a model and the Tool Gateway in one go.

## Example

Sara has just installed Hermes. She runs hermes setup --portal, logs in once, and can chat right away.

## Example code

```console
hermes setup --portal
```

Log in to Nous Portal and set up a model and tools at once.

## Why it matters

An agent has many parts to wire up, and the wizard does it in the right order.

## Common mistake

Editing config.yaml by hand before you run setup. The wizard writes a good file for you.

## Three principles

- **Full wizard first.** Then one part at a time.
- **--portal is fastest.** One login.
- **Shows current values.** Enter keeps them.

## Related terms

- [hermes Command](https://learn.benibix.com/term/ai/hermes-command)
- [Nous Portal](https://learn.benibix.com/term/ai/nous-portal)
- [Hermes config.yaml](https://learn.benibix.com/term/ai/hermes-config-yaml)

---

Source: https://learn.benibix.com/term/ai/hermes-setup-command
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
