penmentor README

README проекта с github.com/AbdullahAlhariri/penmentor. Одним файлом markdown: README.md.

penmentor

A maths mentor at the tip of your pen. Press a key while you work by hand: Claude, Gemini or GPT marks your work on the screen like a teacher with coloured pens, gives you hints instead of answers, and shows the idea as a 3Blue1Brown-style animation.

Writing an integral in xournal++, penmentor marking the sign slip, then animating the area
Handwriting in xournal++ → one key → the slip is marked on the page → box the integral → an interactive manim animation. (video; for a repeatable recording the pen is scripted and the model's answer is a fixed example.)

Why I use it

I study calculus with a pen tablet in xournal++. I kept screenshotting my work into Claude and reading long answers back, when what I wanted was a teacher looking over my shoulder: circle the mistake, tick what's right, nudge me toward the next step, and show me why. penmentor is that, one key away, on my own Claude subscription.

How it helps you learn

Works with Claude Code, Codex and Antigravity

penmentor runs on the AI command-line agent you already use, on that subscription. Pick the model in Settings; its prefix says which agent answers:

Prefix Agent For example
claude: Claude Code claude:opus, claude:sonnet, claude:haiku
codex: Codex codex:gpt-5.6-terra
agy: Antigravity CLI agy:gemini-4-argon-medium, agy:gemini-3.8-flash-medium

Settings lists the agents you have installed. How each one is run and what it sees: the guide.

Quick start

git clone https://github.com/AbdullahAlhariri/penmentor ~/src/penmentor
~/src/penmentor/bin/penmentor --selftest

Linux on X11 (best with i3), with one of those agents logged in (claude, codex or agy), plus rofi, slop, xdotool and PyQt6. Bind bin/penmentor to a key (example). Setup, keys and how it works: the guide.

Star History

Star History Chart

License

MIT

penmentor (AbdullahAlhariri/penmentor)

Ищем в базе…

Что это такое?Наставник для проверки решения задач по математике: он следит за вашими рукописными работами по математическому анализу в xournal++ и, когда вы нажимаете клавишу, ИИ-агент (Claude, Gemini или GPT) проверяет работу прямо на экране, как учитель: обводит ошибки, ставит галочки у верных строк и даёт подсказки вместо ответов.
Это отдельное приложение или оно подключается к чему-то ещё?Это небольшой инструмент для Linux и плагин для xournal++: вы пишете на графическом планшете в xournal++, нажимаете горячую клавишу, и penmentor обращается к CLI-агенту для программирования, который уже установлен у вас, чтобы разметить страницу и создать анимацию в manim.
Как это запустить?Привяжите скрипт bin/penmentor к сочетанию клавиш во время работы в xournal++ на Linux с X11 (рекомендуется i3); в руководстве проекта описаны настройка, сочетания клавиш и то, как подключается каждый агент.
Что нужно установить перед использованием?Нужны rofi, slop, xdotool и PyQt6, установленный xournal++ и агент Claude Code, Codex или Antigravity CLI, который уже установлен и на котором выполнен вход в аккаунт, так как penmentor использует вашу существующую подписку этого агента.
Работает ли это на любой конфигурации Linux?Нет, это сделано для X11 и лучше всего работает в оконном менеджере i3; упоминаний поддержки Wayland или не-Linux систем нет.
Какие модели ИИ можно выбрать?Модель выбирается по префиксу в настройках: claude: для Claude Code (opus, sonnet, haiku), codex: для Codex (например, gpt-5.6-terra) или agy: для Antigravity CLI (например, gemini-4-argon-medium).
Почему подсказки, а не готовые ответы?Автор сделал так, чтобы вы сами продолжали думать: инструмент даёт поэтапную лесенку подсказок — от лёгкого толчка до названия метода и едва заметного контура следующей строки, а не просто выдаёт решение.
Что показывает анимация manim?Если вы обведёте часть своей работы рамкой, penmentor создаст интерактивную анимацию в стиле 3Blue1Brown на manim, с которой можно работать: например, перетаскивать пределы интеграла или перепечатать значение, чтобы посмотреть, как сходятся суммы Римана.
Видит ли он только видимую часть экрана?Нет, небольшой плагин для xournal++ передаёт всю страницу, над которой вы работаете, а не только то, что сейчас помещается на экране, поэтому агент полностью видит вашу работу.
Какие есть похожие проекты?Auto-claude-code-research-in-sleep, Gnos, webcodex, brag, ordewell, ai-guide, oh-my-hermes, awesome-chatgpt-zh
Размер
2.6 MB
Звёзды
239
Обновлён
КоммитNov 08
Возраст
1 мес
Коммиты · 90 дней