Install & Compatibility
Where this runs
tested against v0.0.1a17 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.9
✕ build_error
✕ build_error
113MB installed
● package 113MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
app
✓ from diracx.cli import app
✗ from diracx.cli.main import app
This quickstart demonstrates how a simple command-line application using Typer, similar to how diracx-cli commands are structured, can be defined and run. In a full DiracX environment, these commands would be integrated and executed via the main 'dirac' command-line entry point. This example simulates a basic 'hello' command.
import typer
app = typer.Typer()
@app.command()
def hello(name: str = "World"):
"Say hello to NAME."
print(f"Hello {name}!")
if __name__ == "__main__":
# In a typical DiracX installation, 'dirac' is the entry point
# and would automatically discover and run commands.
# This snippet shows a runnable Typer app as a minimal example.
app()
diracx --version
Debug
Known issues
breakingA recent refactor in diracx-cli renamed 'read_config()' to 'read()'. Code relying on the old method will break.fixUpdate calls from `read_config()` to `read()`.
affects: Likely prior to 0.0.12, confirmed in recent development activity.
gotchaThe DiracX project, including diracx-cli, is described as 'incomplete' and 'rapidly evolving'. This implies frequent changes, potentially including breaking ones, and evolving documentation.fixRefer frequently to the official GitHub repository and documentation for the latest changes and best practices.
affects: All current versions (0.0.12 and earlier).
gotchadiracx-cli is part of the 'diracx' namespace package. This means individual components like 'diracx-core', 'diracx-client', etc., are separate PyPI packages that must be installed independently if their functionality is required, rather than being included with a single 'diracx' installation.fixEnsure all necessary 'diracx-*' packages are installed explicitly via pip based on the required functionality.
affects: All versions.
Upgrade
Version history
0.3.0latest on PyPI · released Jul 7, 2026
Audit
Dependencies
diracx-corerequiredProvides common code and core functionalities for DiracX namespace packages.
typerrequiredUsed for building the command-line interface.