Start

Curriculum Generator GUI

The START project includes a lightweight browser-based GUI for generating custom Active Inference curricula without needing to use the command line.

Quick Start

uv run python -m learning.curriculum_creation.generate_curriculum_gui

This launches a local HTTP server (default: http://127.0.0.1:8765) and opens your default browser.

GUI Features

How It Works

The GUI server’s own code introduces no third-party dependencies beyond the project’s existing pipeline dependencies (which the shared orchestrator already requires); its HTTP/UI layer uses only the Python standard library. It:

  1. Serves an HTML/CSS/JS frontend from a built-in HTTP server
  2. Accepts form input (domain, entity, language, entity description)
  3. Spawns a background thread running the CurriculumOrchestrator from generate_custom_curriculum.py
  4. Polls a /status endpoint every second for live updates
  5. Displays results when the pipeline completes

Pipeline Stages

The GUI runs all five stages of the pipeline:

  1. Domain Research (25%) — Analyzes the domain using Perplexity API
  2. Entity Research (25%) — Researches the target audience using Perplexity API
  3. Curriculum Generation (30%) — Generates curriculum content using OpenRouter API
  4. Visualization (10%) — Creates charts and Mermaid diagrams
  5. Translation (10%) — Translates to the target language using OpenRouter API

Command-Line Arguments

Argument Description Default
--host Server host address 127.0.0.1
--port Server port 8765
--no-browser Don’t auto-open browser False
--allow-remote Opt into non-loopback binding False
--auth-token Require this header for remote requests unset

Example:

uv run python -m learning.curriculum_creation.generate_curriculum_gui --port 9000 --no-browser

API Endpoints

The GUI server exposes these JSON endpoints:

Endpoint Method Description
/ GET Serves the HTML GUI
/options GET Returns available domains, entities, languages as JSON
/status GET Returns current pipeline progress, completion, error, and run-lock state as JSON
/results GET Returns an escaped HTML summary of completed run
/start POST Starts a pipeline run with form data
/cancel POST Requests cancellation of the active run

Notes