Skip to content

Single-node scheduling for shared machines

Give one Linux machine a real job scheduler

A small CLI and a local daemon to submit, schedule, and inspect GPU or CPU jobs.

  • Single-node by design
  • GPU-aware scheduling
  • tmux-backed execution
  • MCP-ready for agents
Workstation sessiongflowd · 127.0.0.1:5577
$gflowd up
daemon ready on 127.0.0.1:5577
$gbatch --gpus 1 --project vision python train.py
submitted batch job 184
$gqueue
JOBIDNAMESTATEGPUNODE
184trainRUNNING1e40a
$gjob log 184
step=420 loss=0.184 throughput=178 img/s

Why it exists

When one machine is no longer just yours

Ad-hoc tmux and GPU etiquette fall apart once the box is shared.

Without discipline

  • Long jobs collide with interactive work.
  • Failures scatter across logs with no state to recover.
  • GPU rules live in tribal knowledge, not policy.

With gflow

  • One daemon owns state and the queue.
  • Every job is inspectable and recoverable.
  • Resources and dependencies are declared up front.

How it works

Four commands, one controlled run

01gflowd upStart the daemon
02gbatch --gpus 1Submit a job
03gqueueWatch it schedule
04gjob log <id>Follow the run

Capabilities

Built for daily workstation use

Queueing & lifecycle

Submit, hold, cancel, update, and redo jobs.

GPU-aware scheduling

Request GPUs, share them, and cap VRAM.

Workflow composition

Chain dependencies, arrays, and sweeps.

Operational visibility

Read state as table, tree, JSON, CSV, or YAML.

Recoverable execution

Every job runs in its own tmux session.

Automation & AI

Drive the scheduler through a local MCP server.

Where it fits

Where it fits

Shared lab GPU server

Coordinate many researchers on one box.

Solo research machine

Keep long experiments structured and restartable.

Local eval pipelines

Chain prep, train, benchmark, and report.

AI integration

Turn scheduler operations into agent tools

Run gflow as a local stdio MCP server; agent CLIs can inspect queues and drive workflows.

gflow mcp serve
Read the AI guide

Start scheduling the machine you already have

The docs double as an operator's handbook.

Released under the MIT License.