Разработчик OpenAI выпустил Blume: бесплатный фреймворк для документации нейросети

Разработчик из OpenAI Хейден Близел выпустил Blume, открытый фреймворк для документации нейросети, который превращает папку с Markdown-файлами в готовый сайт документации без написания кода и без сложной настройки.

Проект вышел на npm (реестр готовых пакетов для JavaScript-разработчиков) сразу в версии 1.0.3 под лицензией MIT, то есть его можно использовать бесплатно и без ограничений. Автор, Хейден Близел, известен как разработчик-эксперт из команды OpenAI. Исходный код опубликован на GitHub.

Что умеет Blume?

• Документация из папки. Кладёте файлы Markdown или MDX (расширенный Markdown с компонентами) в папку, запускаете одну команду и получаете сайт с навигацией, поиском, темами оформления и превью-картинками для соцсетей.

• Никакого шаблонного кода. После первого запуска не нужно поддерживать каркас приложения. Конфигурация необязательна и добавляется по одному файлу, когда понадобится.

• Встроенные ИИ-функции. Один флаг генерирует файлы llms.txt и llms-full.txt, это специальные файлы, которые ИИ-агенты читают как инструкцию по вашему продукту. Любую страницу можно открыть как чистый Markdown, добавив .md к адресу, или отправить прямо в ChatGPT, Claude или v0.

• Встроенный ИИ-ассистент. На страницах документации можно включить блок «Спросить ИИ», который отвечает на вопросы читателей. Он работает через AI SDK, Vercel AI Gateway, OpenRouter, Inkeep или любой OpenAI-совместимый сервер. Последнее критично: можно подключить российские ИИ-сервисы или локальные модели.

• MCP-сервер. Blume может запустить сервер Model Context Protocol (протокол, через который ИИ-инструменты читают вашу документацию напрямую). Через него Claude Code, Cursor и VS Code получают доступ к документации без копирования текста вручную. Сервер предоставляет четыре инструмента: поиск, получение страницы, список страниц и навигацию.

• Поддержка API-документации. Если у вас есть спецификация OpenAPI или AsyncAPI, Blume создаёт интерактивный справочник со схемами, авторизацией и песочницей для запросов через Scalar.

• 36 языков и локализация. Поддержка маршрутизации по языкам и вёрстки справа налево.

Как попробовать?

1. Убедитесь, что установлен Node.js версии 22.12 или новее. Blume работает с Bun, pnpm, npm или yarn.

2. Выполните команду npx blume init в терминале. Это создаст проект с базовой структурой.

3. Положите файлы Markdown в папку docs, запустите blume dev для локального просмотра или blume build для сборки готового сайта со статическим HTML и поисковым индексом.

4. Если нужна полная свобода, команда blume eject превращает скрытый проект в самостоятельное Astro-приложение (Astro, фреймворк для статических сайтов), которое можно настраивать как угодно.

Подключение российских ИИ-сервисов вместо западных

Для авторов и разработчиков из РФ и СНГ главное преимущество Blume в том, что встроенный ИИ-ассистент принимает любой OpenAI-совместимый сервер. Это значит, что вместо OpenAI или Claude можно подключить, например, YandexGPT через его API или GigaChat от Сбера, если они предоставляют совместимый формат запросов. Локальные модели с открытыми весами (открытые веса, когда параметры модели доступны для скачивания и запуска на своём сервере) тоже подходят.

Прямых аналогов Blume среди российских продуктов нет: YandexGPT и GigaChat решают другую задачу, генерируют текст, а не собирают сайт документации. Но их можно использовать вместе: Blume как оболочку, а российскую модель как мозг ассистента.

Что делать с этим прямо сейчас?

Авторам Дзена и копирайтерам. Если ведёте блог или продукт с технической документацией, Blume позволяет собрать сайт без программиста. Пишете в Markdown, получаете сайт. Встроенный ИИ-ассистент ответит на вопросы читателей за вас.

Маркетологам. Документация нейросети или любого ИИ-продукта, которая сама «разговаривает» с пользователем через встроенный ассистент, снижает нагрузку на поддержку. MCP-сервер означает, что ваш продукт станет видимым для ИИ-инструментов разработчиков без дополнительных интеграций.

Предпринимателям в РФ. Продукт бесплатен, код открыт, привязки к западным платформам нет. Можно развернуть на своём сервере и подключить российский языковой сервис.

Частые вопросы

Нужно ли платить за Blume?

Нет. Проект распространяется под лицензией MIT, это одна из самых свободных лицензий: можно использовать в коммерческих проектах бесплатно. Платить придётся только за хостинг сайта и, если подключаете, за вызовы языковой модели (например, YandexGPT тарифицирует по токенам).

Можно ли использовать без знания программирования?

Для базового сценария достаточно уметь работать с терминалом и писать тексты в Markdown. Если вы ведёте канал на Дзене, скорее всего, с Markdown уже сталкивались. Сложности начнутся при настройке ИИ-ассистента или MCP-сервера, там потребуется помощь разработчика.

Кто уже использует Blume?

По данным из репозитория проекта, среди первых пользователей, Quiver (переходит с платформы Mintlify) и документация Neon по add-mcp. Экосистема только формируется, так что большой базы примеров пока нет.

Blume не заменит полноценную CMS или вики, но для документации нейросети и ИИ-продуктов, где важна читаемость и для людей, и для машин, это рабочий инструмент с первого дня.