python-chi-edge
CLI for enrolling and managing your own edge devices in the Chameleon testbed.
What this is for
You have a single-board computer (Like a Raspberry Pi 4/5, Nvidia Jetson, ...) and you want to add it to CHI@Edge so that it can be used for Computer Science related Research and Education, by yourself, classmates or coworkers, or the larger Chameleon user community. This tool handles device registration, OS image configuration, and ongoing device management.
You do NOT need this tool to use devices that are already enrolled. If you just want to reserve and run containers on existing CHI@Edge hardware, use the web dashboard or the python-chi SDK.
Prerequisites
- A Chameleon account with an active allocation
- A clouds.yaml or openrc file from the CHI@Edge dashboard
- Python 3.9+
- Physical access to the device you're enrolling
Install
pip install python-chi-edge
Enrollment workflow
1. Register your device
chi-edge device register \
--contact-email you@example.com \
--machine-name raspberrypi5 \
my-device
After this stage, the device will appear with (2/4 checks) passing.
2. Bake the OS image
Download the appropriate balenaOS image for your device, then configure it for the testbed:
chi-edge device bake --image balena.img <device-uuid>
3. Flash and boot
Write the baked image to your device's storage (microSD or eMMC) using balenaEtcher or dd, then power on. The device should appear healthy (4/4 checks) within a few minutes.
Device management
| Command | Description |
|---|---|
chi-edge device list |
List your registered devices |
chi-edge device show <name> |
Show device details and health |
chi-edge device set |
Update device configuration |
chi-edge device delete <name> |
Remove a device |
chi-edge device sync <name> |
Force device re-sync |
Configuration
Uses OpenStack clouds.yaml or environment variables for authentication. Specify the cloud with --os-cloud or set OS_CLOUD.
Documentation
- CHI@Edge enrollment guide — full walkthrough with screenshots
- CHI@Edge user docs — reservations, containers, peripherals
- Chameleon docs — broader platform documentation
License
Apache 2.0
2 maintainers
Metadata
2 maintainers
Release files for python-chi-edge 0.3.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| python_chi_edge-0.3.3.tar.gz | 113.6 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| python_chi_edge-0.3.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 241.7 kB
Release files / python_chi_edge-0.3.3.tar.gz
| Download URL | python_chi_edge-0.3.3.tar.gz |
|---|---|
| Size | 113.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0a879a677f96050875694cb4e7d13f706ff42a4acb01ddea820e5a94f039d74d
|
|
BLAKE2b-256 checksum How to use checksums |
0767895a28e9546ac277fead62268d5ba0a541e40aa59ffed52e037e2cf7ce27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / python_chi_edge-0.3.3-py3-none-any.whl
| Download URL | python_chi_edge-0.3.3-py3-none-any.whl |
|---|---|
| Size | 128.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9f3afbf67c249a6dc9265fa08394b36a752f00bb9814e1a2711b9869439b11b9
|
|
BLAKE2b-256 checksum How to use checksums |
af39bc02dc34ef2efeee00a52b2a68aff444954363c8dc98cf816a7a5ecd17d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for python-chi-edge 0.3.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
