dist-cli

Distributed multi-node command execution tool based on MPI for unified command scheduling across nodes.

中文 README

Quick Install

curl -fsSL https://github.com/pengyanai/dist-cli/-/raw/main/install.sh | bash

Usage

# Basic usage
dist "hostname"

# Example: Kill python processes on all nodes
dist "pkill -f python"

# Check GPU status on all nodes
dist "nvidia-smi"

# Create directory on all nodes
dist "mkdir -p /data/experiments"

see usage.md for more examples.

Configuration

Default config location: ~/.config/dist/dist.conf

# Custom hostfile path
export DIST_HOSTFILE=/path/to/hostfile

# Number of processes per node
export DIST_NPERNODE=1

# Network interface
export DIST_INTERFACE=eth0

Uninstall

curl -fsSL https://github.com/pengyanai/dist-cli/-/raw/main/uninstall.sh | bash

Requirements

• MPI (OpenMPI or MPICH)
• SSH key-based authentication configured
• Accessible hostfile on all nodes