Add conversation layer services and compose setup

README.md

@@ -1 +1,20 @@
-# conversation-layer
+# Conversation Layer
+
+This module contains the services that handle messaging for WhatsApp and the web chat interface. It is composed of three containers:
+
+- **openwa** – provides access to WhatsApp through the [open-wa](https://github.com/open-wa/wa-automate-nodejs) project.
+- **whatsapp-router** – receives webhook events from openwa and forwards messages to an external LLM agent.
+- **chat-ui** – simple web chat interface that also communicates with the LLM agent.
+
+All services can be launched together with `docker-compose`.
+
+## Usage
+
+1. Configure the URL of your LLM agent in `docker-compose.yml` (`LLM_AGENT_URL`).
+2. Run:
+
+```bash
+docker-compose up --build
+```
+
+The chat UI will be available on [http://localhost:3000](http://localhost:3000). Open-wa exposes its API on port `8080` and the WhatsApp router listens on port `3001`.