uniprof — CPU profiling for humans and AI agents
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-spypara 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

Fuente: uniprof