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 alpha of Hy, just use the command pip3 install --pre --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.

• Why Hy?
  • Hy versus Python
  • Hy versus other Lisps
• Tutorial
  • Lisp-stick on a Python
  • Literals
  • Basic operations
  • Functions, classes, and modules
  • Macros
  • Next steps
• Hy Style Guide
  • Layout & Indentation
    • The Three Laws
    • Limits
    • Whitespace
    • Alignment
    • Hold it Open
    • Snuggle
    • Grouping
    • Special Arguments
    • Removing Whitespace
    • Close Bracket, Close Line
    • Comments
  • Coding Style
    • Pythonic Names
    • Threading Macros
    • Method Calls
    • Use More Arguments
    • Imports
    • Underscores
  • Thanks
• Documentation Index
  • Command Line Interface
    • hy
    • hyc
    • hy2py
  • The Hy REPL
    • REPL Built-ins
    • Configuration
  • Hy <-> Python interop
    • Using Python from Hy
    • Using Hy from Python
  • Syntax
    • identifiers
    • numeric literals
    • string literals
    • format strings
    • keywords
    • symbols
    • discard prefix
  • Model Patterns
    • A motivating example
    • Usage
  • Internal Hy Documentation
    • Hy Models
    • Hy Internal Theory
    • Hy Macros
• Cheatsheet
  • Hy
  • Core
  • Extras
  • Contributor
• API
  • Special Forms
  • Hy
  • Core
  • Additional Modules
    • Extra
    • Contributor Modules
• Hacking on Hy
  • Join our Hyve!
  • Hack!
  • Test!
  • Document!
  • Contributor Guidelines
    • Issues
    • Pull requests
  • Contributor Code of Conduct
  • Core Team