---
name: "Profile Python agent workloads with Scalene"
slug: "profile-python-agent-workloads-with-scalene"
description: "Use Scalene when a Python agent, tool server, or retrieval pipeline needs line-level CPU, GPU, and memory profiling before targeted optimization."
github_stars: 13455
verification: "security_reviewed"
source: "https://github.com/plasma-umass/scalene"
author: "plasma-umass"
publisher_type: "open_source"
category: "Code Quality & Review"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "plasma-umass/scalene"
  github_stars: 13455
---

# Profile Python agent workloads with Scalene

Use Scalene when a Python agent, tool server, or retrieval pipeline needs line-level CPU, GPU, and memory profiling before targeted optimization.

## Prerequisites

Python project or script that reproduces the workload; Scalene CLI; local or staging permission to run profiling

## Installation

Use the upstream install or setup path that matches your environment:
- conda install -c conda-forge scalene

Requirements and caveats from upstream:
- (tweet from Ian Ozsvald, author of [_High Performance Python_](https://smile.amazon.com/High-Performance-Python-Performant-Programming/dp/1492055026/ref=sr_1_1?crid=texbooks))
- [_Python Profiler Links to AI to Improve Code Scalene identifies inefficiencies and asks GPT-4 for suggestions_](https://spectrum.ieee.org/python-programming), IEEE Spectrum
- [Episode 172: Measuring Multiple Facets of Python Performance With Scalene](https://realpython.com/podcasts/rpp/172/), The Real Python podcast

Basic usage or getting-started notes:
- [![PyPI Latest Release](https://img.shields.io/pypi/v/scalene.svg)](https://pypi.org/project/scalene/)[![Anaconda-Server Badge](https://img.shields.io/conda/v/conda-forge/scalene)](https://anaconda.org/conda-forge/sca...
- <img width="571" alt="example proposed optimization" src="https://user-images.githubusercontent.com/1612723/211639968-37cf793f-3290-43d1-9282-79e579558388.png">
- python3 -m pip install -U scalene

- Source: https://github.com/plasma-umass/scalene
- Extracted from upstream docs: https://raw.githubusercontent.com/plasma-umass/scalene/HEAD/README.md

## Documentation

- https://github.com/plasma-umass/scalene

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/profile-python-agent-workloads-with-scalene/)