From 26203371247e3f6d8e85f04cdc9ebd29c3bbc2a9 Mon Sep 17 00:00:00 2001
From: Ishan Raj Singh <srajishan21@gmail.com>
Date: Mon, 3 Nov 2025 18:33:47 +0530
Subject: [PATCH] docs: add troubleshooting guide for qrun command not found
 error

- Add solution for issue #1276
- Include Qlib installation steps
- Add data download instructions
---
 docs/troubleshooting.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 docs/troubleshooting.md

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
new file mode 100644
index 000000000..56f0c15ad
--- /dev/null
+++ b/docs/troubleshooting.md
@@ -0,0 +1,23 @@
+## Troubleshooting
+
+### Error: "failed to run command 'qrun': No such file or directory"
+
+**Cause**: Qlib dependency is not properly installed.
+
+**Solution**:
+1. Install Qlib from source:
+pip install numpy
+pip install --upgrade cython
+git clone https://github.com/microsoft/qlib.git
+cd qlib
+pip install .
+
+text
+
+2. Verify installation:
+which qrun
+
+text
+
+3. Download Qlib data:
+python scripts/get_data.py qlib_data --target_dir ~/.qlib/qlib_data/cn_data --region cn
\ No newline at end of file