# CCExtractor/vardbg

A simple Python debugger and profiler that generates animated visualizations of program flow, useful for algorithm learning.

Repository: https://github.com/CCExtractor/vardbg
Canonical: https://ross.abutalabs.com/products/vardbg
Language: Python
License: MIT
License Family: permissive
Topics: python, debugger, gci, gci2019, profiler, flow, video, visualization, hacktoberfest
Last push: 2021-06-10T20:44:27+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2424, "days_push": 1910, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1112, forks 93 (observed 2026-08-28T04:03:37.767817+00:00)

## What it is
vardbg is a simple Python debugger and profiler that records variable history and execution times, then generates animated videos visualizing program flow. It is designed to help learners understand algorithms by watching them execute step by step.

## Use cases
- visualize how sorting algorithms work step by step
- debug a python function while tracking variable history
- profile line-by-line execution times of a script
- generate an mp4 or gif animation of program flow
- record a debug session to  and replay it later

## When to choose
- you are learning or teaching algorithms and want animated visualizations
- you want a lightweight python debugger with video output
- you need to export and replay execution history in

## When to avoid
- you need a full-featured interactive debugger like pdb or an IDE debugger
- you are profiling performance-critical code where overhead matters
- you need support for languages other than python

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: benchmarking, data-visualization, developer-tools
- domain: developer-tools, education
- platform: cli, python, cross-platform
- tags: algorithm-visualization, video-generation, -replay, learning-tool, debugger, algorithms, command-line

## Member repositories
- CCExtractor/vardbg (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:37.767817+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:42:38.521763+00:00, confidence not recorded.
  - readme: https://github.com/CCExtractor/vardbg (fetched 2026-08-28T04:03:37.767817+00:00, sha 42a2bfddc095)
  - registry_pypi: https://pypi.org/pypi/vardbg/json (fetched 2026-08-29T12:46:37.783660+00:00, sha 1c3b8bf5c0cf)
- Data as of 2026-08-30T08:39:29.467469+00:00.