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 install                     # one-time kubectl/Krew/OIDC installation
aj k login                       # kubeconfig merge + OIDC authentication
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 -n 1 -p 1 python -c "print('hello')"
aj run -t <template> -n 1 -p 1 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.6.2.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.6.2-py3-none-any.whl (377.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: azure_jobs-0.6.2.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.6.2.tar.gz
Algorithm Hash digest
SHA256 6bfb892bde414ad18a68919a517acc16105620517cd128e44f06174cdb538f1d
MD5 8bd4ba6b653582a113aa06f33a374c03
BLAKE2b-256 5abc53476bef049fc8351970f44ac19455e5a0271ce0157988eed07d36b932da

See more details on using hashes here.

Provenance

The following attestation bundles were made for azure_jobs-0.6.2.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.6.2-py3-none-any.whl.

File metadata

  • Download URL: azure_jobs-0.6.2-py3-none-any.whl
  • Upload date:
  • Size: 377.7 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.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0cd6127d75b885932382d4b04b14c56ead897b1c43dfadc91dcc2224a1f2dc38
MD5 913d21e213fb4b86d332ba9d1a1bd2d9
BLAKE2b-256 2fd45ddc27c11b4de5332eb53f591bd83d8867d7fc73b025a01b259369378eff

See more details on using hashes here.

Provenance

The following attestation bundles were made for azure_jobs-0.6.2-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

This release

0.6.2 This release

2 files

0.6.1

2 files

0.6.0

2 files

0.5.1

2 files

0.5.0

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