2026-04-08 14:58:23 -06:00

OpenShell/NemoClaw Dashboard

A web-based control plane dashboard for managing OpenShell and NemoClaw instances, with live telemetry and one-click actions.

Features

  • Live Telemetry: Real-time CPU, memory, disk, and GPU monitoring
  • One-Click Actions: Quick actions to start/stop sandbox, create NemoClaw instances, and switch models
  • Configuration Management: Update OpenShell, NemoClaw, and Ollama settings
  • Model Switcher: Select and switch between available Ollama models
  • Local-first: Runs entirely on your local machine

Installation

Run the installer script which checks prerequisites and sets up everything:

./install.sh

The installer will:

  • ✅ Verify Node.js, npm, and Docker are installed
  • ✅ Check that your OpenShell-Mark container is running
  • ✅ Install npm dependencies
  • ✅ Build the dashboard
  • ✅ Create .env.local configuration file

Manual Install

  1. Navigate to the project directory:
cd nemo-shell-dashboard
  1. Install dependencies:
npm install

Prerequisites

  • Node.js 18+
  • npm 9+
  • Docker (Docker Desktop on Mac, or native Docker on Linux)
  • OpenShell-Mark fork running: ghcr.io/nvidia/openshell/cluster:dev

Running the Dashboard

After running ./install.sh:

  1. Start the development server:
npm run dev
  1. Open your browser and navigate to:
http://localhost:3000

Important

: Make sure your OpenShell-Mark container is running before starting the dashboard!

On Mac

# Start OpenShell first
/Applications/Docker.app/Contents/Resources/bin/docker run -d --name openshell-cluster -p 8080:30051 ghcr.io/nvidia/openshell/cluster:dev

# Then start the dashboard
npm run dev

On Linux

# Start OpenShell first
docker run -d --name openshell-cluster -p 8080:30051 ghcr.io/nvidia/openshell/cluster:dev

# Then start the dashboard
npm run dev

Configuration

The dashboard will attempt to connect to:

  • OpenShell: http://localhost:8080
  • Ollama: http://localhost:11434

You can update these URLs in the configuration panel at the top of the dashboard.

API Endpoints

The dashboard provides the following API endpoints (all mocked for development):

  • GET /api/telemetry - Get system telemetry
  • GET /api/config/openshell - Get OpenShell configuration
  • POST /api/config/openshell - Update OpenShell configuration
  • GET /api/config/nemoclaw - Get NemoClaw configuration
  • POST /api/config/nemoclaw - Update NemoClaw configuration
  • GET /api/config/ollama - Get Ollama configuration
  • POST /api/config/ollama - Update Ollama configuration
  • POST /api/actions/sandbox-start - Start the sandbox
  • POST /api/actions/sandbox-stop - Stop the sandbox
  • POST /api/actions/nemoclaw-create - Create a NemoClaw instance
  • POST /api/actions/model-switch - Switch to a different model

Development

This project uses:

  • Next.js 14 - React framework with App Router
  • TypeScript - Type safety
  • Tailwind CSS - Utility-first styling
  • React Use - Custom hooks
  • Zustand - State management
  • Axios - HTTP client

Production Build

Build the project for production:

npm run build
npm start

Notes

  • This is a development prototype. In production, you'll need to connect to real OpenShell and Ollama APIs.
  • All API endpoints are currently mocked for demonstration purposes.
  • Telemetry data is randomly generated for testing purposes.

License

MIT

S
Description
Fork von mmckeen-nv/openshell_controller — Fleet Control Tower Basis (Konzern v2)
Readme MIT
1.1 MiB
Languages
TypeScript 78.4%
JavaScript 19.5%
Shell 1.5%
CSS 0.4%
Dockerfile 0.2%