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

Uploaded Python 3

File details

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

File metadata

  • Download URL: azure_jobs-0.6.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.6.0.tar.gz
Algorithm Hash digest
SHA256 c4bb41b134110e7102b3693723cf7b1bb4b1778afccd21dd3714c002f5690740
MD5 017bdd9c187232e17c0c13bed8284e0d
BLAKE2b-256 a00698cb322fe4c0b3b401bcbdf353c1d8ff64275828b0cda82a30d12c63077a

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: azure_jobs-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 383.6 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d1859ed492d1c43a2fd2b8d9c228c5c6cc9aeb95beac307754b662026a3e70ea
MD5 fadc46748168f77686a67b374d19846e
BLAKE2b-256 6f67d13c012adf139c962b8994f008f2085919fbea49fd97dc89e04fd9d01a3b

See more details on using hashes here.

Provenance

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

This release

0.6.0 This release

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