-
Notifications
You must be signed in to change notification settings - Fork 2.7k
docs(get-started): add Brev web UI quickstart guide #2563
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
miyoungc
merged 12 commits into
NVIDIA:main
from
hemachandra666:docs/brev-web-ui-quickstart
May 5, 2026
Merged
Changes from all commits
Commits
Show all changes
12 commits
Select commit
Hold shift + click to select a range
9851ddd
Add files via upload
hemachandra666 16b5414
Revise NemoClaw quickstart guide for Brev web UI
hemachandra666 0971a6b
docs(get-started): update Brev web UI quickstart to follow style guide
hemachandra666 d1c96ed
docs(get-started): register Brev web UI page in toctree
hemachandra666 caf8dcc
Merge branch 'main' into docs/brev-web-ui-quickstart
hemachandra666 1afe6c3
Merge branch 'main' into docs/brev-web-ui-quickstart
hemachandra666 fb7e661
Update docs/get-started/brev-web-ui-quickstart.md
hemachandra666 31237e9
docs(index): move Brev web UI page to Deployment section
hemachandra666 3616258
docs(get-started): remove Dashboard, Troubleshooting, and upstream Op…
hemachandra666 42c24df
Merge branch 'main' into docs/brev-web-ui-quickstart
hemachandra666 fd7493f
Update docs/index.md
hemachandra666 878627e
Merge branch 'main' into docs/brev-web-ui-quickstart
hemachandra666 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Some comments aren't visible on the classic Files Changed page.
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,163 @@ | ||
| --- | ||
| title: | ||
| page: "Get Started with NemoClaw on Brev (Web UI)" | ||
| nav: "Brev Web UI" | ||
| description: | ||
| main: "Run a sandboxed NemoClaw agent in minutes using the Brev web interface with no CLI installation or local setup required." | ||
| agent: "Guides users through deploying NemoClaw using the Brev web UI. Use when a user wants to try NemoClaw without installing the CLI, or asks how to get started on Brev." | ||
| keywords: ["nemoclaw brev web ui", "nemoclaw getting started", "brev quickstart", "nvidia nemotron agent"] | ||
| topics: ["generative_ai", "ai_agents"] | ||
| tags: ["brev", "openclaw", "getting-started", "web-ui", "nemoclaw"] | ||
| content: | ||
| type: get_started | ||
| difficulty: technical_beginner | ||
| audience: ["developer", "engineer"] | ||
| status: published | ||
| --- | ||
|
|
||
| <!-- | ||
| SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. | ||
| SPDX-License-Identifier: Apache-2.0 | ||
| --> | ||
|
|
||
| # Get Started with NemoClaw on Brev (Web UI) | ||
|
coderabbitai[bot] marked this conversation as resolved.
|
||
|
|
||
| Run a sandboxed NemoClaw agent in minutes using the Brev web interface. | ||
|
coderabbitai[bot] marked this conversation as resolved.
|
||
| No CLI installation, no local setup, and no GPU required on your machine. | ||
|
|
||
| :::{note} | ||
| This guide covers the Brev web UI flow, which is the fastest way to try NemoClaw. | ||
| If you prefer the CLI-based remote deployment, see [Deploy to a Remote GPU Instance](../deployment/deploy-to-remote-gpu.md). | ||
| ::: | ||
|
|
||
| ## Prerequisites | ||
|
|
||
| - An NVIDIA Brev account at [brev.nvidia.com](https://brev.nvidia.com) | ||
| - An NVIDIA API key from [build.nvidia.com](https://build.nvidia.com) | ||
|
|
||
| No local software installation is needed. | ||
|
|
||
| ## Get Your NVIDIA API Key | ||
|
|
||
| 1. Go to [build.nvidia.com](https://build.nvidia.com). | ||
| 2. Sign in or create a free account. | ||
| 3. Click your profile icon in the top right. | ||
| 4. Select **API Keys**. | ||
| 5. Click **Generate API Key**. | ||
| 6. Copy the key -- it starts with `nvapi-`. | ||
|
|
||
| Keep this key ready for the next step. | ||
|
|
||
| ## Deploy NemoClaw on Brev | ||
|
|
||
| 1. Go to [brev.nvidia.com](https://brev.nvidia.com) and sign in. | ||
| 2. On the **GPUs** page, look for the banner: **"Your agents are waiting. Meet NemoClaw"**. | ||
| 3. Click **Try NemoClaw**. | ||
| 4. The NemoClaw setup page shows the following: | ||
| - Instance type: CPU (4 CPUs, 16 GiB RAM) | ||
| - Cloud Provider: GCP | ||
| - Cost: $0.18/hr | ||
| 5. Click **Deploy NemoClaw**. | ||
|
|
||
| ## Configure Your Agent | ||
|
|
||
| NemoClaw walks you through three configuration steps. | ||
|
|
||
| ### Connect to AI | ||
|
|
||
| - **NVIDIA Cloud** is selected by default (recommended). | ||
| - This uses Nemotron-3-Super-120B hosted by NVIDIA. | ||
| - Paste your `nvapi-` API key in the field. | ||
| - Click **Create Agent**. | ||
|
|
||
| :::{note} | ||
| Other providers are available: OpenAI, Anthropic, Google Gemini, and Local Ollama. | ||
| Click **Show Other Providers** to see all options. | ||
| ::: | ||
|
|
||
| ### Setup | ||
|
|
||
| NemoClaw automatically performs the following: | ||
|
|
||
| - Provisions a secure Linux VM on GCP. | ||
| - Installs Docker and the OpenShell runtime. | ||
| - Sets up the sandboxed agent environment. | ||
| - Configures inference routing to NVIDIA Cloud. | ||
|
|
||
| This takes approximately 2-3 minutes. | ||
|
|
||
| ### Launch | ||
|
|
||
| When setup completes, the following confirmation appears: | ||
|
|
||
| ```text | ||
| AGENT CREATED SUCCESSFULLY | ||
| Your agent is running in a secure sandbox and ready to use. | ||
|
|
||
| Agent: agent | ||
| Model: nemotron-3-super-120b | ||
| Provider: NVIDIA Cloud | ||
| ``` | ||
|
|
||
| Click **Chat With Agent** to open the OpenClaw gateway dashboard. | ||
|
|
||
| ## Have Your First Conversation | ||
|
|
||
| In the Chat box, type the following: | ||
|
|
||
| ```text | ||
| Hello! What can you do for me? What skills do you have available? | ||
| ``` | ||
|
|
||
| The agent reads its workspace files and introduces itself. | ||
| By default it has three skills available: | ||
|
|
||
| - **Weather** -- Get current weather and forecasts. | ||
| - **Healthcheck** -- Security audit and hardening. | ||
| - **Skill-Creator** -- Create new custom skills. | ||
|
|
||
| ## Tell the Agent Who You Are | ||
|
|
||
| The agent starts with an empty `USER.md` file -- it knows nothing about you. | ||
| Update it so the agent personalizes its responses. | ||
|
|
||
| In the chat, type the following: | ||
|
|
||
| ```text | ||
| Please update my USER.md file with the following: | ||
| Name: [your name] | ||
| Timezone: [your timezone, e.g. EST] | ||
| Notes: [what you are working on] | ||
| ``` | ||
|
|
||
| The agent writes this to your workspace so it remembers you across sessions. | ||
|
|
||
| ## Stop Your Instance When Done | ||
|
|
||
| To avoid unnecessary charges, stop your instance when you are finished experimenting. | ||
|
|
||
| 1. Go back to [brev.nvidia.com](https://brev.nvidia.com). | ||
| 2. Click **GPUs** in the nav bar. | ||
| 3. Find your NemoClaw instance. | ||
| 4. Click **Stop**. | ||
|
|
||
| At $0.18/hr, a 3-hour session costs approximately $0.54. | ||
|
|
||
| ## What to Try Next | ||
|
|
||
| Now that your agent is running, explore these capabilities. | ||
|
|
||
| **Connect a messaging channel.** | ||
| Go to **Channels** in the dashboard to connect your agent to Telegram, Slack, or Discord so it can message you proactively. | ||
|
|
||
| **Use a different AI model.** | ||
| The agent supports switching inference providers at runtime. | ||
| See [Switch Inference Providers](../inference/switch-inference-providers.md) for instructions. | ||
|
|
||
| ## Next Steps | ||
|
|
||
| - [Prerequisites](prerequisites.md) -- System requirements before getting started. | ||
| - [Quickstart](quickstart.md) -- CLI-based local setup. | ||
| - [Deploy to a Remote GPU Instance](../deployment/deploy-to-remote-gpu.md) -- CLI-based Brev deployment. | ||
| - [Troubleshooting](../reference/troubleshooting.md) -- Common issues and fixes. | ||
| - [Monitor Sandbox Activity](../monitoring/monitor-sandbox-activity.md) | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.