How suryakrishna999/coidspi works
Code Visualizer lets a learner enter Python, run it as a bounded trace, and inspect execution step by step; it also offers static explanations, trace-based narration, and code Q&A. The React app presents the trace and controls the current step, while the FastAPI service dispatches execution to a subprocess and provides AI-backed endpoints. A sampled Cloudflare Worker implements a parallel AI service path. The README documents the main workflow; some frontend request handlers and Worker routing details were not shown, so those links are limited to documented relationships.
Main entry points: App.jsx Visualizer app · main.py Trace endpoint · runner.py Sandboxed tracer · worker.py Cloudflare API
Components 12
Learner interface
- Visualizer app
frontend/src/App.jsx - Trace playback
frontend/src/App.jsx - Line explanations
frontend/src/App.jsx - Tutor chat
frontend/src/App.jsx
Trace execution
- Sandboxed tracer
backend/runner.py
API and AI
- HTTP API
backend/main.py - Trace endpoint
backend/main.py - Explain and chat
backend/main.py - Standalone explain page
backend/main.py
Worker runtime
- Cloudflare API
backend/src/worker.py
Other components
- Learner
- Workers AI
Connections 13
- Learner → Visualizer app: writes code
README.md - Visualizer app → Trace endpoint: requests trace
README.md - Trace endpoint → Sandboxed tracer: runs subprocess
backend/main.py - Sandboxed tracer → Trace endpoint: returns trace
README.md - Trace endpoint → Trace playback: supplies steps
README.md - Trace playback → Learner: shows playback
README.md - Visualizer app → Explain and chat: requests narration
README.md - Explain and chat → Visualizer app: returns narration
README.md - Learner → Tutor chat: asks questions
README.md - Tutor chat → Explain and chat: sends questions
- HTTP API → Standalone explain page: serves page
backend/main.py - Standalone explain page → Explain and chat: requests explanation
backend/main.py - Cloudflare API → Workers AI: runs model
backend/src/worker.py