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++ 里手写的微积分作业,你按下按键后,AI 智能体(Claude、Gemini 或 GPT)会像老师一样直接在屏幕上批改:圈出错误、勾出正确的步骤,并给出提示而不是答案。
这是独立应用,还是要接入别的软件?这是一个小型 Linux 工具加一个 xournal++ 插件:你在 xournal++ 里用数位板书写,按下快捷键,penmentor 就会调用你已安装的任一编程智能体 CLI,在页面上做标注并生成 manim 动画。
我怎么把它跑起来?在 Linux(X11)上使用 xournal++ 时,把 bin/penmentor 脚本绑定到一个键盘快捷键(推荐 i3);项目指南涵盖了安装配置、快捷键绑定,以及每个智能体的接入方式。
用之前我需要先装什么?你需要安装 rofi、slop、xdotool 和 PyQt6,还需要装好 xournal++,并且已安装并登录 Claude Code、Codex 或 Antigravity CLI 中的一个智能体,因为 penmentor 使用的是你现有的该智能体订阅。
我的 Linux 环境都能用吗?不能。它是为 X11 构建的,在 i3 窗口管理器下效果最好;没有提及对 Wayland 或非 Linux 系统的支持。
我可以选哪些 AI 模型?你在设置中通过前缀选择模型:claude: 用于 Claude Code(opus、sonnet、haiku),codex: 用于 Codex(例如 gpt-5.6-terra),agy: 用于 Antigravity CLI(例如 gemini-4-argon-medium)。
为什么只给提示,不直接给答案?作者的设计初衷是让你自己保持思考:它提供循序渐进的提示阶梯,从轻轻点拨,到点明所用的技巧,再到下一行的淡淡虚影,而不是直接把解答交给你。
manim 动画会展示什么?如果你框选了作业的某一部分,penmentor 会生成一个可交互的、3Blue1Brown 风格的 manim 动画,你可以操作它,比如拖动积分上下限,或重新输入一个数值,观察黎曼和如何收敛。
它只能看到屏幕可见的区域吗?不是。一个小型 xournal++ 插件会共享你正在处理的整页内容,而不只是当前屏幕能显示的部分,因此智能体能完整掌握你的作业内容。
大小
2.6 MB
星标
239
更新
提交Nov 08
时长
1个月
提交 · 90 天