Skip to content

Releases: CactysFedya/expctl

expctl 0.3.0

Choose a tag to compare

@github-actions github-actions released this 23 Jul 12:45

expctl 0.3.0 — experiment navigation and portability

0.3.0 expands the universal core without adding domain-specific assumptions.

Highlights

  • Git-inspired history trees with expctl log --graph.
  • Multi-run comparison through arbitrary metrics and typed fields.
  • Manual or metric-based BEST run selection.
  • Built-in references: CURRENT_EXP, LATEST, FAILED, and BEST.
  • User-defined aliases for experiments, runs, and changes.
  • Free-form tags on EXP, RUN, and CHG records.
  • Typed custom fields: string, number, integer, boolean, datetime, path, and JSON, with optional units.
  • Timestamped observations through expctl note.
  • Minimal next actions through expctl next without becoming a project-management system.
  • Portable experiment ZIP export/import, optionally including stored artifacts.
  • Automatic migration of 0.2.0 databases to schema version 3.
  • Nine integration and example tests.

Compatibility

The CLI remains alpha software. Version 0.3.0 automatically migrates projects created by 0.2.0. Back up .expctl/expctl.db before upgrading important projects.

expctl 0.2.0

Choose a tag to compare

@CactysFedya CactysFedya released this 23 Jul 11:35

expctl 0.2.0 — universal experiment lifecycle tracking

This is the first public alpha release of the universal expctl design.

Highlights

  • Local-first SQLite registry with human-readable JSON and Markdown records.
  • Experiments can contain multiple immutable runs.
  • Automatic process status tracking from exit codes.
  • Required-file and required-metric validation to distinguish completed from incomplete.
  • Git-aware snapshots, patches, commits, fixes, and retry linkage.
  • Git remains optional for manual and hardware experiments.
  • Generic change categories for code, config, parameters, data, environment, hardware, and procedure.
  • Metrics with optional units and arbitrary file or directory artifacts.
  • Manual experiment sessions without a child command.
  • Recovery of stale running records after interrupted processes.
  • End-to-end demo and integration tests.

Important status

This is alpha software. The data model and CLI may change before 1.0.0, and automatic migration from the 0.1.0 prototype database is not included.

Installation

pipx install git+https://github.com/CactysFedya/expctl.git@v0.2.0

After PyPI publication:

pipx install expctl