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.dev6

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.dev6
File Size Uploaded
hedit-0.7.11.dev6.tar.gz 204.1 kB Details

Built distribution (wheel)

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

Total release size: 366.3 kB

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

Download URL hedit-0.7.11.dev6.tar.gz
Size 204.1 kB
Tags Source
SHA-256 checksum
How to use checksums
5d7b6e90b373af787ae32405a299bb3d6373457b2071577077dbd5433dd93c12
BLAKE2b-256 checksum
How to use checksums
91f043cc03d2f15c07cbc979449d7d98622e334a1c94fd1c9834843d5df6b975
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.dev6-py3-none-any.whl

Download URL hedit-0.7.11.dev6-py3-none-any.whl
Size 162.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f1a1e5058c863aa9633195278907732980adc3ea02a704be4604adce4b313813
BLAKE2b-256 checksum
How to use checksums
aaa322eed207015fae95ccda42e3c9de7a0cb42bd5c2749c7a3c4a3b674ee42b
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.dev6 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