{"id":27050,"library":"hy","title":"Hy","description":"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.","status":"active","version":"1.2.0","language":"python","source_language":"en","source_url":"https://github.com/hylang/hy","tags":["lisp","dialect","embedded","macro"],"install":[{"cmd":"pip install hy","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Many utilities moved here in 0.24.0+","package":"hyrule","optional":true}],"imports":[{"note":"Do not import internals directly; use top-level hy functions.","wrong":"from hy.core import ...","symbol":"hy.core","correct":"import hy.core"}],"quickstart":{"code":"import hy\nprint(hy.mangle('foo?'))  # hyx_fooXquestion_markX\n","lang":"python","description":"Basic example showing Hy's mangle function."},"warnings":[{"fix":"Upgrade to Python 3.9+ and Hy 1.0.0+","message":"Python 3.8 support was dropped in Hy 1.0.0.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Replace `(defn/a f [] ...)` with `(defn :async f [] ...)`.","message":"`defn/a`, `fn/a`, `with/a`, `yield-from` were removed in 0.29.0; use `:async` syntax instead.","severity":"breaking","affected_versions":"<0.29.0"},{"fix":"Use `import dis; dis.dis(...)` on the compiled code.","message":"`hy.disassemble` removed in 0.29.0.","severity":"deprecated","affected_versions":"<0.29.0"},{"fix":"Use `(except [] ...)` to catch all exceptions.","message":"`(except [[]] ...)` catches no exceptions, not all exceptions like `(except [] ...)`. Changed in 1.1.0.","severity":"gotcha","affected_versions":">=1.1.0"},{"fix":"Add space after `#*`: `#* foo`.","message":"Reader macros now always read a full identifier after `#`. `#*foo` is now a reader macro call, not unpacking.","severity":"breaking","affected_versions":">=0.27.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install hy`.","cause":"Hy is not installed.","error":"ModuleNotFoundError: No module named 'hy'"},{"fix":"Use `import hy` and access via `hy.core` attribute if needed, but prefer public API.","cause":"Importing from hy.core directly is not allowed.","error":"ImportError: cannot import name 'hy.core' from 'hy'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}