# gaogaotiantian/viztracer

A debugging and profiling tool that can trace and visualize python code execution

Repository: https://github.com/gaogaotiantian/viztracer
Canonical: https://ross.abutalabs.com/products/viztracer
Homepage: https://viztracer.readthedocs.io/
Language: Python
License: Apache-2.0
License Family: permissive
Topics: tracer, python3, debugging, profiling, visualization, flamegraph, python, logging
Last push: 2026-08-18T13:43:55+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 44, longevity 100
- inputs: {"age_days": 2220, "days_push": 15, "days_rel": 296, "gap_med": 31.0, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7725, forks 473 (observed 2026-08-28T04:10:02.641120+00:00)

## What it is
VizTracer is a low-overhead debugging and profiling tool that traces and visualizes Python code execution on an interactive timeline. It requires no source code changes, supports threading, multiprocessing, async, and PyTorch, and renders traces in a Perfetto-powered viewer.

## Use cases
- profile python script execution
- visualize function call timeline
- find performance bottlenecks in python code
- debug async and multithreaded python programs
- generate flamegraphs for python
- trace multiprocessing and subprocess calls
- inspect function entry and exit with source code

## When to choose
- you need low-overhead Python tracing without changing source code
- you want timeline visualization of function calls including async and multiprocessing
- you need to render very large trace files smoothly

## When to avoid
- you need production continuous profiling rather than on-demand tracing
- you profile non-Python code
- you need memory profiling specifically

## Facets
- artifact type: cli-tool
- maturity: active
- function: tracing, monitoring, benchmarking, developer-tools, cli, data-visualization
- domain: developer-tools, performance
- platform: python, windows, cli
- tags: profiler, flamegraph, trace-visualization, perfetto, async-debugging, debugging, linux, macos

## Member repositories
- gaogaotiantian/viztracer (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:02.641120+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-29T17:35:14.910116+00:00, confidence not recorded.
  - readme: https://github.com/gaogaotiantian/viztracer (fetched 2026-08-28T04:10:02.641120+00:00, sha 5e737bf033c3)
- Data as of 2026-08-30T08:39:29.467469+00:00.