diff --git a/README.md b/README.md
index e58e3580..81919de1 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,29 @@
 # lightspeed-stack
 LLM tooling stack
+
+<!-- vim-markdown-toc GFM -->
+
+* [Prerequisities](#prerequisities)
+* [Installation](#installation)
+* [Configuration](#configuration)
+* [Usage](#usage)
+* [Contributing](#contributing)
+* [License](#license)
+
+<!-- vim-markdown-toc -->
+
+# Prerequisities
+
+* Python 3.11, 3.12, or 3.13
+    - please note that currently Python 3.14 is not officially supported
+    - all sources are made (backward) compatible with Python 3.11; it is checked on CI
+
+# Installation
+
+# Configuration
+
+# Usage
+
+# Contributing
+
+# License