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 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.1.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.1-py3-none-any.whl (373.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: azure_jobs-0.5.1.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.1.tar.gz
Algorithm Hash digest
SHA256 19691c0cafcd4b78bf3a3f7c4efa3c6ddffa935ee1d0cf67bb84ea437e9597a2
MD5 6f867098c7e2a5b35e6cf5061bbbca4b
BLAKE2b-256 d4c4cf8a352c3c8a0afd6bae006460bf69de8c812e0b64acca1592aa29ef4f19

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: azure_jobs-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 373.5 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f0a5fd6bc6bfe94802d61fa1e4c047249efff0688a04ece852eec2bafc851e73
MD5 fa6c05557ff1ed285df00e251e63c0cf
BLAKE2b-256 e3146d0dc4230a5c50a5ca6649fc298600a1b3cb4b0bb0c633da601d93a1cf05

See more details on using hashes here.

Provenance

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

This release

0.5.1 This release

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