> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# profiler • AI Agents Framework
> PraisonAI Profiler Module
# profiler
AI Agents Framework
PraisonAI Profiler Module
Standardized profiling for performance monitoring across praisonai and praisonai-agents.
Features:
* Import timing
* Function execution timing
* Flow tracking
* File/module usage tracking
* Memory usage (tracemalloc)
* API call profiling (wall-clock time)
* Streaming profiling (TTFT, total time)
* Statistics (p50, p95, p99)
* cProfile integration
* Flamegraph generation
* Line-level profiling
* JSON/HTML export
Usage:
from praisonai.profiler import Profiler, profile, profile\_imports
# Profile a function
@profile
def my\_function():
pass
# Profile a block
with Profiler.block("my\_operation"):
do\_something()
# Profile API calls
with Profiler.api\_call("[https://api.example.com](https://api.example.com)") as call:
response = requests.get(...)
# Profile streaming
with Profiler.streaming("chat") as tracker:
tracker.first\_token()
for chunk in stream:
tracker.chunk()
# Profile imports
with profile\_imports():
import heavy\_module
# Get report with statistics
Profiler.report()
stats = Profiler.get\_statistics()
# Export
Profiler.export\_json()
Profiler.export\_html()
## Import
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai import profiler
```
## Classes
Record of a single timing measurement.
Record of an API/HTTP call.
Record of streaming operation (LLM responses).
Record of memory usage.
Record of a module import.
Record of execution flow.
Track streaming operations (LLM responses).
Centralized profiler for performance monitoring.
Context manager to profile imports.
## Functions
Decorator to profile a function.
Decorator to profile an async function.
Create an import profiler context manager.
Decorator to profile a function as an API call.
Decorator to profile an async function as an API call.
Decorator for detailed cProfile profiling.
Decorator for line-level profiling.
Time how long it takes to import a module.
Check if a module is available without importing it.
***
## Related Documentation