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.11.dev10

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

Built distribution (wheel)

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

Total release size: 368.7 kB

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

Download URL hedit-0.7.11.dev10.tar.gz
Size 205.7 kB
Tags Source
SHA-256 checksum
How to use checksums
8b61f7b61506acb292d2e1233a3f0839dd9f85856f5441b89465c61599e2d95c
BLAKE2b-256 checksum
How to use checksums
d63382f7f71ba7cde3b0e6ddf8767e6470f91c813c99df924e7960786aaf6077
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 Sep 1, 2026.

Transparency log

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

Download URL hedit-0.7.11.dev10-py3-none-any.whl
Size 163.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
07a5e3b44ce05fd2231daf8cd8e9bab78adcf964bb863f2c73417421f115c5b5
BLAKE2b-256 checksum
How to use checksums
3feaf8e7fbee8cbe0089858a8cac43884cbf968a486b583d641af40896040e74
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 Sep 1, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.7.11.dev10 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