Skip to content

Latest commit

Β 

History

History
51 lines (34 loc) Β· 2.73 KB

File metadata and controls

51 lines (34 loc) Β· 2.73 KB

Spur

CI E2E Rust License

An AI-native job scheduler written in Rust. Drop-in compatible with Slurm's CLI, REST API, and C FFI while providing WireGuard mesh networking, GPU-first scheduling, and modern state management.

Highlights

  • πŸ”Œ Slurm compatible β€” your existing scripts, tools, and muscle memory work unchanged
  • πŸ”² GPU-first scheduling β€” first-class GPU support for job scheduling
  • πŸ’Ύ Raft-based state β€” all state survives restarts; no external database required
  • βš™οΈ Written in Rust β€” single static binary per component, fast builds, safe concurrency
  • πŸ”’ WireGuard mesh networking β€” tunnelled cluster communication out of the box

Install

curl -fsSL https://raw.githubusercontent.com/ROCm/spur/main/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"

Try it locally. Spin up a single-node cluster to see Spur in action:

spurctld -D --state-dir /tmp/spur-state          # start controller
spurd -D --controller http://localhost:6817      # start agent in a new terminal
spur run -- echo "hello from $(hostname)"        # run a command
spur queue                                       # check the queue

For production and multi-node deployments, see the deployment guide. Sample config and Kubernetes manifests are in examples/.

Documentation

The full documentation covers quickstart, deployment, and development. Whether you're evaluating Spur or running it in production, that's the best place to start.

Getting Help

  • πŸ’¬ Questions & discussions β€” head over to GitHub Discussions. Whether you're stuck, have a suggestion, or just want to chat about how you're using Spur, that's the place.
  • πŸ› Bug reports β€” if you've found a confirmed bug, open an issue with steps to reproduce.

Building & Contributing

See developer/building for build instructions and project layout, and developer/contributing for contribution guidelines. PRs are welcome.

License

Licensed under the Apache License 2.0. See LICENSE for details.