diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cd16619
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Cemantle Solver
+
+An intelligent word-guessing assistant that uses Word2Vec embeddings to solve the Cemantle game efficiently.
+
+## Overview
+
+Cemantle is a word association game where you need to guess a target word based on semantic similarity scores. This solver uses Google News Word2Vec embeddings to find words at specific semantic distances from a given starting word.
+
+## Features
+
+- **Web Interface**: Access the solver at [csolver.cosmoris.fr](https://csolver.cosmoris.fr)
+- **Local CLI**: Run directly with `python cemantle.py <word> <score>`
+- **Docker Support**: Fully containerized for easy deployment
+
+### Docker Deployment
+
+```bash
+docker compose up -d
+```
+
+The service will be available at `http://localhost:8018`
\ No newline at end of file