pyspy

Official

Benchmark Python scripts and find bottlenecks.

Authorscverse
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It helps you identify which parts of your Python code consume the most CPU time so you can speed up slow scripts and optimize performance with evidence.

Core Features & Use Cases

  • Execution time profiling with py-spy: Capture a CPU-time profile for a target Python script.
  • Speedscope visualization: Open the recorded profile in a browser-based viewer to inspect call paths and hotspots.
  • CPU vs GIL time control: Use options like recording only GIL-held time for Python-level CPU profiling or include deeper native activity by adjusting flags.

Use when you need to debug performance regressions, compare versions, or confirm whether the slowness comes from Python vs extension/native work.

Quick Start

Profile your script by running the profiling environment command for pyspy with your script path, producing a speedscope JSON profile you can open afterward.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: pyspy
Download link: https://github.com/scverse/spatialdata/archive/main.zip#pyspy

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.