Repolode
Enviar
AbdullahAlhariri

AbdullahAlhariri/penmentor

Un mentor de matemáticas con IA que anota tu trabajo manuscrito en pantalla con pistas, no respuestas, y puede animar conceptos con manim.

Ver en GitHub
Estrellas
68
Forks
3
Issues abiertos
0
Último commit
hace 17 horas

¿Qué es?

penmentor es una herramienta de escritorio para estudiar matemáticas a mano. Mientras escribes con una tableta gráfica, una tecla envía la página actual a un modelo de IA, que anota el trabajo en pantalla como lo haría un profesor con bolígrafos de colores: rodea el primer error real, marca las líneas correctas y subraya los pasos posteriores que dependen de ese error. Las pistas avanzan gradualmente, desde una sugerencia sutil hasta indicar la técnica, y también puede hacer preguntas para comprobar lo que recuerdas o proponerte ejercicios para encontrar el error.

Al enmarcar una parte de la página, se crea una animación interactiva con la biblioteca manim de 3Blue1Brown, por ejemplo, para arrastrar los límites de integración o ver cómo convergen las sumas de Riemann. La herramienta está diseñada para xournal++ en Linux con X11 e incluye un pequeño plugin para que el modelo vea la página completa, no solo el área visible.

Funciona con agentes de IA de línea de comandos que ya tengas, en lugar de requerir una API key independiente: Claude Code, Codex y Antigravity CLI, seleccionados mediante el prefijo del modelo en Settings. Para configurarla, necesitas tener una sesión iniciada en uno de esos agentes, además de rofi, slop, xdotool y PyQt6.

Funciones clave

  • 01Anota el trabajo manuscrito en pantalla: rodea el primer error y marca las líneas correctas.
  • 02Ofrece pistas graduales en vez de respuestas completas.
  • 03Genera animaciones interactivas con manim a partir de una región enmarcada de la página.
  • 04Funciona con Claude Code, Codex y Antigravity CLI mediante prefijos de modelo.
  • 05Incluye un plugin para xournal++ que permite que el modelo vea la página completa.
  • 06Ofrece preguntas para comprobar lo que recuerdas y ejercicios para encontrar el error.

Casos de uso

  • Estudiar cálculo u otras ramas de las matemáticas a mano, con una tableta gráfica y xournal++.
  • Recibir comentarios sobre los pasos de una tarea sin copiar el trabajo en una ventana de chat.
  • Visualizar un concepto, como una integral o un límite, mediante una animación interactiva.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/AbdullahAlhariri/penmentor ~/src/penmentor
  2. 2

    Ejecuta la prueba automática

    ~/src/penmentor/bin/penmentor --selftest
  3. 3

    Asigna bin/penmentor a una tecla en tu gestor de ventanas (consulta el ejemplo de i3 y la guía)

Antes de usarlo

  • Solo funciona en Linux con X11; se recomienda i3.
  • Requiere un agente CLI instalado y con sesión iniciada (claude, codex o agy), además de rofi, slop, xdotool y PyQt6.
  • Funciona mediante el flujo de trabajo de xournal++ descrito en el README.

Temas

#ai#math#education#manim#xournal#handwriting#llm#linux

Preguntas frecuentes

¿Qué es penmentor?
Un mentor de matemáticas con IA que anota tu trabajo manuscrito en pantalla con pistas, no respuestas, y puede animar conceptos con manim. penmentor es una herramienta de escritorio para estudiar matemáticas a mano. Mientras escribes con una tableta gráfica, una tecla envía la página actual a un modelo de IA, que anota el trabajo en pantalla como lo haría un profesor con bolígrafos de colores: rodea el primer error real, marca las líneas correctas y subraya los pasos posteriores que dependen de ese error. Las pistas avanzan gradualmente, desde una sugerencia sutil hasta indicar la técnica, y también puede hacer preguntas para comprobar lo que recuerdas o proponerte ejercicios para encontrar el error.
¿penmentor es gratuito? ¿Qué licencia tiene?
penmentor es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿penmentor sigue mantenido?
Mantenimiento activo. El último commit de penmentor fue el 20 oct 2026.
¿Para qué puedo usar penmentor?
Estudiar cálculo u otras ramas de las matemáticas a mano, con una tableta gráfica y xournal++. Recibir comentarios sobre los pasos de una tarea sin copiar el trabajo en una ventana de chat. Visualizar un concepto, como una integral o un límite, mediante una animación interactiva.
¿Cómo se instala penmentor?
Clona el repositorio: git clone https://github.com/AbdullahAlhariri/penmentor ~/src/penmentor Ejecuta la prueba automática: ~/src/penmentor/bin/penmentor --selftest Asigna bin/penmentor a una tecla en tu gestor de ventanas (consulta el ejemplo de i3 y la guía)
¿Dónde consigo penmentor?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/AbdullahAlhariri/penmentor

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados