diff --git a/README.md b/README.md
index 0c045efc..b62fe60a 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,75 @@
-# outlines-core
+<div align="center" style="margin-bottom: 1em;">
+
+<img src="./docs/assets/images/logo.png" alt="Outlines-core Logo" width=500></img>
+
+[![Contributors][contributors-badge]][contributors]
+
+*Structured generation (in Rust).*
+</div>
+
+This package provides the core functionality for structured generation, formerly implemented in [Outlines][outlines], with a focus on performance and portability.
+
+# Install
+
+We provide bindings to the following languages:
+- [Rust][rust-implementation] (Original implementation)
+- [Python][python-bindings]
+
+The latest release of the Python bindings is available on PyPi using `pip`:
+
+``` python
+pip install outlines-core
+```
+
+The current development branch of `outlines-core` can be installed from GitHub, also using `pip`:
+
+``` shell
+pip install git+https://github.com/outlines-dev/outlines-core
+```
+
+# How to contribute?
+
+## Setup
+
+First, fork the repository on GitHub and clone the fork locally:
+
+```bash
+git clone git@github.com/YourUserName/outlines-core.git
+cd outlines-core
+```
+
+Create a new virtual environment:
+
+``` bash
+python -m venv .venv
+source .venv/bin/activate
+```
+
+Then install the dependencies in editable mode, and install the pre-commit hooks:
+
+``` bash
+pip install -e ".[test]"
+pre-commit install
+```
+
+## Before pushing your code
+
+Run the tests:
+
+
+``` bash
+pytest
+```
+
+And run the code style checks:
+
+``` bash
+pre-commit run --all-files
+```
+
+
+[outlines]: https://github.com/dottxt-ai/outlines
+[contributors]: https://github.com/outlines-dev/outlines-core/graphs/contributors
+[contributors-badge]: https://img.shields.io/github/contributors/outlines-dev/outlines-core?style=flat-square&logo=github&logoColor=white&color=ECEFF4
+[rust-implementation]: https://github.com/outlines-dev/outlines-core/tree/readme/src
+[python-bindings]: https://github.com/outlines-dev/outlines-core/tree/readme/python/outlines_core
diff --git a/docs/assets/images/logo.png b/docs/assets/images/logo.png
new file mode 100644
index 00000000..22bc659d
Binary files /dev/null and b/docs/assets/images/logo.png differ
diff --git a/docs/assets/images/logo.svg b/docs/assets/images/logo.svg
new file mode 100644
index 00000000..239310dd
--- /dev/null
+++ b/docs/assets/images/logo.svg
@@ -0,0 +1,247 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="159.56741mm"
+   height="29.131851mm"
+   viewBox="0 0 159.56741 29.131851"
+   version="1.1"
+   id="svg1"
+   xml:space="preserve"
+   inkscape:version="1.3.2 (091e20ef0f, 2023-11-25, custom)"
+   sodipodi:docname="logo.svg"
+   inkscape:export-filename="../../../../../Downloads/logo core.png"
+   inkscape:export-xdpi="160"
+   inkscape:export-ydpi="160"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"><sodipodi:namedview
+     id="namedview1"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:document-units="mm"
+     showguides="true"
+     inkscape:zoom="1.0558135"
+     inkscape:cx="323.92085"
+     inkscape:cy="24.625561"
+     inkscape:window-width="1712"
+     inkscape:window-height="1408"
+     inkscape:window-x="1720"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="layer1"
+     inkscape:export-bgcolor="#ffffffff"><sodipodi:guide
+       position="23.030141,29.424901"
+       orientation="0,-1"
+       id="guide1"
+       inkscape:locked="false" /></sodipodi:namedview><defs
+     id="defs1" /><g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-58.231503,-134.0742)"><g
+       style="fill:#bd932f;fill-opacity:1"
+       id="g1"
+       transform="matrix(0.26458333,0,0,0.26458333,54.067212,133.58109)"><text
+         xml:space="preserve"
+         style="font-size:117.641px;font-family:'PP Neue Montreal Mono';-inkscape-font-specification:'PP Neue Montreal Mono';opacity:0.99;fill:#bd932f;fill-opacity:1;stroke-width:0.612713"
+         x="129.73952"
+         y="83.977005"
+         id="text314"><tspan
+           sodipodi:role="line"
+           id="tspan314"
+           x="129.73952"
+           y="83.977005"
+           style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-family:'PP NeueBit';-inkscape-font-specification:'PP NeueBit Bold';fill:#bd932f;fill-opacity:1;stroke-width:0.612713">outlines-core</tspan></text></g><g
+       id="g27"
+       transform="matrix(0.04161693,0,0,0.04161693,58.231503,134.0742)"
+       style="fill:#bd932f;fill-opacity:1"><rect
+         x="112"
+         y="280"
+         width="56"
+         height="28"
+         id="rect1"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="168"
+         y="308"
+         width="56"
+         height="28"
+         id="rect2"
+         style="fill:#bd932f;fill-opacity:1" /><polygon
+         points="224,476 196,476 196,504 252,504 252,336 224,336 "
+         id="polygon2-6"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="140"
+         y="448"
+         width="56"
+         height="28"
+         id="rect3-2"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="84"
+         y="420"
+         width="56"
+         height="28"
+         id="rect4-9"
+         style="fill:#bd932f;fill-opacity:1" /><polygon
+         points="84,280 112,280 112,252 56,252 56,420 84,420 "
+         id="polygon4"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="420"
+         y="504"
+         width="56"
+         height="28"
+         id="rect5-1"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="364"
+         y="532"
+         width="56"
+         height="28"
+         id="rect6-2"
+         style="fill:#bd932f;fill-opacity:1" /><polygon
+         points="532,112 532,168 560,168 560,447.14 532,447.14 532,475.14 588,476 588,140 560,140 560,112 "
+         id="polygon6"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="56"
+         y="84"
+         width="56"
+         height="28"
+         id="rect7-7"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="56"
+         y="168"
+         width="56"
+         height="28"
+         id="rect8-0"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="112"
+         y="196"
+         width="56"
+         height="28"
+         id="rect9-9"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="168"
+         y="224"
+         width="56"
+         height="28"
+         id="rect10"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="224"
+         y="252"
+         width="56"
+         height="28"
+         id="rect11"
+         style="fill:#bd932f;fill-opacity:1" /><polygon
+         points="56,168 56,112 28,112 28,140 0,140 0,476 56,476 56,448 28,448 28,168 "
+         id="polygon11"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="112"
+         y="504"
+         width="56"
+         height="28"
+         id="rect12"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="168"
+         y="532"
+         width="56"
+         height="28"
+         id="rect13"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="364"
+         y="644"
+         width="56"
+         height="28"
+         id="rect14-3"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="168"
+         y="644"
+         width="56"
+         height="28"
+         id="rect15-6"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="420"
+         y="616"
+         width="56"
+         height="28"
+         id="rect16-0"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="112"
+         y="616"
+         width="56"
+         height="28"
+         id="rect17-6"
+         style="fill:#bd932f;fill-opacity:1" /><polygon
+         points="56,476 56,616 112,616 112,588 84,588 84,504 112,504 112,476 "
+         id="polygon17"
+         style="fill:#bd932f;fill-opacity:1" /><polygon
+         points="532,476 476,476 476,504 504,504 504,588 476,588 476,616 532,616 "
+         id="polygon18"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="224"
+         width="140"
+         height="28"
+         id="rect18-2"
+         y="0"
+         style="fill:#bd932f;fill-opacity:1" /><polygon
+         points="364,560 308,560 308,280 280,280 280,560 224,560 224,588 280,588 280,672 224,672 224,700 364,700 364,672 308,672 308,588 364,588 "
+         id="polygon19-6"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="112"
+         y="56"
+         width="56"
+         height="28"
+         id="rect19-1"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="364"
+         y="28"
+         width="56"
+         height="28"
+         id="rect20-8"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="420"
+         y="56"
+         width="56"
+         height="28"
+         id="rect21-7"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="476"
+         y="84"
+         width="56"
+         height="28"
+         id="rect22-9"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="476"
+         y="168"
+         width="56"
+         height="28"
+         id="rect23-2"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="420"
+         y="196"
+         width="56"
+         height="28"
+         id="rect24-0"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="364"
+         y="224"
+         width="56"
+         height="28"
+         id="rect25-2"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="308"
+         y="252"
+         width="56"
+         height="28"
+         id="rect26-3"
+         style="fill:#bd932f;fill-opacity:1" /><rect
+         x="168"
+         y="28"
+         width="56"
+         height="28"
+         id="rect27-7"
+         style="fill:#bd932f;fill-opacity:1" /></g></g></svg>