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.

License

MIT

Release files for hedit 0.7.11.dev5

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.11.dev5
File Size Uploaded
hedit-0.7.11.dev5.tar.gz 200.5 kB Details

Built distribution (wheel)

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

Total release size: 360.6 kB

Release files / hedit-0.7.11.dev5.tar.gz

Download URL hedit-0.7.11.dev5.tar.gz
Size 200.5 kB
Tags Source
SHA-256 checksum
How to use checksums
7e29d776856afb71b7d1deb11c5521dbd3f6e952586a6aaee1d8c4eb0bdde35e
BLAKE2b-256 checksum
How to use checksums
2df763b67386f9fb74dfa4a3cd5cc807726fec508bde6e252f22e917ca286dd8
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.11.dev5-py3-none-any.whl

Download URL hedit-0.7.11.dev5-py3-none-any.whl
Size 160.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
da17d3d03032a0a7ce9592d0a7548461518038e8c5ca0d9766ca2fb2a3ca0db3
BLAKE2b-256 checksum
How to use checksums
5d7fbe7d8b27a4500734e6b0dbb675b00aa75012ccbd26f5569dc7f11a6bfd81
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.11.dev5 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