Skip to main content

vllm-top

PyPI version

Demo

vllm-top is a Python package for monitoring and displaying metrics from the vLLM service. It provides a comprehensive dashboard to visualize both current state and historical performance, making it easy to track and analyze service behavior over time.


🚀 Features

  • Task State Visibility: Instantly see GPU Cache Usage, Running and Waiting requests to help debug bottlenecks and improve throughput.
  • Minimalist Monitoring: Lightweight dashboard that parses metrics directly from Prometheus.
  • Quick Setup: No extra configuration — just pip install and run.

📦 Installation

Install via pip:

pip install vllm-top

🛠️ Usage

Start monitoring:

vllm-top

Change update interval (in seconds):

vllm-top --interval 5

Get a one-time snapshot:

vllm-top --snapshot

🤝 Contributing

Contributions are welcome! Please submit a pull request or open an issue for enhancements or bug fixes.


📄 License

Licensed under the MIT License. See the LICENSE file for details.


📜 Changelog

See CHANGELOG.md for a detailed

Release files for vllm-top 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vllm-top 0.1.2
File Size Uploaded
vllm_top-0.1.2.tar.gz 9.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for vllm-top 0.1.2
File Interpreter ABI Platform
vllm_top-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 17.5 kB

Release files / vllm_top-0.1.2.tar.gz

Download URL vllm_top-0.1.2.tar.gz
Size 9.3 kB
Tags Source
SHA-256 checksum
How to use checksums
0a9e9e9e21cf3ce5752f9685aa02a7d5fb690647fb9eca918cacd4da7e464ccd
BLAKE2b-256 checksum
How to use checksums
2a8c4411331293908f4546b68a8a2da82a3eb94a63cd3ae738875ff82e406ffa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.0

Release files / vllm_top-0.1.2-py3-none-any.whl

Download URL vllm_top-0.1.2-py3-none-any.whl
Size 8.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
27b64ae88e33725a7f1d04879bf66932dadb2bb46ca422ea22b11e9b005024c4
BLAKE2b-256 checksum
How to use checksums
cf30dc990f9ecd1fc1fe5220849a429480dadc4a04cdfc80b2cc050e73ffc95c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.0

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page