hy

library1.2.0pypypi✓ verified 83d ago

A Lisp dialect embedded in Python. Current version 1.2.0, supports Python 3.9-3.14. Release cadence is irregular, with breaking changes common between major versions.

data web-framework

pip install hy

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · HY

datapythonv1.2.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

hy.core

✓ import hy.core

✗ from hy.core import ...

Do not import internals directly; use top-level hy functions.

Basic example showing Hy's mangle function.

import hy print(hy.mangle('foo?')) # hyx_fooXquestion_markX

hy --version

Debug

Known issues

breakingPython 3.8 support was dropped in Hy 1.0.0.

fix

Upgrade to Python 3.9+ and Hy 1.0.0+

affects: <1.0.0

breaking`defn/a`, `fn/a`, `with/a`, `yield-from` were removed in 0.29.0; use `:async` syntax instead.

fix

Replace `(defn/a f [] ...)` with `(defn :async f [] ...)`.

affects: <0.29.0

deprecated`hy.disassemble` removed in 0.29.0.

fix

Use `import dis; dis.dis(...)` on the compiled code.

affects: <0.29.0

gotcha`(except [[]] ...)` catches no exceptions, not all exceptions like `(except [] ...)`. Changed in 1.1.0.

fix

Use `(except [] ...)` to catch all exceptions.

affects: >=1.1.0

breakingReader macros now always read a full identifier after `#`. `#*foo` is now a reader macro call, not unpacking.

fix

Add space after `#*`: `#* foo`.

affects: >=0.27.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'hy'

Hy is not installed.

fix

Run `pip install hy`.

ImportError: cannot import name 'hy.core' from 'hy'

Importing from hy.core directly is not allowed.

fix

Use `import hy` and access via `hy.core` attribute if needed, but prefer public API.

Upgrade

Version history

1.2.0latest on PyPI · released Jan 14, 2026

Audit

Dependencies

hyruleoptionalMany utilities moved here in 0.24.0+

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/hylang/hy ↗

packagehttps://pypi.org/project/hy/ ↗

homepagehttp://hylang.org/ ↗

docshttp://hylang.org/hy/doc ↗