Zhenting Gao Yingfeng commited on
Commit
318a7e5
·
1 Parent(s): 66012be

Add an entry in Debugging section (#481)

Browse files

### What problem does this PR solve?

_Add an entry in Debugging section._

### Type of change

- [x] Documentation Update

---------

Co-authored-by: Yingfeng <[email protected]>

Files changed (1) hide show
  1. docs/faq.md +12 -4
docs/faq.md CHANGED
@@ -78,7 +78,16 @@ docker build -t infiniflow/ragflow:v0.3.0 . --network host
78
 
79
  ### 2. Issues with huggingface models.
80
 
81
- #### 2.1. `MaxRetryError: HTTPSConnectionPool(host='hf-mirror.com', port=443)`
 
 
 
 
 
 
 
 
 
82
 
83
  This error suggests that you do not have Internet access or are unable to connect to hf-mirror.com. Try the following:
84
 
@@ -88,7 +97,7 @@ This error suggests that you do not have Internet access or are unable to connec
88
  - ~/deepdoc:/ragflow/rag/res/deepdoc
89
  ```
90
 
91
- #### 2.2 `FileNotFoundError: [Errno 2] No such file or directory: '/root/.cache/huggingface/hub/models--InfiniFlow--deepdoc/snapshots/FileNotFoundError: [Errno 2] No such file or directory: '/ragflow/rag/res/deepdoc/ocr.res'be0c1e50eef6047b412d1800aa89aba4d275f997/ocr.res'`
92
 
93
  1. Check your network from within Docker, for example:
94
  ```bash
@@ -165,7 +174,7 @@ If your RAGFlow is deployed *locally*, try the following:
165
  ```bash
166
  docker logs -f ragflow-server
167
  ```
168
- 2. Check if the **tast_executor.py** process exist.
169
  3. Check if your RAGFlow server can access hf-mirror.com or huggingface.com.
170
 
171
 
@@ -304,7 +313,6 @@ You limit what the system responds to what you specify in **Empty response** if
304
 
305
  ![](https://github.com/infiniflow/ragflow/assets/93570324/8cfb6fa4-8a97-415d-b9fa-b6f405a055f3)
306
 
307
-
308
  ### 4. How to run RAGFlow with a locally deployed LLM?
309
 
310
  You can use Ollama to deploy local LLM. See [here](https://github.com/infiniflow/ragflow/blob/main/docs/ollama.md) for more information.
 
78
 
79
  ### 2. Issues with huggingface models.
80
 
81
+ #### 2.1 If https://huggingface.co can not be accessed
82
+ - If RAGflow is installed by docker, it will automatically download the OCR and embedding modules from Huggingface website (https://huggingface.co).
83
+ - If your computer can not access https://huggingface.co, such error will appear and PDF file parsing will fail
84
+ - FileNotFoundError: [Errno 2] No such file or directory: '/root/.cache/huggingface/hub/models--InfiniFlow--deepdoc/snapshots/be0c1e50eef6047b412d1800aa89aba4d275f997/ocr.res'
85
+ - if your computer can access https://hf-mirror.com
86
+ - cd ragflow-0.3.0/docker/; docker compose down
87
+ - replace https://huggingface.co with https://hf-mirror.com in the ragflow-0.3.0/docker/docker-compose.yml
88
+ - docker compose up -d
89
+
90
+ #### 2.2. `MaxRetryError: HTTPSConnectionPool(host='hf-mirror.com', port=443)`
91
 
92
  This error suggests that you do not have Internet access or are unable to connect to hf-mirror.com. Try the following:
93
 
 
97
  - ~/deepdoc:/ragflow/rag/res/deepdoc
98
  ```
99
 
100
+ #### 2.3 `FileNotFoundError: [Errno 2] No such file or directory: '/root/.cache/huggingface/hub/models--InfiniFlow--deepdoc/snapshots/FileNotFoundError: [Errno 2] No such file or directory: '/ragflow/rag/res/deepdoc/ocr.res'be0c1e50eef6047b412d1800aa89aba4d275f997/ocr.res'`
101
 
102
  1. Check your network from within Docker, for example:
103
  ```bash
 
174
  ```bash
175
  docker logs -f ragflow-server
176
  ```
177
+ 2. Check if the **task_executor.py** process exist.
178
  3. Check if your RAGFlow server can access hf-mirror.com or huggingface.com.
179
 
180
 
 
313
 
314
  ![](https://github.com/infiniflow/ragflow/assets/93570324/8cfb6fa4-8a97-415d-b9fa-b6f405a055f3)
315
 
 
316
  ### 4. How to run RAGFlow with a locally deployed LLM?
317
 
318
  You can use Ollama to deploy local LLM. See [here](https://github.com/infiniflow/ragflow/blob/main/docs/ollama.md) for more information.