Skip to main content

Azure Jobs

aj is a daemon-backed CLI, TUI, and Python SDK for submitting jobs to Azure Machine Learning, native Singularity, and Kubernetes Volcano. Cloud job management applies to AML/Sing workspace jobs; Volcano currently supports submission only.

Azure operations run only in the local daemon. Clients use HTTP over a private Unix domain socket; there is no in-process fallback.

Install

uv tool install azure-jobs
command -v aj || uv tool update-shell
az login
aj auth status

Python 3.10+ is required. Volcano also requires kubectl; aj run --amlt requires amlt.

Optional Agent Skill integration:

aj skill install                 # Copilot, Codex, and Claude Code
aj skill status

Kubernetes/Volcano client setup and task management:

aj k setup                       # `aj k` is short for `aj k8s`
aj k status
aj k jobs

Quickstart

mkdir training && cd training
aj init                         # pull templates, choose workspace, set experiment
aj template list
aj run -t <template> -d python -c "print('hello')"
aj run -t <template> python -c "print('hello')"
aj job list
aj job logs <job-or-aj-id>
aj dash

Use aj ws set plus a hand-written .azure_jobs/template/*.yaml file instead of aj init when no shared template repository is available.

Core features

  • YAML templates with recursive base inheritance and explicit merge rules.
  • Native AML/Sing submission through Azure REST, with one deterministic, content-addressed code archive.
  • Automatic Singularity VC selection from exact hardware requirements and current quota.
  • Volcano submission with PVC/kubectl exec or Blob archive code transfer.
  • Persistent submit queue, job watches, HTTP Range logs, local records, and TUI.
  • OpenAI-style SDK namespaces such as d.job.list() and d.ws(name).ds.list().
  • Managed Agent Skill installation for Copilot, Codex, and Claude Code.
  • Kubernetes OIDC client setup and narrow Volcano job/pod/log management.
  • amlt compatibility through aj run --amlt.

Start with the documentation, especially Getting started and Templates.

Development

uv sync --dev
uv run pytest -q
uv run mkdocs build --strict

See Development and Testing.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

azure_jobs-0.5.0.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

azure_jobs-0.5.0-py3-none-any.whl (371.9 kB view details)

Uploaded Python 3

File details

Details for the file azure_jobs-0.5.0.tar.gz.

File metadata

  • Download URL: azure_jobs-0.5.0.tar.gz
  • Upload date:
  • Size: 1.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for azure_jobs-0.5.0.tar.gz
Algorithm Hash digest
SHA256 2d3a9a86b278a0ddcba06882c14576bf99400de398e2583b940868db8624e070
MD5 fb9ecb98d495f27a8e68bdfcee7756fc
BLAKE2b-256 e446f51a1df2d3660cef61d53c3a3da37c959ecc4e3f6964090b66ce87b00dcc

See more details on using hashes here.

Provenance

The following attestation bundles were made for azure_jobs-0.5.0.tar.gz:

Publisher: release.yml on HSPK/azure_jobs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file azure_jobs-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: azure_jobs-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 371.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for azure_jobs-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 94bf3d306b9c469a093ddc1b0d4a6f84f2382496fcfd9d419c05c6d8907d5726
MD5 91570f424dc3bad88019b2f6303d37a7
BLAKE2b-256 8a09e7315f19f1c701a29213de2c07339f00199ae0e6a71811a08281a3a953d8

See more details on using hashes here.

Provenance

The following attestation bundles were made for azure_jobs-0.5.0-py3-none-any.whl:

Publisher: release.yml on HSPK/azure_jobs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.1

2 files

This release

0.5.0 This release

2 files

0.4.1

2 files

0.4.0

2 files

0.3.5

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

0.1.39

2 files

0.1.38

2 files

0.1.37

2 files

0.1.36

2 files

0.1.35

2 files

0.1.34

2 files

0.1.33

2 files

0.1.32

2 files

0.1.31

2 files

0.1.30

2 files

0.1.29

2 files

0.1.28

2 files

0.1.27

2 files

0.1.26

2 files

0.1.25

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page