Skip to main content

Features

logis turns your commit history into a searchable scientific log.

Every time you run an experiment, your code will be auto-committed with metadata in the commit message.

Installation

  • uv add logis

Usage

  • Put the @commit decorator on your experiment function.
  • logis will store hyperparameters and metrics as metadata in the commit message.
  • Query your scientific log, e.g. logis query metrics.accuracy < 0.8.
from logis import commit, Run

@commit
def my_experiment(run: Run) -> Metrics:

    # ... experiment stuff

    run.set_hyperparameters({
        "lr": 0.001,
        "epochs": 100,
    })

    # ... more experiment stuff

    run.set_metrics({
        "accuracy": 0.9,
    })

if __name__ == "__main__":
    my_experiment()

# --- Or use the implicit API

@commit(implicit=True)
def other_experiment(hypers: Hypers) -> Metrics:

    # ... experiment stuff

    metrics = Metrics(accuracy=0.9)
    return metrics

if __name__ == "__main__":
    other_experiment(Hypers(...))

Then run your experiment:

$ python experiment.py

Generating commit with message:

    exp: run my_experiment at 2025-02-10 18:39:18.759230

    ---

    {
      "experiment": "my_experiment",
      "hyperparameters": {
        "lr": 0.001,
        "epochs": 100,
      },
      "metrics": {
        "accuracy": 0.9,
      },
      "uuid": "94871de1-4d6c-4e70-9c9d-60ec11df1159",
      "artifacts": null,
      "annotations": null,
      "timestamp": "2025-02-10T18:39:18.759230"
    }

Finally, query for relevant commits:


$ logis query metrics.accuracy > 0.8

Found 1 commit(s):

    af6cd7

Development

  • git clone https://github.com/flywhl/logis.git
  • cd logis
  • uv sync
  • just test

Flywheel

Science needs better software tools. Flywheel is an open source collective building simple tools to preserve scientific momentum, inspired by devtools and devops culture. Join our Discord here.

Metadata

Release files for logis 0.3.1

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

Source distribution (sdist)

Source distribution for logis 0.3.1
File Size Uploaded Provenance Actions
logis-0.3.1.tar.gz 47.6 kB Without provenance Details for logis-0.3.1.tar.gz

Built distribution (wheel)

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

Total release size: 61.1 kB

Release files / logis-0.3.1.tar.gz

Download URL logis-0.3.1.tar.gz
Size 47.6 kB
Tags Source
SHA-256 checksum
How to use checksums
6c5279f53c2c1034aafc97f775d17fdc0e3788a1794244f52aee2aa7319f88d2
BLAKE2b-256 checksum
How to use checksums
9e756776b12178565c484f02b53d70b1af551f673ef3ce16a07fdd8349c8401a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.0

Release files / logis-0.3.1-py3-none-any.whl

Download URL logis-0.3.1-py3-none-any.whl
Size 13.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
160691a3b29b8d9ab07b610a458d48dd91d3ac5b85ad3a8b9020f14124fb4971
BLAKE2b-256 checksum
How to use checksums
3adab42bd387f2020adfe1b296e198a2442004722edd7e78104ee07b09a44a22
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.0

Security for logis 0.3.1

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files No provenance

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