From 1fab3c1a234acf08ff689649f5de5228529f9463 Mon Sep 17 00:00:00 2001
From: zq <zhouquan1511@163.com>
Date: Mon, 3 Aug 2026 15:57:06 +0800
Subject: [PATCH] [docs]: add submodule install troubleshooting

---
 kt-kernel/README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/kt-kernel/README.md b/kt-kernel/README.md
index 24e3cb21c..0a6998544 100644
--- a/kt-kernel/README.md
+++ b/kt-kernel/README.md
@@ -723,6 +723,24 @@ pip install .
 
 ## Error Troubleshooting
 
+### Missing submodule CMakeLists.txt
+
+If CMake reports that `third_party/pybind11` or `third_party/llama.cpp` does not contain a
+`CMakeLists.txt`, the checkout is missing git submodules. Reinitialize them from the repository
+root, then rebuild:
+
+```bash
+git submodule update --init --recursive
+cd kt-kernel
+./install.sh build
+```
+
+When cloning a fresh copy, prefer:
+
+```bash
+git clone --recursive https://github.com/kvcache-ai/ktransformers.git
+```
+
 ### CUDA Not Found
 
 ```