explaingit

gordensun/math2ggb

Analysis updated 2026-05-18

59PythonAudience · vibe coderComplexity · 2/5Setup · easy

TLDR

Math2GGB is a Cursor Agent Skill that turns geometry problems into accurate, interactive GeoGebra files by driving GeoGebra's real engine in a browser.

Mindmap

mindmap
  root((math2ggb))
    What it does
      Geometry to GeoGebra
      Constraint accurate figures
      Three file variants
    Tech stack
      Python
      GeoGebra
      JavaScript
      Cursor
    Use cases
      Math tutoring
      Lesson creation
      Interactive figures
    Audience
      Vibe coders
      Educators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a geometry textbook problem into an interactive GeoGebra file you can drag and explore.

USE CASE 2

Generate a teaching version of a figure with helper lines and live angle or length readouts.

USE CASE 3

Produce a faithful static reproduction of a printed geometric figure with correct measurements.

USE CASE 4

Add geometry-to-GeoGebra generation as a Cursor skill for math tutoring or lesson prep.

What is it built with?

PythonGeoGebraJavaScriptCursor

How does it compare?

gordensun/math2ggb0xsha/wp2shellcp-cp/liveedit
Stars595959
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity2/55/55/5
Audiencevibe coderdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a browser automation tool, internet access to load GeoGebra, and Python 3.

No license information is stated in the README.

In plain English

Math2GGB is a skill for the Cursor AI coding assistant that converts a math problem, especially a geometry problem, into working GeoGebra files. GeoGebra is a free tool for drawing and interacting with geometric figures. Instead of just drawing a rough copy of a diagram, this skill measures the original image carefully and rebuilds the figure using real geometric relationships, such as points lying on the same circle, lines intersecting, reflections, midpoints, and other constraints, so the figure behaves correctly when someone drags a point around. For each math problem it produces three separate files: a static version that exactly reproduces the printed figure with nothing added or missing, a clean interactive version that looks identical but can be dragged around while every original condition still holds, and a teaching version that adds helper lines, labels, and live angle or length readouts that can be toggled on and off. Under the hood, it works by actually driving GeoGebra's own engine inside a browser using GeoGebra's JavaScript interface, rather than writing the file format by hand, and then exports the result so the output always opens correctly in GeoGebra. To verify accuracy, it temporarily adds measurement objects to check coordinates, lengths, and angles against the original image, then removes them before the final file is saved. Installation means copying the skill folder into your Cursor skills directory, either for all your projects or just one. Once installed, you ask the Cursor agent in plain language to turn a geometry problem into a GeoGebra file. It needs a browser automation tool, an internet connection to load GeoGebra from its website, and Python 3 installed. The README also notes that opening the resulting files in the sandboxed macOS App Store version of GeoGebra requires using the app's own Open menu rather than double-clicking the file.

Copy-paste prompts

Prompt 1
Turn this geometry problem into an interactive GeoGebra file with helper lines toggled on.
Prompt 2
Walk me through installing Math2GGB into my Cursor skills directory.
Prompt 3
Explain how Math2GGB verifies its GeoGebra figure matches the original image before exporting.
Prompt 4
Why does my exported .ggb file look blank when I open it in the macOS GeoGebra app?

Frequently asked questions

What is math2ggb?

Math2GGB is a Cursor Agent Skill that turns geometry problems into accurate, interactive GeoGebra files by driving GeoGebra's real engine in a browser.

What language is math2ggb written in?

Mainly Python. The stack also includes Python, GeoGebra, JavaScript.

What license does math2ggb use?

No license information is stated in the README.

How hard is math2ggb to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is math2ggb for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.