Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

HEDit

PyPI version Tests

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:

  1. Annotation Agent - Generates initial HED tags
  2. Validation Agent - Checks syntax and tag validity
  3. Evaluation Agent - Assesses faithfulness to input
  4. Assessment Agent - Identifies missing elements

Annotations are automatically refined until validation passes.

Links

License

MIT

Release files for hedit 0.7.11a1

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

Source distribution (sdist)

Source distribution for hedit 0.7.11a1
File Size Uploaded
hedit-0.7.11a1.tar.gz 204.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hedit 0.7.11a1
File Interpreter ABI Platform
hedit-0.7.11a1-py3-none-any.whl Python 3 none any Details

Total release size: 367.2 kB

Release files / hedit-0.7.11a1.tar.gz

Download URL hedit-0.7.11a1.tar.gz
Size 204.9 kB
Tags Source
SHA-256 checksum
How to use checksums
2cd3908c1e467ac5fe92464f4f38bcd59214bcb501bd1fe26fd03d868eba6f98
BLAKE2b-256 checksum
How to use checksums
13d98e1dbbb3d1371bdd2f9f82b1d823575794b51931c1e827442a04e906276f
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

Release files / hedit-0.7.11a1-py3-none-any.whl

Download URL hedit-0.7.11a1-py3-none-any.whl
Size 162.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
75b40a3c2919d4e4e1f7dd7814f1f1bf0d98d44b841e913eff37f81968fb79c9
BLAKE2b-256 checksum
How to use checksums
a47200d1463ff7414aec64352a1d1f056198f36f68f4e5c75a27d91cd1070c04
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

Release history Release notifications | RSS feed

This release

0.7.11a1 This release

2 release files

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