# ParallelSSH/parallel-ssh

Asynchronous parallel SSH client library.

Repository: https://github.com/ParallelSSH/parallel-ssh
Canonical: https://ross.abutalabs.com/products/parallel-ssh
Homepage: https://parallel-ssh.org
Language: Python
License: LGPL-2.1
License Family: copyleft
Topics: parallel-ssh, ssh, parallel, asynchronous, library, python, ssh-client, parallelssh, non-blocking-io, non-blocking, async, libssh2, gevent, libssh, aio, libev, ssh-client-library, ssh-library, python-library, asyncio
Last push: 2026-08-05T14:03:14+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 96, release rhythm 52, longevity 100
- inputs: {"age_days": 5000, "days_push": 28, "days_rel": 323, "gap_med": 10.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1282, forks 153 (observed 2026-08-28T04:04:14.045453+00:00)

## What it is
parallel-ssh is an asynchronous parallel SSH client library for Python that can run commands and file transfers across hundreds to hundreds of thousands of servers concurrently. It uses native C-based clients (libssh2 via ssh2-python) for high performance with minimal client-side load.

## Use cases
- run commands on many servers in parallel over ssh
- execute remote shell commands asynchronously from python
- bulk ssh automation across a fleet of hosts
- parallel sftp/scp file transfers to multiple servers
- automate remote server administration at scale
- non-blocking ssh client for python asyncio or gevent apps

## When to choose
- you need to run ssh commands or file transfers on many hosts concurrently with high performance
- you want a python ssh library with native C bindings for low overhead
- you need async (asyncio or gevent) ssh client support

## When to avoid
- you only need simple single-host ssh with no parallelism and prefer a pure-python library like paramiko
- you need an interactive ssh terminal session rather than programmatic command execution
- you need a ready-made orchestration tool rather than a library to build on

## Facets
- artifact type: library
- maturity: active
- function: ssh, concurrency, developer-tools
- domain: developer-tools, networking
- platform: python, windows, cross-platform
- tags: ssh-client, parallel-execution, asyncio, gevent, libssh2, sftp, scp, remote-commands, command-line, automation, linux, macos

## Member repositories
- ParallelSSH/parallel-ssh (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:14.045453+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-30T04:57:40.331635+00:00, confidence not recorded.
  - readme: https://github.com/ParallelSSH/parallel-ssh (fetched 2026-08-28T04:04:14.045453+00:00, sha 92dffdc740f9)
- Data as of 2026-08-30T08:39:29.467469+00:00.