Hy
==

.. image:: https://img.shields.io/pypi/v/hy.svg
   :target: https://pypi.python.org/pypi/hy
   :alt: Version

.. image:: https://raw.github.com/hylang/shyte/18f6925e08684b0e1f52b2cc2c803989cd62cd91/imgs/xkcd.png
   :target: https://xkcd.com/224/
   :alt: XKCD #224

.. comment
   :title: We lost the documentation on quantum mechanics. You'll have to decode the regexes yourself.

Lisp and Python should love each other. Let's make it happen.

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``.

* `The Hy homepage <http://hylang.org>`__
* `Try Hy with a web console <http://hylang.org/try-hy>`__

Project
-------

* Code: https://github.com/hylang/hy
* Documentation: http://hylang.org/hy/doc
* Bug reports: We have no bugs! Your bugs are your own! (https://github.com/hylang/hy/issues)
* License: MIT (Expat)
* Community: Join us on `Github Discussions <https://github.com/hylang/hy/discussions>`__
* `Stack Overflow: The [hy] tag <https://stackoverflow.com/questions/tagged/hy>`__

Hy's current maintainer is `Kodi Arfer <https://github.com/Kodiologist>`__. He takes responsibility for answering user questions, which should primarily be asked on Stack Overflow or GitHub Discussions, but feel free to `poke him <http://arfer.net/elsewhere>`__ if he's missed a question or you've found a serious security issue.

.. image:: https://i.imgur.com/QbPMXTN.png
   :alt: Cuddles the Hacker

(fan art from the one and only `doctormo <http://doctormo.deviantart.com/art/Cuddles-the-Hacker-372184766>`__)