---
id: clustershell
version: "1.10.1"
license: LGPLv2+
license_treatment: copyleft
maintenance: active
---

# ClusterShell — ClusterShell library and tools

License: copyleft · Maintenance: active · Downloads: 260.8K/mo

## 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 above — verify before relying.

ClusterShell is a Python framework for running commands in parallel across many nodes in a cluster, with tools to manage node groups, aggregate results, and handle distributed execution.

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

pip install clustershell
uv add clustershell
poetry add clustershell

## Installing ClusterShell

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.

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]')

Requires SSH or other remote shell facilities already installed on target systems; designed for Linux/POSIX environments.

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: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 260.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

parallel command execution clusters, distributed task runner nodes, cluster node management, HPC command execution, nodeset operations, clush parallel shell, cluster result aggregation, cluster-management, parallel-execution, hpc

[View on SkillFed](https://skillfed.io/packages/clustershell) · [View on PyPI](https://pypi.org/project/clustershell/)