https://github.com/rocm/spur

spur your compute
https://github.com/rocm/spur

Last synced: 4 days ago
JSON representation

spur your compute

• Host: GitHub
• URL: https://github.com/rocm/spur
• Owner: ROCm
• License: apache-2.0
• Created: 2026-03-17T07:45:02.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-06-29T08:31:42.000Z (10 days ago)
• Last Synced: 2026-06-29T10:22:00.237Z (10 days ago)
• Language: Rust
• Homepage:
• Size: 2.21 MB
• Stars: 53
• Watchers: 2
• Forks: 17
• Open Issues: 48
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# Spur

[![CI](https://github.com/ROCm/spur/actions/workflows/ci.yml/badge.svg)](https://github.com/ROCm/spur/actions/workflows/ci.yml)

[![E2E](https://github.com/ROCm/spur/actions/workflows/e2e.yml/badge.svg)](https://github.com/ROCm/spur/actions/workflows/e2e.yml)

[![Rust](https://img.shields.io/badge/dynamic/toml?url=https://raw.githubusercontent.com/ROCm/spur/main/rust-toolchain.toml&query=toolchain.channel&label=rust&color=orange)](https://www.rust-lang.org)

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](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

```bash

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:

```bash

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](docs/deployment/native-host.rst). Sample config and Kubernetes manifests are in [`examples/`](examples/).

## Documentation

The [full documentation](docs/index.rst) 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](https://github.com/ROCm/spur/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](https://github.com/ROCm/spur/issues) with steps to reproduce.

## Building & Contributing

See [developer/building](docs/developer/building.rst) for build instructions and project layout, and [developer/contributing](docs/developer/contributing.rst) for contribution guidelines. PRs are welcome.

## License

Licensed under the Apache License 2.0. See [LICENSE](LICENSE) for details.