Skip to main content

Hectiq Lab

Track your machine learning experiments in Hectiq Lab: runs, metrics, datasets and models, from Python or the command line.

  • Out of your way. Everything is sent in the background, and an API that is down never crashes your training.
  • Nothing to fill in. Each run records its commit, diff, packages and machine by itself.
  • Built for agents too. Every hlab command prints JSON with --json.
  • A dashboard in your terminal. hlab ui follows your runs live.

The documentation is at docs.hectiq.ai.

Installation

pip install "hectiqlab[cli]"

This gives you the Python package and the hlab command line. Other installs:

pip install hectiqlab                 # the Python package only, e.g. on a training machine
pip install "hectiqlab[tui]"          # adds the dashboard, hlab ui
pip install "hectiqlab[tui,parquet]"  # adds parquet previews in the dashboard

Quickstart

Log in once per machine, with the email and password you use on the web app:

hlab login

Then choose the project this repository records to:

hlab init hectiq-ai/demo

Now record a run:

import hectiqlab as hl

with hl.run("My first run", config={"lr": 1e-3, "epochs": 3}):
    for epoch in hl.each(range(3), "epoch"):
        loss = train_one_epoch()
        hl.add_metric("loss", step=epoch, value=loss)
    hl.models.create("checkpoints/", name="my-model")

The run ends completed, or failed with its traceback if the block raises. Find it in the web app, or with hlab run list.

Command line

hlab run list                   # the project's runs
hlab run get 42                 # one run, by its number
hlab metric get 42 loss         # a metric's values
hlab model download my-model    # a model's files
hlab launch --tag ENG-42 -- python train.py   # record a command, and say how
hlab --help                     # everything else

Add --json to any command to get JSON on stdout.

Dashboard

hlab ui

It opens on your project. Press ? to see the keys.

Settings

Variable What it does
HECTIQLAB_API_KEY Your key, instead of hlab login. Useful where the command line isn't installed.
HECTIQLAB_PROJECT The project, instead of hlab init. You can also pass project= to hl.run.
HECTIQLAB_DISABLE=1 Records nothing. In distributed training, only rank 0 records anyway.

Metadata

Release files for hectiqlab 0.4.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 hectiqlab 0.4.0
File Size Uploaded Provenance Actions
hectiqlab-0.4.0.tar.gz 331.2 kB With provenance Details for hectiqlab-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hectiqlab 0.4.0
File Interpreter ABI Platform Actions
hectiqlab-0.4.0-py3-none-any.whl Python 3 none any Details for hectiqlab-0.4.0-py3-none-any.whl

Total release size: 573.0 kB

Release files / hectiqlab-0.4.0.tar.gz

Download URL hectiqlab-0.4.0.tar.gz
Size 331.2 kB
Tags Source
SHA-256 checksum
How to use checksums
9576f0c3e4814018c07d766d4980a414c1a251024f79476ba339085e1bc3ba7d
BLAKE2b-256 checksum
How to use checksums
f52af72cf53fe00bf74cfdfb5c568f4d726338fbe60a27ac8d1c7257e239d2a5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

Release files / hectiqlab-0.4.0-py3-none-any.whl

Download URL hectiqlab-0.4.0-py3-none-any.whl
Size 241.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
eaa472e6d77f688f488c3e908e6e5c3314a0bccd5447f34b351727726834ca9a
BLAKE2b-256 checksum
How to use checksums
cf5861e26baa952b4ba7da32ea96d9b159fc8d463a5dd5669ee7dde6ee70cc73
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

Security for hectiqlab 0.4.0

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for hectiqlab-0.4.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

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.

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