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
@commitdecorator on your experiment function. logiswill 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.gitcd logisuv syncjust 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.