BookLeme CLI
CLI на Python компилирует книгу в устанавливаемый Agent Skill: знание-справочник и поведенческий скилл с проверкой цитат по тексту
- 182 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает ваши файлы книг и пишет скиллы, а с флагом `--install` записывает их в каталог скиллов агента
- Скилл, собранный из книги, попадает в агента как инструкции и может расходиться с вашими правами на текст
Установка
Ручная установка
git clone https://github.com/bookleme/bookleme.git
cd bookleme
python3 -m bookleme --versionНужен Python 3.9 и новее, зависимостей нет. Запуск на книге: `python3 -m bookleme run --input <файл> --title "<название>"`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает ваши файлы книг и пишет скиллы, а с флагом `--install` записывает их в каталог скиллов агента
- Скилл, собранный из книги, попадает в агента как инструкции и может расходиться с вашими правами на текст
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
BookLeme читает книгу и собирает из нее Agent Skill. Автор исходит из того, что ценность книги в способе работы автора, например в порядке вопросов или условиях и правилах проверки, а их надо превратить в вызываемую процедуру. Книга читается один раз при сборке, а во время работы агент подгружает нужные фрагменты. Два вида результата: `knowledge_pack` дает справочник с индексом тем, а `behavior_skill` дает процесс с состояниями, например диалог-коуч. Движок выбирается флагом `--engine auto|knowledge_pack|behavior_skill|both`, жанр через плагины, например `coach_dialogue` и `knowledge_reference`. Принимаются форматы PDF, EPUB, DOCX, MD, HTML, RTF и MOBI. Проверка идет скриптами. Каждая цитата обязана быть точной подстрокой книги, а семь показателей, среди них доля разрешенных ссылок, нарушения дословности, пересечение с текстом и покрытие, помечены как measured или heuristic. Группа проверок авторских прав ограничивает долю цитат, а флаг `--user-rights owned|licensed|public_domain|unknown` фиксирует права на книгу. Публикация требует явного подтверждения `--public --confirm-public PUBLISH`.
Для кого. Тем, кто работает с профессиональными книгами и хочет получить из них навыки для агента вместо конспектов: коучам, аналитикам, преподавателям.
Подходит, если
- Есть своя книга или книга с правами использования, и из ее методики нужен скилл-диалог
- Справочник по книге с индексом тем и ссылками на источник должен лежать рядом с агентом
- Перед установкой требуется проверка: каждая цитата должна быть точной подстрокой текста
- Перед публикацией хочется оценить долю цитат и пересечение с оригиналом
- Книга лежит в EPUB, DOCX или MOBI, и ее надо разобрать без ручной подготовки
Не подходит, если
- Нужен пересказ книги для чтения: инструмент строит рабочие навыки
- Права на книгу не подтверждены и распространять результат нельзя: публикация требует явного подтверждения
- Нужен LLM-оценщик правдивости: показатель `groundedness` пока считается только эвристикой и не подключен
- Книга не про методику: скилл строится на порядке вопросов, условиях и правилах проверки
Пример запроса к агенту
Скомпилируй мою книгу `book.epub` в поведенческий скилл через `python3 -m bookleme run --input book.epub --title "Моя книга" --user-rights owned`, затем проверь результат командой `validate`Ограничения
- Нужен Python 3.9 и новее; зависимостей третьих сторон нет. Тесты запускает `python3 -m unittest discover -s tests -v`.
- Показатель `groundedness` в README помечен как эвристика и пока равен `null`, потому что LLM-оценщик не подключен.
- Метрики в README получены на одной реальной книге из 273 страниц и на синтетических примерах.
- Права на исходную книгу остаются на вас: флаг `--user-rights` фиксирует заявление, а публичная раздача требует `--public --confirm-public PUBLISH`.
Как отключить. Установленные скиллы удаляют из каталога скиллов агента, сам инструмент достаточно удалить вместе с клоном репозитория. Флаг `--install` по умолчанию выключен, без него ничего не записывается в каталог скиллов.
Частые вопросы
Как установить BookLeme?
Выполните `git clone https://github.com/bookleme/bookleme.git`, перейдите в папку и проверьте `python3 -m bookleme --version`. Хватит Python 3.9 и новее.
Какие форматы книг принимает BookLeme?
PDF, EPUB, DOCX, MD, HTML, RTF и MOBI. Для тестовой проверки в репозитории лежит синтетическая книга `evals/cases/synthetic/coach_book.md`.
Чем отличаются knowledge_pack и behavior_skill?
`knowledge_pack` дает справочник с индексом тем, а `behavior_skill` дает процесс с состояниями, например диалог-коуча. Флаг `--engine both` выдает оба.
Как BookLeme проверяет, что в скилле нет выдуманных цитат?
Команда `validate` проверяет, что каждая цитата точно совпадает с подстрокой книги, а еще считает пересечение с текстом и покрытие. Ограничение доли цитат входит в проверки авторских прав.
Записывает ли BookLeme скилл в каталог агента сам?
Нет, флаг `--install` выключен по умолчанию. Без него результат остается в папке запуска.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПревращает техническую книгу или папку документов в структурированный скилл с главами, глоссарием и шпаргалкой
Набор скиллов для создания интерактивных учебников на MkDocs: граф понятий, главы, симуляции, тесты и глоссарий.
Скилл для перевода целых книг в форматах PDF, DOCX и EPUB на любой язык с помощью параллельных субагентов
litdb собирает вашу научную литературу в локальную базу с семантическим поиском и дает агенту скилл и MCP-сервер для чтения
Learn from materials
learn-from-materials
Скилл превращает книги, PDF, презентации и документы в проверяемую базу знаний и интерактивную учебную страницу с источниками, схемами и самопроверкой
Два скилла для Claude Code и Codex: агент переводит научные статьи в библиотеке EasyRead и отвечает на заметки на полях
Коротко о README
Документ объясняет идею: ценность книги в способе работы автора, и показывает три принципа проектирования. Затем описаны два вида результата, двойной движок, проверка точности цитат и авторских прав, быстрый старт с командами `run` и `validate`, архитектура, сравнение с похожими проектами и дорожная карта.