nied — Framework de Cursos Educacionais com IA
nikklasblz/nied
Gera cursos universitários verificados com IA + app gamificado de estudo
Ver no GitHubFramework open-source que gera cursos universitários completos usando Claude Code, com pesquisa verificada de fontes gratuitas, geração de conteúdo estruturado (syllabus, unidades, quizzes), auditoria pedagógica e app gamificado para estudo local. Combina agentes de pesquisa, escrita e auditoria com bloqueios de qualidade antes da publicação.
Instalação
npx convez-ai nikklasblz/nied1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar currículos educacionais completos em minutos com verificação automática de fontes
- Ensinar tópicos complexos com conteúdo estruturado, diagramas, LaTeX e quizzes auto-avaliados
- Implementar prática espaçada e gamificação pedagógica em aplicações educacionais
Veredito

Framework sólido e metodologicamente rigoroso para geração de cursos, com ênfase em anti-fabricação e qualidade pedagógica. Exige conhecimento técnico de agents e Claude Code, mas entrega automação real em educação com padrões universitários.
README
A tradução para o português deste README ainda está na fila.
nied
An open-source educational agent framework: generate complete, university-grade courses on any topic with Claude Code, then study them in a gamified local web app.
Status: v0.1.0 — course schema, Claude Code plugin, reader app, and a framework-generated demo course. See the CHANGELOG.

What it does
/nied:course-create "topic"— interviews you, researches the domain top-down, and generates a full syllabus (course.yaml+SYLLABUS.md)./nied:course-unit u3— researches verified, 100% free primary sources and writes a complete teachable unit: inline explanations, LaTeX, Mermaid diagrams, embedded videos, auto-graded quizzes, retrieval practice, and a capstone./nied:course-audit— blocking QA: schema validation, live-URL checks, and a pedagogical rubric (university-level depth, Bloom alignment).
How it works
flowchart LR
A["/nied:course-create"] --> B[course.yaml + SYLLABUS.md]
B --> C["/nied:course-unit uN"]
C --> R[researcher\nverifies free sources] --> W[writer\nunits/uN.md + quizzes/uN.json] --> X[auditor\n6-dimension rubric]
X -->|FAIL ≤3 cycles| W
X -->|PASS| V[schema validate]
V --> S[reader app\nXP · quizzes · spaced repetition]
The writer agent has no network tools, so it cannot fabricate URLs — it can only cite sources the researcher already fetched and verified. The auditor is a blocking gate: a unit that fails the 6-dimension rubric goes back to the writer, up to three cycles, before anything ships. The reader app reads any course that validates against schema v1 — generated by nied or written by hand.

Methodology (the hard rules)
- 100% free, primary sources — zero paywalled content.
- Teachable inline content — the syllabus is an index; the unit is the heart.
- Anti-fabrication: every URL is fetched and verified before inclusion.
- Markdown is the truth — apps only read; progress lives elsewhere.
- Non-coercive gamification.
- Units are generated one at a time, never a whole course in one shot.
- Top-down canonical domain structure; personal project anchoring is optional.
The full rationale lives in docs/methodology.md.
Demo course
courses/estadistica-aplicada is a Spanish
applied-statistics course (intro level, 12 units). Its written units were
generated end-to-end by the framework itself — research with verified free
sources, writing, and adversarial audit — and the remaining units are declared
in the syllabus and pending, as a live example of hard rule 6: courses grow one
audited unit at a time.
Install
Inside Claude Code:
/plugin marketplace add nikklasblz/nied
/plugin install nied@nied
Alternatively, from a local clone of this repo:
/plugin marketplace add <local-path-to-this-clone> # registers the "nied" marketplace (name comes from .claude-plugin/marketplace.json)
/plugin install nied@nied # installs the "nied" plugin from the "nied" marketplace
Or load the plugin directly for a single session:
claude --plugin-dir ./plugin
See docs/getting-started.md for the full walkthrough, and CONTRIBUTING.md to contribute.
Reader app
A gamified local web app to study your generated courses: XP, streaks, achievements, auto-graded quizzes, and spaced-repetition review (Leitner).

bun install
cd app && bun run dev
Open http://localhost:3000. Configuration via env vars: NIED_COURSES_ROOT
(default ../courses), NIED_UI_LANGUAGE (es | en), NIED_DB_PATH,
NIED_INSTANCE_NAME, NIED_XP_PER_HOUR (default 25).
Progress lives in a local SQLite file; the app never modifies course content. The progress database is disposable — markdown is the truth.
Documentation
- Getting started — from zero to a generated course.
- Methodology — the 7 hard rules and why they exist.
- CHANGELOG.md — release history.
- CONTRIBUTING.md — how to contribute.
License
MIT