This release is a pre-release and may not be stable for production use.
HEDit
Convert natural language event descriptions into valid HED (Hierarchical Event Descriptors) annotations.
Part of the Annotation Garden Initiative.
Installation
# Default (lightweight API client, ~100MB)
pip install hedit
# Standalone mode (run locally without backend, ~2GB)
pip install hedit[standalone]
Quick Start
# Initialize the CLI (API mode needs no key; add an Anthropic key for BYOK)
hedit init
# Generate HED annotation from text
hedit annotate "participant pressed the left button"
# Generate HED from an image
hedit annotate-image stimulus.png
# Validate a HED string
hedit validate "Sensory-event, Visual-presentation"
Commands
| Command | Description |
|---|---|
hedit init |
Configure API key and preferences |
hedit annotate "text" |
Convert natural language to HED |
hedit annotate-image <file> |
Generate HED from image |
hedit validate "HED-string" |
Validate HED annotation |
hedit health |
Check service status |
hedit config show |
Display configuration |
Options
hedit annotate "text" -o json # JSON output for scripting
hedit annotate "text" --schema 8.3.0 # Specific HED schema version
hedit annotate "text" --standalone # Run locally (requires hedit[standalone])
How It Works
HEDit uses a multi-agent system (LangGraph) with feedback loops:
- Annotation Agent - Generates initial HED tags
- Validation Agent - Checks syntax and tag validity
- Evaluation Agent - Assesses faithfulness to input
- Assessment Agent - Identifies missing elements
Annotations are automatically refined until validation passes.
Links
License
MIT
1 maintainer
Release files for hedit 0.7.11.dev7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hedit-0.7.11.dev7.tar.gz | 205.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hedit-0.7.11.dev7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 367.4 kB
Release files / hedit-0.7.11.dev7.tar.gz
| Download URL | hedit-0.7.11.dev7.tar.gz |
|---|---|
| Size | 205.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
da6c471718b1029c190d3fb664c3037fcbc41c5f6021d6563cd12506a91ba681
|
|
BLAKE2b-256 checksum How to use checksums |
95528bc0bc9ca0b7a1b682d2b98a7c56d7b90bf23fd1723f7b14c0ea4658bd29
|
| 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 Aug 21, 2026.
Transparency logRelease files / hedit-0.7.11.dev7-py3-none-any.whl
| Download URL | hedit-0.7.11.dev7-py3-none-any.whl |
|---|---|
| Size | 162.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
62b2832e553f9e92fd8184a638c1da9291760ed11260e25114a0eec8e373f165
|
|
BLAKE2b-256 checksum How to use checksums |
c6d6714e5df7bf598b2eea15b12c1ea158353ad61bef00c750d5f832750840de
|
| 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 Aug 21, 2026.
Transparency log
