pyroscope-io
Pyroscope Python integration
Decision gist · record as of 2026-08-14
Yes, if you have a Pyroscope server running and need production-grade continuous profiling. The package is actively maintained, has no external Python dependencies, and carries a permissive license. Medium install friction is typical for compiled profilers and not a barrier. No known security vulnerabilities. Install it when you're ready to move beyond ad-hoc profiling to systematic performance monitoring.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Requires a running Pyroscope server to send profiles to.
- Medium install friction due to platform-specific wheels (compiled bindings for multiple Python versions and architectures).
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and state significant changes.
last release 2026-07-27 (18 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 11,704,674 downloads/mo, #1,369 on PyPI
Alternatives
Verify before relying
pip install pyroscope-io
import pyroscope
pyroscope.configure(
app_name="my-app",
server_address="http://localhost:PORT"
)
# Your application code runs with profiling enabled- Exact overhead and performance impact of continuous sampling on production workloads
- Whether py-spy integration requires any system-level permissions or capabilities
- Supported Pyroscope server versions and compatibility guarantees
- Default server address and port configuration for Pyroscope integration
What it is and what it does
Pyroscope-io is a Python profiling agent that continuously samples your application's call stacks and streams the data to a Pyroscope server. It uses py-spy for stack sampling and a Rust backend to handle profile transmission, giving you ongoing visibility into where your application spends CPU time without requiring code instrumentation.
The package is designed for production profiling workflows where you want to understand performance characteristics over time rather than one-off profiling sessions. It has no Python runtime dependencies and works across macOS, Linux, and Unix systems on modern Python versions. Installation involves downloading platform-specific wheels, so setup is straightforward but version-specific.
Use it for
- Identify CPU hotspots in long-running services by collecting continuous profiles over time
- Debug performance regressions by comparing flame graphs from different time periods
- Monitor production applications to catch unexpected performance degradation early
- Analyze batch job performance to optimize resource allocation and execution time
- Profile multi-threaded or async applications to understand concurrency patterns
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you have a Pyroscope server running and need production-grade continuous profiling.
The package is actively maintained, has no external Python dependencies, and carries a permissive license. Medium install friction is typical for compiled profilers and not a barrier. No known security vulnerabilities. Install it when you're ready to move beyond ad-hoc profiling to systematic performance monitoring.
Install
pyroscope-io on PyPI
Before you install
Medium install friction due to platform-specific wheels (compiled bindings for multiple Python versions and architectures). Active maintenance with a recent release 18 days ago. No runtime dependencies to manage.
Requires Python 3.10 or later. Requires a running Pyroscope server to send profiles to.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and state significant changes.
Quickstart
pip install pyroscope-io
import pyroscope
pyroscope.configure(
app_name="my-app",
server_address="http://localhost:PORT"
)
# Your application code runs with profiling enabledVerify before relying
- Exact overhead and performance impact of continuous sampling on production workloads
- Whether py-spy integration requires any system-level permissions or capabilities
- Supported Pyroscope server versions and compatibility guarantees
- Default server address and port configuration for Pyroscope integration
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 18 days since the last release |
| First released | |
| Downloads | 11,704,674 / month, #1,369 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersOperating System :: MacOSOperating System :: POSIXOperating System :: UnixProgramming Language :: PythonTopic :: Software DevelopmentTopic :: Software Development :: DebuggersTopic :: Utilities |
Evidence: pyroscope_io-1.2.1-cp310-cp310-macosx_11_0_arm64.whl; pyroscope_io-1.2.1-cp310-cp310-macosx_11_0_x86_64.whl; pyroscope_io-1.2.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; pyroscope_io-1.2.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; pyroscope_io-1.2.1-cp310-cp310-musllinux_1_2_aarch64.whl; pyroscope_io-1.2.1-cp310-cp310-musllinux_1_2_x86_64.whl; pyroscope_io-1.2.1-cp311-cp311-macosx_11_0_arm64.whl; pyroscope_io-1.2.1-cp311-cp311-macosx_11_0_x86_64.whl; pyroscope_io-1.2.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; pyroscope_io-1.2.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; pyroscope_io-1.2.1-cp311-cp311-musllinux_1_2_aarch64.whl; pyroscope_io-1.2.1-cp311-cp311-musllinux_1_2_x86_64.whl; pyroscope_io-1.2.1-cp312-cp312-macosx_11_0_arm64.whl; pyroscope_io-1.2.1-cp312-cp312-macosx_11_0_x86_64.whl; pyroscope_io-1.2.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; pyroscope_io-1.2.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; pyroscope_io-1.2.1-cp312-cp312-musllinux_1_2_aarch64.whl; pyroscope_io-1.2.1-cp312-cp312-musllinux_1_2_x86_64.whl; pyroscope_io-1.2.1-cp313-cp313-macosx_11_0_arm64.whl; pyroscope_io-1.2.1-cp313-cp313-macosx_11_0_x86_64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “python profiling agent”
- pyroscope-ioPyroscope-io is a continuous profiling agent that samples Python…
- codeguru-profiler-agentIntegrates Python applications with Amazon CodeGuru Profiler to…
- google-cloud-profilerCollects and uploads CPU, memory, and wall-time profiles from Python…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also py-spy · pyroscope-otel · google-cloud-profiler · austin-dist · codeguru-profiler-agent · memory-profiler · gilknocker · pyinstrument · fastapi-profiler · ppk2-api