# giampaolo/psutil

Cross-platform lib for process and system monitoring in Python

Repository: https://github.com/giampaolo/psutil
Canonical: https://ross.abutalabs.com/products/psutil
Homepage: https://psutil.io
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: python, monitoring, cpu, memory, disk, sensors, network, cross-platform, processes
Last push: 2026-08-27T00:01:48+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 100
- inputs: {"age_days": 4485, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 11266, forks 1509 (observed 2026-08-28T04:10:46.594489+00:00)

## What it is
psutil is a cross-platform Python library for retrieving information about running processes and system utilization (CPU, memory, disks, network, sensors). It implements functionality of UNIX tools like ps, top, free, iotop, netstat, and lsof, and supports Linux, Windows, macOS, BSD, Solaris, and AIX.

## Use cases
- monitor cpu and memory usage from python
- list running processes and their details
- get disk usage and io counters
- monitor network interfaces and connections
- kill or manage running processes
- build a system monitoring dashboard
- profile application resource consumption
- limit process resources

## When to choose
- you need system or process metrics in Python across multiple operating systems
- you want a Python replacement for ps, top, netstat, or lsof
- you are building monitoring, profiling, or process-management tooling

## When to avoid
- you need metrics for non-Python runtimes without a Python dependency
- you need distributed/cluster monitoring rather than single-host metrics
- you need time-series storage or alerting rather than raw metric collection

## Facets
- artifact type: library
- maturity: stable
- function: monitoring, developer-tools
- domain: developer-tools, monitoring, operating-systems, performance
- platform: python, windows, bsd, cross-platform
- tags: process-management, system-utilities, cpu, memory, disk, network, sensors, profiling, linux, macos

## Member repositories
- giampaolo/psutil (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:46.594489+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:16:23.895863+00:00, confidence not recorded.
  - readme: https://github.com/giampaolo/psutil (fetched 2026-08-28T04:10:46.594489+00:00, sha 85249cefbe07)
  - homepage: https://psutil.io (fetched 2026-08-29T08:14:50.499598+00:00, sha dd42cda84753)
  - site_page: https://psutil.io/install (fetched 2026-08-29T08:14:50.502470+00:00, sha f03f48e6643d)
  - site_page: https://psutil.io/about (fetched 2026-08-29T08:14:50.511144+00:00, sha abc06d06927c)
  - site_page: https://psutil.io/faq (fetched 2026-08-29T08:14:50.504296+00:00, sha 5e5d0a21aee1)
  - site_page: https://psutil.io/changelog (fetched 2026-08-29T08:14:50.506489+00:00, sha 7d08d5fe708a)
- Data as of 2026-08-30T08:39:29.467469+00:00.