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.4 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.4"
Five distributions provide explicit deployment sizes. The Lab edition is kept outside the default full distribution so public Constella stays lightweight:
| Distribution | Backend/API | Web UI | Lab identity | TUI |
|---|---|---|---|---|
constella-gpu |
Yes | Yes | No | Yes |
constella-gpu-web |
Yes | Yes | No | No |
constella-gpu-lab |
Yes | Lab UI | Yes | No |
constella-gpu-tui |
No | No | No | Yes |
constella-gpu-backend |
Yes | No | 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.4
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.4.tar.gz | 6.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| constella_gpu-0.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 10.1 kB
Release files / constella_gpu-0.1.4.tar.gz
| Download URL | constella_gpu-0.1.4.tar.gz |
|---|---|
| Size | 6.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f85ecc78cf6fe11300c6a03af914d15ff9afe1c4f6dc014722e63e40d2c019c0
|
|
BLAKE2b-256 checksum How to use checksums |
139e7644a89af4d9c5bc1351270d00e3b78735427814b870a80d725c445a0456
|
| 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.4-py3-none-any.whl
| Download URL | constella_gpu-0.1.4-py3-none-any.whl |
|---|---|
| Size | 3.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c2dc9a5453c6a84afb9558b4c89ead36ee32354f6cc6fdf587eaf690b77ad2df
|
|
BLAKE2b-256 checksum How to use checksums |
bb8f87c2b5cee9235ebcb77ed626f0e58bf131df7b42df591e2c73a75d1d2b0d
|
| 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}
|
