convez.ai
AgenteEscrita & ConteúdoAvançado
nikklasblz

nied — Framework de Cursos Educacionais com IA

nikklasblz/nied

Gera cursos universitários verificados com IA + app gamificado de estudo

Ver no GitHub
BomPluginScore · de 0 a 100

Framework 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/nied

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 4 meses
Versão
v0.2.0
Issues abertas
0
Contribuidores
1

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

CI

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.

nied reader app dashboard

Versión en español

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.

A nied lesson with inline math, diagrams, and a quiz

Methodology (the hard rules)

  1. 100% free, primary sources — zero paywalled content.
  2. Teachable inline content — the syllabus is an index; the unit is the heart.
  3. Anti-fabrication: every URL is fetched and verified before inclusion.
  4. Markdown is the truth — apps only read; progress lives elsewhere.
  5. Non-coercive gamification.
  6. Units are generated one at a time, never a whole course in one shot.
  7. 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).

Spaced-repetition review session in the nied reader app

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

License

MIT

Ver o original no GitHub

Bom para

Relacionados