An AI-powered multi-agent classroom that turns any topic into an interactive learning experience.

English · 中文 · 日本語

Features · Quick Start · Architecture · Testing · Structure · Contributing

---

Overview

Nova is a multi-agent teaching platform. Give it a topic and an AI teacher generates a structured course outline, produces slides, writes narration scripts, and delivers the lesson in a virtual classroom. Multiple AI agents collaborate — a teacher leads the lecture, an assistant answers questions, and a class clown keeps the mood light.

The core idea: not just a slide generator, but a complete teaching system with role separation, safety guardrails, and knowledge tracking.

Features

Course Generation

• AI Outline Generation — Breaks a topic into progressive scenes ordered by knowledge dependencies
• Slide Production — Each scene ships with titles, bullet points, and flow diagrams
• Voice Narration — The AI teacher narrates each scene with natural TTS across multiple engines
• Interactive Quizzes — Auto-generated multiple-choice and fill-in-the-blank questions with real-time scoring
• Knowledge Graph — Visual concept maps that connect key ideas across the course
• PBL Mode — Project-based learning with interactive practice tasks

Multi-Agent Classroom

Agent	Role	Permissions
AI Teacher	Leads the lesson, explains core concepts	Speak, slide control, spotlight, whiteboard
AI Assistant	Supports the teacher, answers questions	Speak, whiteboard, slide control
Class Clown	Lightens the mood	Speak

• Role Persistence — Customize names, descriptions, and permissions for 10 built-in roles; changes persist across sessions
• Runtime Constraints — Per-role max_actions and max_turns enforced at runtime
• Discussion Orchestration — A Director Graph manages turn-taking and discussion flow

Prompt Engineering & Governance

• 34 Templates — Covering outline generation, content creation, action sequencing, and quiz generation
• Snippet System — Role guidelines and action types stored as Markdown snippets, editable without recompiling
• Guardrails — PII detection, toxicity filtering, and hallucination scanning on every generated scene
• Skill Registry — 5 registered skills gated by a whitelist
• REST API — GET /api/prompts to list templates, GET /api/skills to list skills

Infrastructure

20+ LLM Providers

Provider	Example Models
OpenAI	GPT-4o, GPT-4o-mini
Anthropic	Claude 3.5 Sonnet, Claude 3 Opus
Google	Gemini 2.0 Flash, Gemini 1.5 Pro
DeepSeek	DeepSeek-V4-Pro, DeepSeek-V4-Flash
Qwen	Qwen3.5-397B, Qwen3.6-35B
GLM	GLM-5.2, GLM-5.1
Kimi	Kimi-K2.6
MiniMax	MiniMax-M3
SiliconFlow	Full model aggregation
Doubao	Doubao series
Ollama	Local models
Lemonade	Local AMD models

• TTS — OpenAI, SiliconFlow, Doubao, Minimax, Volcano
• Image Generation — SiliconFlow, Minimax, ComfyUI
• Web Search — Tavily, SearXNG
• Document Parsing — AliDocMind, MinerU
• MCP Tools — Connect external tools via Model Context Protocol
• i18n — English, Simplified Chinese, Traditional Chinese, Japanese, Korean, Arabic, Portuguese, Russian
• Dark Mode — Site-wide support

Architecture

Data flow: user enters a topic → the prompt engine assembles the prompt → LLM generates content → guardrails scan for safety → multi-agent orchestration → interactive classroom rendering. State is persisted to browser-local storage via Zustand.

Quick Start

Prerequisites

• Node.js 22+
• pnpm 10+

Installation

git clone https://github.com/weed33834/nova.git
cd nova
pnpm install

Configuration

Create a .env.local file with at least one LLM provider:

# Option A: direct API key
SILICONFLOW_API_KEY=your-key
SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1

# Option B: server-side managed config (recommended)
cp server-providers.example.yml server-providers.yml
# Edit server-providers.yml with your credentials — keys stay server-side

Run

pnpm dev

Open http://localhost:3000 and enter a topic to start.

No API Key? Try the Demo

Click "Open Cached Demo Course" on the home page to load a pre-built Introduction to AI course — no API key required.

Testing

pnpm test          # Unit & component tests (312 files / 2768 cases)
pnpm test:e2e      # End-to-end tests (Playwright)
pnpm test:e2e:ui   # E2E with interactive UI
pnpm lint          # ESLint
pnpm typecheck     # TypeScript type checking

E2E tests cover the full flow: home → generation → classroom navigation → quiz interaction. All tests use mock APIs — no LLM key needed.

Project Structure

nova/
├── app/                  # Next.js App Router
│   ├── api/              # API routes (prompts, skills, generate/*)
│   └── [locale]/         # i18n routing
├── lib/                  # Core logic
│   ├── ai/               # Multi-LLM provider integration
│   ├── agent/            # Multi-agent runtime
│   ├── choreography/     # Animations & effects
│   ├── guardrails/       # Safety pipeline
│   ├── orchestration/    # Role management & constraints
│   └── prompts/          # Prompt templates & snippets
├── components/           # React components
├── packages/             # Workspace sub-packages
│   └── @nova/
│       ├── dsl/          # Domain type definitions
│       ├── renderer/     # Slide rendering engine
│       ├── importer/     # Document import
│       └── storage/      # Persistence layer
├── e2e/                  # Playwright tests
├── configs/              # Shared constants
└── assets/               # Static assets & logo

Tech Stack

Layer	Technology
Framework	Next.js 16 (App Router, Turbopack)
Language	TypeScript 5.8
UI	React 19, Tailwind CSS 4, Radix UI
State	Zustand (persisted)
AI	Vercel AI SDK, multi-provider
Testing	Vitest, Playwright
Package Manager	pnpm Workspaces

Contributing

Issues and pull requests are welcome. Please read CONTRIBUTING.md before submitting.

License

MIT