diff --git a/website/docs/guides/run-nemotron-3-ultra-free.md b/website/docs/guides/run-nemotron-3-ultra-free.md new file mode 100644 index 00000000000..9f8934f4661 --- /dev/null +++ b/website/docs/guides/run-nemotron-3-ultra-free.md @@ -0,0 +1,115 @@ +--- +sidebar_position: 0 +title: "Run Nemotron 3 Ultra free in Hermes Agent" +description: "Try NVIDIA Nemotron 3 Ultra on Nous Portal — free June 4–18 — with day 0 support in Hermes Agent" +--- + +# Run Nemotron 3 Ultra free in Hermes Agent + +Nous Research has been inducted into the **Nemotron Coalition** of leading AI labs working with **NVIDIA** to advance open frontier foundation models. In honor of this, we've partnered with **Nebius** to provide **Nemotron 3 Ultra** free on [Nous Portal](https://portal.nousresearch.com) for two weeks (**June 4th – June 18th**). Follow the instructions below to try the model in your Hermes Agent today. + +:::info Limited-time offer +The `nvidia/nemotron-3-ultra:free` tier is available from **June 4th to June 18th**. The `:free` tag is what keeps it on the no-cost plan — pick that exact variant. +::: + +Pick whichever install fits you. The **desktop app** is the easiest — no terminal required. If you live in a terminal, the **command-line** install is right below it. + +## Option A — Desktop app (recommended) + +The simplest path: a one-click installer with a guided, point-and-click setup. No terminal needed. + +### 1. Download and install + +[Download the Hermes Desktop installer](https://hermes-agent.nousresearch.com/desktop) for macOS or Windows, then open it. On first launch it finishes setting itself up (usually under a minute). + +### 2. Connect Nous Portal + +When the app opens, you'll see a "Let's get you set up" screen. Click **Nous Portal** (marked **Recommended**). Your browser opens — create a [Nous Portal](https://portal.nousresearch.com) account (or sign in), choose the **Free** plan, and authorize Hermes. The app connects automatically. + +### 3. Pick the free Nemotron 3 Ultra model + +After connecting, the app shows a **Default model** card. Click **Change**, search for **nemotron 3 ultra**, and select the variant tagged **Free tier**: + +``` +nvidia/nemotron-3-ultra:free +``` + +The `:free` tag is what keeps it on the no-cost tier — pick that variant. + +### 4. Start chatting + +Click **Start chatting**. That's it — you're talking to Nemotron 3 Ultra, free. + +## Option B — Command line + +Prefer the terminal? You'll need macOS, Linux, or Windows via [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) with `curl` installed (`curl` is preinstalled on most systems). + +### 1. Install Hermes Agent + +```bash +curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash +``` + +Prefer to review first? Download [`install.sh`](https://hermes-agent.nousresearch.com/install.sh), inspect it, then run it. + +After it finishes, reload your shell: + +```bash +source ~/.bashrc # or source ~/.zshrc +``` + +### 2. Run Quick Setup + +```bash +hermes setup +``` + +Select **Quick Setup**. Hermes opens a browser tab and waits for you to finish the next steps. + +### 3. Create a Nous Portal account + +In the browser, create a [Nous Portal](https://portal.nousresearch.com) account (or sign in) and choose the **Free** plan. + +### 4. Connect your account + +When prompted to connect your account to Hermes Agent, click **Connect**. You'll see a confirmation once it's linked. + +### 5. Select the free Nemotron 3 Ultra model + +Return to your terminal. From the model list, select: + +``` +nvidia/nemotron-3-ultra:free +``` + +The `:free` tag is what keeps it on the no-cost tier, so make sure you pick that variant. + +### 6. Start chatting + +Complete the remaining Quick Setup prompts, then run: + +```bash +hermes +``` + +That's it — you're talking to Nemotron 3 Ultra, free. + +## Switching to it later + +Already set up with another model? + +- **Desktop app:** open the model picker, search for **nemotron 3 ultra**, and select the **Free tier** variant. +- **CLI / TUI:** switch any time from inside a session with `/model nvidia/nemotron-3-ultra:free`, or run `/model` to open the picker and choose it from the list. + +## Troubleshooting + +- **Don't see the model in the list?** Make sure you finished the Nous Portal connection and that you're on the **Free** plan. In the CLI, `hermes portal info` confirms you're logged in and routing through Nous. +- **Picked the wrong variant?** Re-select `nvidia/nemotron-3-ultra:free` — the `:free` suffix is required to stay on the no-cost tier. +- **Browser didn't open / you're on a remote host (CLI)?** See [OAuth over SSH / Remote Hosts](/guides/oauth-over-ssh) for port-forwarding and manual-paste workarounds. + +## See also + +- **[Desktop App](/user-guide/desktop)** — The native one-click app (macOS, Windows, Linux) +- **[Run Hermes Agent with Nous Portal](/guides/run-hermes-with-nous-portal)** — Full Portal walkthrough: models, Tool Gateway, and verification +- **[Nous Portal integration](/integrations/nous-portal)** — What's in the subscription +- **[Quickstart](/getting-started/quickstart)** — Install-to-chat in under 5 minutes diff --git a/website/sidebars.ts b/website/sidebars.ts index 1a1f22caac8..b408af2ba66 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -691,6 +691,7 @@ const sidebars: SidebarsConfig = { label: 'Guides & Tutorials', collapsed: true, items: [ + 'guides/run-nemotron-3-ultra-free', 'guides/run-hermes-with-nous-portal', 'guides/tips', 'guides/local-llm-on-mac',