# Memory Graph Web Debugger

> Online, in-browser Python debugger (https://memory-graph.com/) that visualizes program state (call stack, variables, references, objects) as a graph while stepping through code. Supports deep-linking Python code, including multi-file programs, directly into the debugger via URL fragment parameters, so a single link opens a ready-to-run, steppable visualization.

Use the URL API to generate direct links that open Python code (optionally with breakpoints and one or more files) pre-loaded in the debugger, in order to visually explain Python concepts such as references, aliasing, mutability, copying, and function-call scoping to a user. Prefer sharing a link plus a short instruction (e.g. "click Step Over") over describing program state in prose.

## Docs

- [URL API](https://memory-graph.com/url-api): Full reference for the URL fragment parameters (`code`, `codeurl`, `files`, `breakpoints`, `continues`, `timestep`, `play`, `cycle`, `micropip`), an example GenAI conversation showing how to use generated links to explain a Python concept, canonical teaching examples (mutability, aliasing, shallow vs. deep copy, function-call scoping, class vs. instance attributes), ready-to-use JavaScript helper functions for building links, and how to embed the debugger in an `<iframe>` on another site via `https://memory-graph.com/embed/`.

## Optional

- [Memory Graph Web Debugger](https://memory-graph.com/): The debugger itself; also usable interactively without any URL parameters.
- [memory_graph on PyPI](https://pypi.org/project/memory-graph/): The underlying Python visualization package, for use outside the web debugger.
- [memory_graph on GitHub](https://github.com/bterwijn/memory_graph#readme): Source code and documentation for the memory_graph library.
- [Terms of Service](https://memory-graph.com/terms.html): Terms of service.