This release is a pre-release and may not be stable for production use.
Constella
constella-gpu is the complete Constella distribution: backend services, the
production Web interface, and the keyboard-first Textual TUI.
Constella is a lightweight accelerator monitoring and workload history platform for standalone servers and small heterogeneous clusters. It shows current accelerator activity in realtime, records workload history automatically, and makes completed training and inference jobs easy to review without requiring a Prometheus/Grafana stack.
Version 0.1.3rc1 supports:
- NVIDIA GPUs: NVML with an
nvidia-smifallback. - Ascend NPUs: DCMI with an
npu-smifallback.
Install
Constella requires Python 3.10 or newer.
pip install "constella-gpu==0.1.3rc1"
Four distributions provide explicit deployment sizes:
| Distribution | Backend/API | Web UI | TUI |
|---|---|---|---|
constella-gpu |
Yes | Yes | Yes |
constella-gpu-web |
Yes | Yes | No |
constella-gpu-tui |
No | No | Yes |
constella-gpu-backend |
Yes | No | No |
Quick start
Start the manager, SQLite history, and a local NVIDIA agent:
constella service start \
--run-dir ~/.constella/run \
--log-dir ~/.constella/logs
On an Ascend host, add --device ascend.
Use the terminal interface:
constella tui
# equivalent standalone entry point
constella-tui
Or open http://127.0.0.1:8765/overview in a browser.
Inspect or stop the managed processes with the same runtime directory:
constella service status --run-dir ~/.constella/run --log-dir ~/.constella/logs
constella service stop --run-dir ~/.constella/run --log-dir ~/.constella/logs
Constella binds to 127.0.0.1 by default. Keep that default for local access,
or use SSH port forwarding when the service runs on a remote host.
Common commands
constella probe --pretty
constella probe --device ascend --pretty
constella serve --host 127.0.0.1 --port 8765
constella service start --no-local-agent
constella cluster start --nodes nodes.yaml
constella cluster status --nodes nodes.yaml
constella cluster stop --nodes nodes.yaml
SQLite history is enabled by default. Use constella service start --no-db for
realtime-only operation, or constella service start --highres-sidecar to run
the optional high-resolution job-curve sidecar.
Project links
1 maintainer
Metadata
1 maintainer
Release files for constella-gpu 0.1.3rc1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| constella_gpu-0.1.3rc1.tar.gz | 4.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| constella_gpu-0.1.3rc1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.4 kB
Release files / constella_gpu-0.1.3rc1.tar.gz
| Download URL | constella_gpu-0.1.3rc1.tar.gz |
|---|---|
| Size | 4.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e2446d0c412862496add261d274b06028993d23d79c78f2f8867a1dcf02805ba
|
|
BLAKE2b-256 checksum How to use checksums |
b2eda7a4820244efe05c8c6ee960175eb296188a5a7fa2030ed0ea5800652808
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / constella_gpu-0.1.3rc1-py3-none-any.whl
| Download URL | constella_gpu-0.1.3rc1-py3-none-any.whl |
|---|---|
| Size | 3.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f4ff7bf7042e29364aed7bd8535413a281abb3007681944c99e7456070bcdc82
|
|
BLAKE2b-256 checksum How to use checksums |
ef0ce3b9b03c1d819cb4a2f20b317c4d7d8d4ff6fb1f3f64ca70f20922af956c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
