py-spy is a sampling profiler for Python programs. It lets you visualize what your Python program is spending time on without restarting the program or modifying the code in any way. py-spy is extremely low overhead: it is written in Rust for speed and doesn't run in the same process as the profiled Python program. This means py-spy is safe to use against production Python code. py-spy works from the command line and takes either the PID of the program you want to sample from or the command line of the python program you want to run. py-spy has three subcommands record, top and dump. py-spy supports recording profiles to a file using the record command. Top shows a live view of what functions are taking the most time in your python program, similar to the Unix top command.

Features

  • py-spy works on Linux, OSX, Windows and FreeBSD
  • Supports profiling all recent versions of the CPython interpreter
  • Prebuilt binary wheels can be installed from PyPI
  • py-spy can also display the current call stack for each python thread
  • Dump out the call stacks for each thread, and some other basic process info to the console
  • py-spy works by directly reading the memory of the python program

Project Samples

Project Activity

See All Activity >

Categories

Profiling

License

MIT License

Follow py-spy

py-spy Web Site

Other Useful Business Software
Gen AI apps are built with MongoDB Atlas Icon
Gen AI apps are built with MongoDB Atlas

The database for AI-powered applications.

MongoDB Atlas is the developer-friendly database used to build, scale, and run gen AI and LLM-powered apps—without needing a separate vector database. Atlas offers built-in vector search, global availability across 115+ regions, and flexible document modeling. Start building AI apps faster, all in one place.
Start Free
Rate This Project
Login To Rate This Project

User Reviews

Be the first to post a review of py-spy!

Additional Project Details

Operating Systems

Linux, Mac, Windows

Programming Language

Rust

Related Categories

Rust Profiling Software

Registered

2021-08-06