- Industrial dark theme with #76B900 NVIDIA green accents - Real-time telemetry from Kubernetes API - Create Sandbox button and workflow - Destroy Sandbox mode with destructive confirmation overlay - Sidebar fetches pod data directly from /api/telemetry/real - Fixed TypeError with defensive array checks - Technical typography, sharp corners, data-dense panels - Status indicators: GREEN RUNNING, red DESTROY mode
96 lines
2.5 KiB
Markdown
96 lines
2.5 KiB
Markdown
# Quick Start Guide
|
|
|
|
## Installation & Setup
|
|
|
|
1. **Navigate to project directory:**
|
|
```bash
|
|
cd /home/nvidia/.openclaw/workspace/nemo-shell-dashboard
|
|
```
|
|
|
|
2. **Install dependencies:**
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
3. **Start the development server:**
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
4. **Open your browser:**
|
|
```
|
|
http://localhost:3000
|
|
```
|
|
|
|
## What You'll See
|
|
|
|
- **Configuration Panel** at the top - set your OpenShell and Ollama URLs
|
|
- **Telemetry Cards** - CPU, memory, disk, and GPU usage (updates every 3 seconds)
|
|
- **One-Click Actions** - Start Sandbox, Stop Sandbox, Create Instance, Switch Model buttons
|
|
- **Model Switcher** - Dropdown to select Ollama models
|
|
- **Configuration Panels** - View settings for OpenShell, NemoClaw, and Ollama
|
|
|
|
## Testing the Dashboard
|
|
|
|
### Test 1: Verify Dashboard Loads
|
|
1. Open `http://localhost:3000`
|
|
2. All sections should render without errors
|
|
3. Telemetry should show values (randomly generated)
|
|
|
|
### Test 2: Configuration Panel
|
|
1. Edit the OpenShell URL field
|
|
2. Edit the Ollama URL field
|
|
3. Settings are saved to localStorage (persists on refresh)
|
|
|
|
### Test 3: One-Click Actions
|
|
1. Click "Start Sandbox"
|
|
2. Click "Stop Sandbox"
|
|
3. Click "Create Instance"
|
|
4. Click "Switch Model"
|
|
5. Check that status messages appear
|
|
|
|
### Test 4: Model Switcher
|
|
1. Select a different model from the dropdown
|
|
2. Click "Switch Model"
|
|
3. Verify success message
|
|
|
|
### Test 5: Telemetry Updates
|
|
1. Wait 3 seconds
|
|
2. Telemetry values should update automatically
|
|
3. No console errors should appear
|
|
|
|
## Troubleshooting
|
|
|
|
### Dashboard won't load
|
|
- Check if port 3000 is already in use: `lsof -ti:3000`
|
|
- Kill process: `kill -9 $(lsof -ti:3000)`
|
|
- Restart the server
|
|
|
|
### API endpoints returning errors
|
|
- This is expected - endpoints are mocked for development
|
|
- Check browser console for specific errors
|
|
- No real connection to OpenShell/Ollama is required
|
|
|
|
### Dependencies not installing
|
|
- Make sure you're running Node.js 18 or later
|
|
- Clear npm cache: `npm cache clean --force`
|
|
- Try reinstalling: `rm -rf node_modules package-lock.json && npm install`
|
|
|
|
## Next Steps (Production)
|
|
|
|
To make this production-ready:
|
|
|
|
1. Replace mock API routes with real API calls to OpenShell (port 8080) and Ollama (port 11434)
|
|
2. Add authentication to API routes
|
|
3. Implement proper error handling
|
|
4. Add loading states and skeletons
|
|
5. Add dark mode toggle
|
|
6. Add more detailed telemetry charts
|
|
7. Add deployment configuration (Docker, Vercel, etc.)
|
|
|
|
## Support
|
|
|
|
For issues or questions:
|
|
- Check the main README.md
|
|
- Review API route files for endpoint details
|
|
- Check browser console for errors |