Skip to content

basilisp-lang/basilisp

Repository files navigation

🐍 basilisp 🐍

A Clojure-compatible(-ish) Lisp dialect targeting Python 3.8+.

PyPI python pyimpl readthedocs CircleCI Run tests Coveralls github license

Getting Started

Basilisp is developed on GitHub and hosted on PyPI. You can fetch Basilisp using pip:

pip install basilisp

Once Basilisp is installed, you can enter into the REPL using:

basilisp repl

Basilisp documentation can help guide your exploration at the REPL. Additionally, Basilisp features many of the same functions and idioms as Clojure, so you may find guides and documentation there helpful for getting started.

Why does this project exist?

Basilisp is a project I (@chrisrink10) created to learn about Python, Clojure, hosted languages, and compilers.

That said, it is generally stable at this point with reasonably high test coverage, linting, and type checking. Work is ongoing to complete the rest of standard the library implementations. I suspect it could be used to build small applications and tools at this point, though I would not recommend it unless you like being a very early adopter.

Use in a production setting at your own risk.

License

Eclipse Public License 1.0