Skip to main content

Hunch logo

Hunch

Every hunch, tracked.

CI status PyPI version Python 3.11 or newer No dependencies License: Apache-2.0

hunch run, then hunch log showing a tree of runs

Every run keeps its code, config, environment, metrics and why, and knows which run it came from.

pip install sigmoid-hunch

If you know git, you know Hunch

git hunch
git commit -m "why" hunch run -m "why" -- python train.py
git log hunch log
git log --oneline hunch log --oneline
git show a7f3 hunch show a7f3
git diff 9b40 a7f3 hunch diff 9b40 a7f3
git notes add hunch note a7f3 "helps" --keep
git tag -a v1 -m "..." hunch milestone "warmup beats baseline"
git config hunch config main-metric val_loss

How is it different from git? Git tracks what you changed. Hunch tracks what you tried, and what happened. Run the same code 20 times with different learning rates: git sees one commit, Hunch sees 20 experiments with their results.

In your code

import hunch

hunch.init(config=args, why="warmup to fix loss spikes")
hunch.log({"val_loss": val_loss}, step=step)

Same names as W&B: import hunch as wandb works.

Your disk, your files

No server, no account, no telemetry, no dependencies, and git is optional. Runs are plain files in .hunch/.

Guide · File format · Questions · Contributing

Share it

Saved you a "what did I run last month?" moment? Tell one person, or post your hunch log in Show and tell.

Share on X Share on Reddit Share on Hacker News Share on LinkedIn

Tracking a research repo with Hunch? Show it: tracked with Hunch

[![tracked with Hunch](https://img.shields.io/badge/tracked_with-hunch-6E56CF?style=flat-square)](https://github.com/sigmoid-ide/hunch)

Team

rainxchzed
rainxchzed
Creator

Apache-2.0 · Part of Sigmoid IDE · Like it? Give it a star.

Metadata

Release files for sigmoid-hunch 0.3.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 sigmoid-hunch 0.3.0
File Size Uploaded Provenance Actions
sigmoid_hunch-0.3.0.tar.gz 33.8 kB Without provenance Details for sigmoid_hunch-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sigmoid-hunch 0.3.0
File Interpreter ABI Platform Actions
sigmoid_hunch-0.3.0-py3-none-any.whl Python 3 none any Details for sigmoid_hunch-0.3.0-py3-none-any.whl

Total release size: 73.0 kB

Release files / sigmoid_hunch-0.3.0.tar.gz

Download URL sigmoid_hunch-0.3.0.tar.gz
Size 33.8 kB
Tags Source
SHA-256 checksum
How to use checksums
57c69f0fdbf2441dd73e4cc0416ae2c52ea9e19ba847f29b29441d1db7e188ff
BLAKE2b-256 checksum
How to use checksums
aba021a589470938a0cabb73d701c962c8ea40f41958cebe36051bca8f17f9db
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / sigmoid_hunch-0.3.0-py3-none-any.whl

Download URL sigmoid_hunch-0.3.0-py3-none-any.whl
Size 39.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
07174bc5da7648c80e7296ba53c24e211278b79b92f660a161549b29bd36716a
BLAKE2b-256 checksum
How to use checksums
64e72630a0559d8e1bd5de8e3e5a708d872ecad7d4cdc24892e835d2f314f35d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for sigmoid-hunch 0.3.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.

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.

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