---
id: codeguru-profiler-agent
version: "1.2.6"
license: unclear
license_treatment: permissive
maintenance: aging
---

# codeguru-profiler-agent — The Python agent to be used for Amazon CodeGuru Profiler

License: permissive · Maintenance: aging · Downloads: 835.3K/mo

## What it is and what it does

The CodeGuru Profiler Python Agent is an AWS-provided instrumentation library that collects runtime profiling data from Python applications and streams it to Amazon CodeGuru Profiler for centralized analysis. It depends on boto3 to communicate with AWS services and runs as a background agent within your application process.

The agent is designed to be integrated into production applications to provide continuous performance insights, identifying bottlenecks and optimization opportunities. It supports Python 3.6 through 3.13 and has been in production use since its initial release in late 2020, though recent maintenance activity has slowed.

Use it for:

- Monitor CPU and memory usage patterns in production Python services running on AWS.
- Identify performance bottlenecks and hot code paths in long-running applications.
- Collect continuous profiling data for applications deployed on EC2, ECS, or Lambda.
- Correlate application performance metrics with AWS infrastructure and business metrics.
- Troubleshoot performance regressions by comparing profiling data across application versions.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Integrates Python applications with Amazon CodeGuru Profiler to collect runtime performance data and send it to AWS for analysis and optimization recommendations.

Yes, if you run Python applications on AWS and need built-in profiling integration with CodeGuru. The package is production-stable, has no known vulnerabilities, and installs with minimal friction. The aging maintenance status is a minor concern but not a blocker—the agent is mature and the underlying AWS service remains actively supported. Requires active AWS credentials and CodeGuru Profiler subscription.

## Install

pip install codeguru-profiler-agent
uv add codeguru-profiler-agent
poetry add codeguru-profiler-agent

## Installing codeguru-profiler-agent

Before you install: Low install friction with a pure-Python wheel distribution. Maintenance status is aging—last commit was 246 days ago—but the package remains in production-stable classification and continues to support current Python versions.

License in practice: Licensed under Apache-2.0 (permissive), which allows free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install codeguru-profiler-agent

import codeguru_profiler_agent
# Agent initialization and profiling configuration handled by the package

Requires AWS credentials and boto3 configuration to communicate with CodeGuru Profiler service.

Verify before relying:

- Whether the agent requires specific AWS IAM permissions or credential configuration beyond boto3 setup.
- Performance overhead of the profiler agent on typical application workloads.
- Compatibility with async/await patterns and concurrent execution frameworks.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 835.3K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

AWS CodeGuru profiler agent, Python application profiling, AWS performance monitoring, runtime profiling AWS, application performance analysis, code profiling agent, AWS observability Python, aws-integration, profiling, observability

[View on SkillFed](https://skillfed.io/packages/codeguru-profiler-agent) · [View on PyPI](https://pypi.org/project/codeguru-profiler-agent/)