themelio-cli 0.1.0

Command-line client for the Themelio ML platform

themelio CLI

A Hugging Face–style command-line client for the Themelio ML platform. It talks to the Themelio web service HTTP API for metadata and orchestration, and hands repository content transfer off to your own git / git-lfs.

See plans/themelio-cli/SPEC.md, ADR-0021, and DD-0021 for the full design.

Install

# Python users
pipx install themelio-cli        # or: uvx themelio

# Zero-prerequisite (standalone binary)
curl -LsSf https://dev.themelio.pharos.grnet.gr/cli/install.sh | sh

Quick start

themelio auth login                       # paste an api-scoped PAT
themelio git-setup --apply                # configure the git credential helper
themelio models ls                        # list models
themelio models alice/bert info           # inspect a repo
themelio models alice/bert download       # prints the git clone command
themelio models alice/bert actions run train --follow
themelio models alice/bert jobs ls        # observe compute

Command grammar

Repo-scoped commands read themelio <type> <ns/repo> <verb>, e.g. themelio models alice/bert info. Resource types: models, datasets, spaces, repos. Compute-bearing types (models, spaces, repos) additionally carry actions, jobs, and deployments subgroups.

Configuration

Precedence (highest first): --host/--token flags → THEMELIO_HOST/THEMELIO_TOKEN env → ~/.themelio/config (or OS keyring) → default host https://dev.themelio.pharos.grnet.gr.

Development

pip install -e '.[dev]'
ruff check . && mypy && pytest