ClusterShell
ClusterShell library and tools
Decision gist · record as of 2026-08-14
Yes. ClusterShell is production-stable, actively maintained, carries no known vulnerabilities, and has minimal dependencies. Install it if you manage or script operations on Linux clusters or HPC systems and need parallel command execution with node group abstractions. The copyleft license is standard for system tools; verify compatibility with your deployment model if you plan to redistribute.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires SSH or other remote shell facilities already installed on target systems; designed for Linux/POSIX environments.
- Low install friction with a single runtime dependency (PyYAML).
- Actively maintained with a recent release; last commit was 2026-08-04 and the project has 473 stars.
License · maintenance · safety
LGPLv2+ (copyleft) — Licensed under LGPLv2+, a copyleft license. You may use and modify the package freely, but any derivative work must also be distributed under the same or compatible license terms.
last release 2026-07-16 (29 days) · last repo commit 2026-08-04 · 473 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 260,808 downloads/mo, #8,391 on PyPI
Alternatives
Verify before relying
pip install clustershell
from clustershell.task import Task
from clustershell.group import NodeSet
task = Task()
task.run_command('uname -r', nodes='node[1-10]')- Whether the package supports modern Python versions beyond what classifiers indicate (2.7 and 3.x are listed but no specific 3.x version floor is stated).
- Performance characteristics and scalability limits for very large clusters.
What it is and what it does
ClusterShell is a production-stable Python framework for event-driven parallel command execution across server farms and HPC clusters. It abstracts away the complexity of coordinating distributed work by handling node grouping, optimized execution algorithms, result gathering, and output deduplication. The package includes three command-line tools: clush for issuing commands to cluster nodes with formatted output, clubak for aggregating and sorting distributed outputs, and nodeset for computing advanced node group operations (expansion, intersection, exclusion, etc.).
The framework is designed for system administrators managing large Linux clusters. It leverages existing remote shell infrastructure like SSH rather than requiring new deployment mechanisms. With a single runtime dependency (PyYAML) and low install friction, it integrates into existing cluster management workflows. The project is actively maintained, has been in use since 2010, and carries no known security vulnerabilities.
Use it for
- Run a command across a range of cluster nodes and collect results in a compact, deduplicated format.
- Compute node group operations like expanding ranges (node[1-10]) or finding intersections of node sets.
- Gather and sort outputs from distributed shell commands using clubak, replacing or improving on dshbak.
- Automate cluster administration tasks that require parallel execution across many nodes with SSH.
- Build cluster management scripts that need to parse, filter, and manipulate node group specifications.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
ClusterShell is production-stable, actively maintained, carries no known vulnerabilities, and has minimal dependencies. Install it if you manage or script operations on Linux clusters or HPC systems and need parallel command execution with node group abstractions. The copyleft license is standard for system tools; verify compatibility with your deployment model if you plan to redistribute.
Install
clustershell on PyPI
Before you install
Low install friction with a single runtime dependency (PyYAML). Actively maintained with a recent release; last commit was 2026-08-04 and the project has 473 stars.
Requires SSH or other remote shell facilities already installed on target systems; designed for Linux/POSIX environments.
License in practice
Licensed under LGPLv2+, a copyleft license. You may use and modify the package freely, but any derivative work must also be distributed under the same or compatible license terms.
Quickstart
pip install clustershell
from clustershell.task import Task
from clustershell.group import NodeSet
task = Task()
task.run_command('uname -r', nodes='node[1-10]')Verify before relying
- Whether the package supports modern Python versions beyond what classifiers indicate (2.7 and 3.x are listed but no specific 3.x version floor is stated).
- Performance characteristics and scalability limits for very large clusters.
Package facts
| License | LGPLv2+ copyleft |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagePyYAML |
| Maintenance | Actively maintained 29 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 260,808 / month, #8,391 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: System AdministratorsLicense :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)Operating System :: MacOS :: MacOS XOperating System :: POSIX :: BSDOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 2.7Programming Language :: Python :: 3Topic :: Software Development :: Libraries :: Python ModulesTopic :: System :: ClusteringTopic :: System :: Distributed Computing |
Evidence: clustershell-1.10.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “parallel command execution clusters”
- ClusterShellClusterShell is a Python framework for running commands in parallel…
- ipyparallelManages clusters of IPython processes for parallel computing,…
- coiledCoiled is a Python client library that provisions and manages Dask…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also aws-parallelcluster · clusterscope · ipyparallel · distributed · openmpi · sfctl · slurm-usage · ppft · oneccl-devel · dask-jobqueue