gflow
English | 简体中文
gflow is a lightweight scheduler for a single Linux machine. It brings a Slurm-like workflow to shared GPU workstations and lab servers without cluster setup.
Why gflow
- Queue and run jobs on one machine.
- Submit commands or scripts with GPUs, time limits, dependencies, arrays, and priorities.
- Inspect, attach, cancel, and recover jobs with a small CLI.
Install
Requirements: Linux, tmux, and NVIDIA drivers only if you need GPU scheduling.
Install with Python tooling:
uv tool install runqd
# or
pipx install runqd
# or
pip install runqd
Install with Cargo:
cargo install gflow
Nightly build:
pip install --index-url https://test.pypi.org/simple/ runqd
Quick Start
gflowd init
gflowd up
gbatch --gpus 1 --name demo bash -lc 'echo "hello from gflow"; sleep 30'
gqueue
gjob show <job_id>
gflowd down
MCP
gflow can also run as a local MCP server for Claude Desktop, Claude Code, Codex, Cursor, and similar tools:
gflow mcp serve
Keep gflowd running on the same machine. MCP clients start gflow mcp serve as a local stdio server.
Claude Desktop example:
Claude Code:
claude mcp add --scope user gflow -- gflow mcp serve
Codex:
codex mcp add gflow -- gflow mcp serve
Or via ~/.codex/config.toml:
[mcp_servers.gflow]
command = "gflow"
args = ["mcp", "serve"]
If gflow is not on your PATH, replace it with the absolute binary path.
Documentation
Most usage details live in the docs:
Star History
Contact Us
For coordinating contributions and development, please use Slack
Contributing
Please open an Issue or Pull Request.
License
MIT. See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file runqd-0.4.17.tar.gz.
File metadata
- Download URL: runqd-0.4.17.tar.gz
- Upload date:
- Size: 659.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
860171cde57fcb1f2d1914873890cf8e7ff0dd735582c530e92b6db21c709088
|
|
| MD5 |
8f6f2bec6fd4eafd82845ec6e4227e8e
|
|
| BLAKE2b-256 |
dd9d6065859173305156abb88b6741efa190bb93689c35038b8b7fc607933026
|
File details
Details for the file runqd-0.4.17-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: runqd-0.4.17-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 5.4 MB
- Tags: Python 3, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e18ed32c68924927c8fabfb4bab552805f738c41b9eda64d22e7f3a87469fe05
|
|
| MD5 |
400f7fdd11432830724a4e82e972e426
|
|
| BLAKE2b-256 |
07f657ef8cf99b7c47d90606f09602fc39864bb0c0af6263421a6d09485f8305
|
File details
Details for the file runqd-0.4.17-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: runqd-0.4.17-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 5.2 MB
- Tags: Python 3, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cade8de5b5fd119f7e587696457f8e66e8086ef68f108131a0d0f4eea19bcbdd
|
|
| MD5 |
226a2ba2edb2f39233a3b54faf11d1db
|
|
| BLAKE2b-256 |
03125b3da34db4bc391a9c09a9badbc8543b8c5297d6c7e07bb04fd5091363a2
|
File details
Details for the file runqd-0.4.17-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: runqd-0.4.17-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 4.7 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
491d7aae30b7a2d49c776290cd4e6108b56f33dd8559670117dd81fde67e6c27
|
|
| MD5 |
067b0d179f730d1262e4d6427b671fa7
|
|
| BLAKE2b-256 |
754cae1b60dab85e37177b0756b6a842b22c5f77f359fe6824271f2534b0a83e
|
