diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f1e0fa0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+# Eldir
+
+Docker Compose проект для LLM-инференса и мониторинга.
+
+## Сервисы
+
+| Сервис | Описание | Порт |
+|---|---|---|
+| `llama-server` | LLM inference (CUDA) | 8080 |
+| `python+tcl` | GUI приложение (Tkinter/Tcl) | — |
+| `node_exporter` | Метрики для Prometheus | 9100 |
+
+## Запуск
+
+```bash
+docker compose up -d
+```
+
+## Остановка
+
+```bash
+docker compose down
+```
+
+## Стек
+
+- **llama-server** — CUDA, GPU
+- **python+tcl** — X11 forwarding
+- **node_exporter** — Prometheus metrics
+- Образы → Gitea Container Registry
+- CI/CD → Gitea Actions (автобилд при пуше в `docker-tcl/**`)