Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

LabLink CLI

Command-line tool for deploying and managing LabLink teaching lab infrastructure — on AWS (EC2 via Terraform) or on a machine you already have (provider: manual, deployed with docker-compose).

Installation

This package is not yet published to PyPI. Install it from source — the repo is a uv workspace, so sync all three packages into the shared root venv:

git clone https://github.com/talmolab/lablink.git
cd lablink
uv sync --all-packages

Usage

lablink --help
lablink --version   # or -v

Commands

Command Description
configure Create or edit LabLink configuration (interactive TUI)
setup Provision provider-specific bootstrap resources (AWS: S3 + DynamoDB for Terraform state)
doctor Check prerequisites and configuration
deploy Deploy LabLink infrastructure (AWS Terraform or docker-compose)
destroy Tear down LabLink infrastructure
status Show deployment health and inventory
logs View allocator and client logs
export-metrics Export deployment metrics to CSV or JSON
stats Show a cohort session-metrics summary in the terminal
cleanup Remove deployment resources and local state
show-config View the current LabLink configuration
cache-clear Clear LabLink caches (Terraform templates, deployment metrics)

Client fleet commands

Command Description
client launch Launch client VMs via the allocator service (AWS provider)
client register Register this bring-your-own box as a manual client and run the client container
client unregister Tear down a registered BYO box
client reset-overlay Discard this box's persisted mesh-overlay node identity

Run lablink <command> --help for details on any command.

Documentation

Full CLI documentation: https://talmolab.github.io/lablink/cli/

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lablink_cli-0.1.0a1.tar.gz (223.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lablink_cli-0.1.0a1-py3-none-any.whl (134.8 kB view details)

Uploaded Python 3

Release history Release notifications | RSS feed

0.1.0

2 files

This release

0.1.0a1 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page