GhostWire is an Augmented Reality debugging tool for Tinkercad Circuits powered by Google Gemini Flash / any api model you have. It captures the circuit image, analyzes it for wiring errors (such as backward LEDs or missing grounds), and overlays the correct wiring path directly on the browser canvas using a neon green indicator.
- Real-time Analysis: Captures the active browser tab to analyze breadboard circuits.
- AI Diagnostics: Uses Gemini 1.5 Flash to identify component polarity and connection logic.
- AR Overlay: Draws SVG lines and error messages directly over the Tinkercad interface to guide corrections.
- Example:

- Navigate to the
backendfolder. - Install dependencies:
pip install -r requirements.txt
- Open
server.pyand replace the placeholder text with your Google Gemini API Key. - Start the server:
python server.py
- Open Google Chrome and go to
chrome://extensions. - Enable Developer mode in the top right corner.
- Click Load unpacked.
- Select the
extensionfolder from this repository.
- Ensure the Python backend is running.
- Open a circuit in Tinkercad.
- Click the GhostWire extension icon in the toolbar.
- Click Analyze Circuit.
- If an error is detected, a green overlay will appear on the screen showing the fix.
- Frontend: JavaScript (Chrome Extension Manifest V3)
- Backend: Python, FastAPI, Uvicorn
- AI Model: Google Gemini 2.5 Flash