Вайб-школа

Учебная программа для тех, кто делает продукты руками ИИ. Темы проходишь вместе с Claude: он читает лекцию, задаёт вопросы, проверяет ответы и практику. Всё это видно на локальном сайте: карта тем, лекции, твои ответы и оценки.

Как это работает

 Claude (Code или Desktop) ──MCP──▶ vibe-school ──▶ ~/.vibe-school/progress.json
                                         │
                                         └──▶ сайт http://localhost:4747

Один процесс — это и MCP-сервер, и сайт. Claude запускает его сам при старте. Он берёт следующую тему, записывает лекцию на сайт, читает твои ответы, ставит оценки и закрывает тему. Отвечать можно на сайте или прямо в чате.

Related MCP server: tutor-mcp-python

Установка

Нужен Node.js 20 или новее и Claude Code или Claude Desktop.

git clone https://github.com/britov/vibe-school.git
cd vibe-school
npm install
npm run setup

npm run setup напечатает готовую команду подключения с путём к твоей папке. Для Claude Code это одна строка:

claude mcp add --scope user vibe-school -- node "/путь/к/vibe-school/server/index.js"

Дальше открой Claude и напиши: «давай учиться». Claude покажет прогресс и ссылку на сайт. В Claude Code можно вызвать готовую команду /mcp__vibe-school__lesson.

Сайт без Claude: npm start — только посмотреть программу и прогресс.

Порядок тем

1. Трек 1, темы 1.1–1.10 — без них ИИ делает «что-то», а ты не понимаешь что.

2. Трек 2, темы 2.1–2.8 — пользователь, проблема, гипотеза, требования.

3. Трек 3 целиком — запуск своего мини-продукта.

4. Остальные темы треков 1 и 2, по мере надобности.

Claude держится этого порядка сам. Если тема опирается на непройденную, он скажет об этом.

Настройки

Прогресс хранится только на твоём компьютере. Сайт открыт только для localhost.

Кнопка 🎤 в полях ответа включает голосовой ввод браузера (Chrome, Edge, Safari; в Firefox кнопки нет). Речь распознаёт сервис браузера — Google или Apple, то есть звук уходит к ним. Не хочешь этого — пользуйся системной диктовкой (на Mac — дважды Fn) или печатай.

Озвученные лекции

У темы может быть готовая лекция голосом: кнопка «▶ Слушать лекцию» на странице темы. Учитель объясняет своими словами, а не зачитывает текст. Пока он говорит, на странице подсвечивается пункт, о котором идёт речь, а внизу идут субтитры с подсветкой текущего слова. В конце учитель задаёт первый вопрос, звук останавливается, и курсор встаёт в поле ответа. Пробел — пауза, кнопка «1×» меняет скорость.

Сейчас озвучен весь трек 1. Чтобы озвучить тему другого трека, понадобится Mac на Apple Silicon:

1. Создай lessons/<номер>/script.json по образцу lessons/1.1/script.json. В нём blocks — письменная лекция по блокам, segments — реплики учителя. У каждой реплики block (какой блок подсвечивать) или question (номер вопроса с 0 — им лекция заканчивается). Пиши так, как говорят: короткими фразами, числа словами, без сокращений.

2. Поставь инструменты: uv tool install mlx-audio, uv tool install mlx-whisper, brew install ffmpeg.

3. Запусти python3 tools/voice-lesson/build.py lessons/<номер>. Голос учителя лежит в tools/voice-lesson/voices/teacher.wav, поэтому все лекции звучат одним голосом. Если скрипт пишет «проверь на слух», переформулируй реплику и перезапусти её: --redo 6.

Голос синтезирован моделью Qwen3-TTS (Apache 2.0) по текстовому описанию. Это не клон реального человека. Время каждого слова определяет Whisper (MIT).

Как добавить или поправить тему

Темы — обычные markdown-файлы в tracks/. Формат описан в CLAUDE.md. После правки запусти npm test: тест проверит, что каждая тема разбирается и в ней все поля на месте. Номера существующих тем не меняй — по ним хранится прогресс.

Лицензия

Код — MIT. Тексты тем — CC BY 4.0: можно использовать и переделывать с указанием источника. Статьи по ссылкам принадлежат их авторам.