Absortio

Email → Summary → Bookmark → Email

uniprof — CPU profiling for humans and AI agents

https://www.uniprof.sh/ Nov 14, 2025 18:53

Extracto

Enable agents to accurately fix slow code. Profile any application without code changes or added dependencies.

Resumen

Resumen Principal

uniprof se presenta como una herramienta innovadora que simplifica drásticamente el perfilado de CPU, haciéndolo accesible tanto para desarrolladores humanos como para agentes de Inteligencia Artificial. Su propuesta de valor central reside en la capacidad de perfilar cualquier aplicación –como Python o Ruby– sin necesidad de modificar el código fuente o añadir dependencias adicionales, automatizando la detección de plataformas y el uso de profiladores específicos como py-spy. El proceso es directo, generando un perfil detallado (profile.json) que desglosa el tiempo consumido por cada función. Por ejemplo, en una ejecución de app.py, uniprof identifica con precisión que process_batch consume un notable 46.4% del tiempo total (2.87s), con 2.30s de tiempo propio, revelando un claro cuello de botella. Esta información granular es crucial para la optimización y la depuración de rendimiento, consolidando a uniprof como una solución robusta y eficiente.

Elementos Clave

  • Perfilado Universal y Sin Invasión: uniprof permite perfilar cualquier aplicación (ej. Python, Ruby) sin requerir modificaciones en el código fuente ni la adición de dependencias, un aspecto fundamental para la integración sencilla. Detecta automáticamente la plataforma y utiliza el profiler adecuado, como py-spy para Python, garantizando una compatibilidad amplia y una implementación sin fricciones.
  • Análisis Detallado de Cuellos de Botella: La herramienta genera un informe exhaustivo que muestra las funciones más críticas, indicando su porcentaje de tiempo total, tiempo de

Contenido

uniprof simplifies CPU profiling for humans and AI agents.
Profile any application without code changes or added dependencies.

npx uniprof

uniprof python app.py

✓ Platform detected: python | Using profiler: py-spy | Mode: container

✓ Profiling completed successfully in 2.89s

Profile saved: profile.json

(124.87 KB)

Showing functions with ≥0.1% of total time

process 20:"python1046100.0%5.20s12.00ms4.00ms95.00ms220.00msapp.py:1

<module>104199.5%5.05s150.00ms3.50ms90.00ms180.00msapp.py:1

main95090.8%4.61s24.00ms3.80ms80.00ms160.00msapp.py:45

process_batch48546.4%2.87s2.30s14.00ms120.00ms260.00msapp.py:72

calculate_metrics31229.8%1.92s1.68s9.00ms140.00ms210.00msapp.py:89

parse_input15614.9%0.62s0.18s4.00ms55.00ms140.00msapp.py:23

Showing top 6 functions

CLI or MCP—your choice

Use uniprof directly from the command line, or add it to your AI agent as an MCP server.

# Install $ npm install -g uniprof # Get started $ uniprof help

Agents, now with the power to fix slow code

Watch an agent use uniprof to identify the real performance bottleneck instead of guessing.

Built in visualization

uniprof includes built-in flamegraph visualization powered by speedscope.

uniprof --visualize ruby app.rb

✓ Server started on http://127.0.0.1:50496

✓ Browser opened!

Press Ctrl+C to stop the server

Speedscope flamegraph viewer

Fuente: uniprof