frontend/README.md

CHB Frontend (Multinodular SuperAgent UI)

A production-ready React + Vite app that implements the complete CHB UI:

• Auth (Signup/Login) with Admin Key gate (validated by backend against Hugging Face Space Secrets).
• Siri-like global voice (STT/TTS), Orbit state indicator, revolving brain.
• User dashboards: Chat, History, API Keys (with rate bar), HowTo, About, Settings.
• Admin dashboards: Monitor (WebSocket), Knowledge, Skills, VFS, Verify, Logs, Users, Connections.
• Notifications bell, rate limits (user), unlimited admin.

Quick Start

cp .env.example .env
# update .env to point to your backend
npm i
npm run dev

Expected Backend Endpoints

• POST /auth/signup → { token, role, name, nickname }
• POST /auth/login → { token, role, name, nickname }
• POST /v1/chat → { reply }
• POST /v1/facts/search → { items: [{q,a,t}] }
• GET /v1/apikey/usage → { used, limit, period, key }
• POST /v1/apikey/create → { key }
• POST /v1/apikey/revoke → {}
• Admin endpoints under /admin/* (see src/services/api.js)

The real Admin Key must be stored in HF Space Secrets and validated only on the backend.

Notes

• Uses Web Speech API (Chrome recommended) for voice.
• Uses Socket.IO for Monitor page; set VITE_WS_URL in .env.
• This UI never stores the Admin Key locally.