The Hy Manual

PyPI

https://pypi.python.org/pypi/hy

Source

https://github.com/hylang/hy

Discussions

https://github.com/hylang/hy/discussions

Stack Overflow

The [hy] tag

Hy is a Lisp dialect that’s embedded in Python. Since Hy transforms its Lisp code into Python abstract syntax tree (AST) objects, you have the whole beautiful world of Python at your fingertips, in Lisp form.

To install the latest release of Hy, just use the command pip3 install --user hy. Then you can start an interactive read-eval-print loop (REPL) with the command hy, or run a Hy program with hy myprogram.hy.

Hy is tested on all released and currently maintained versions of CPython (on Linux and Windows), and on recent versions of PyPy and Pyodide.

• Why Hy?
  • Hy versus Python
  • Hy versus other Lisps
• Tutorial
  • Lisp-stick on a Python
  • Literals
  • Basic operations
  • Functions, classes, and modules
  • Macros
  • Hyrule
  • Next steps
• Syntax
  • An introduction to models
  • Non-form syntactic elements
    • Shebang
    • Whitespace
    • Comments
    • Discard prefix
  • Identifiers
    • Numeric literals
    • Keywords
    • Dotted identifiers
    • Symbols
    • Mangling
  • String literals
    • Bracket strings
  • Sequential forms
    • Expressions
    • List, tuple, and set literals
    • Dictionary literals
    • Format strings
  • Additional sugar
  • Reader macros
• Semantics
  • Implicit names
  • Order of evaluation
  • When bytecode is regenerated
• Macros
  • Using gensym for Safer Macros
• The Hy REPL
  • Output functions
  • Special variables
  • Startup files
• Environment Variables
• Command-Line Interface
  • hy
  • hy2py
  • hyc
• Python Interoperability
  • Using Python from Hy
  • Using Hy from Python
  • Libraries that expect Python
• Model Patterns
  • A motivating example
  • Usage
• Cheatsheet
  • Hy
  • Core
• API
  • Core Macros
    • Placeholder macros
  • Hy
  • Reader Macros
  • Python Operators
  • Reserved
• Hacking on Hy
  • Join our Hyve!
  • Hack!
  • Test!
  • Document!
  • Contributor Guidelines
    • Issues
    • Pull requests
  • Contributor Code of Conduct
  • Core Team