Skip to main content

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/

Metadata

Release files for lablink-cli 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lablink-cli 0.3.0
File Size Uploaded
lablink_cli-0.3.0.tar.gz 226.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for lablink-cli 0.3.0
File Interpreter ABI Platform
lablink_cli-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 364.1 kB

Release history Release notifications | RSS feed

0.4.0

2 release files

This release

0.3.0 This release

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page