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.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.6.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for whxway from gravatar.com whxway

Credits

Author: HSPK

Requires

Python >=3.10

Report project as malware

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: azure_jobs-0.6.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.6.1.tar.gz
Algorithm Hash digest
SHA256 fa3a49843d8f0c188164230754e8648bc0d5d4b6fd46a64668f24d28365825da
MD5 43e5a566800167188cb50adbc9c9f0a4
BLAKE2b-256 cf6a81b5de411e7cf5251047995d9302c0f397ec33cdf14798e651b779a2069d

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: azure_jobs-0.6.1-py3-none-any.whl
  • Upload date:
  • Size: 377.1 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ae0fcbf15769f75da1c8b799d9e3294c36c4c6c9630aa7039b4376f43e174487
MD5 09f83e2762eb76c83d2651d36e604810
BLAKE2b-256 9ffb998d783210569c122637033f79231da35500bb545d4683e03f8c4510e3f4

See more details on using hashes here.

Provenance

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

This release

0.6.1 This release

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