马一丁

Update README-EN.md

@@ -316,14 +316,76 @@ uv pip install -r requirements.txt @@ -316,14 +316,76 @@ uv pip install -r requirements.txt
316 # If you do not want to use the local sentiment analysis model (which has low computational requirements and defaults to the CPU version), you can comment out the 'Machine Learning' section in this file before executing the command. 316 # If you do not want to use the local sentiment analysis model (which has low computational requirements and defaults to the CPU version), you can comment out the 'Machine Learning' section in this file before executing the command.
317 ``` 317 ```
318 318
319 -### 3. Install Playwright Browser Drivers 319 +### 3. Install System Dependencies for PDF Export (Optional)
  320 +
  321 +> ⚠️ **Note**: If you need to use the PDF export function, please install system dependencies following the steps below. If you don't need PDF export, you can skip this step, and other system functions will not be affected.
  322 +
  323 +<details>
  324 +<summary><b>📦 macOS Installation Steps</b></summary>
  325 +
  326 +```bash
  327 +# 1. Install system dependencies (execute on host machine)
  328 +brew install pango gdk-pixbuf libffi
  329 +
  330 +# 2. Set environment variable (required)
  331 +export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH
  332 +
  333 +# Or permanently add to ~/.zshrc
  334 +echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
  335 +source ~/.zshrc
  336 +```
  337 +
  338 +</details>
  339 +
  340 +<details>
  341 +<summary><b>🐧 Ubuntu/Debian Installation Steps</b></summary>
  342 +
  343 +```bash
  344 +# 1. Install system dependencies (execute on host machine)
  345 +sudo apt-get update
  346 +sudo apt-get install -y \
  347 + libpango-1.0-0 \
  348 + libpangoft2-1.0-0 \
  349 + libgdk-pixbuf2.0-0 \
  350 + libffi-dev \
  351 + libcairo2
  352 +```
  353 +
  354 +</details>
  355 +
  356 +<details>
  357 +<summary><b>🎩 CentOS/RHEL Installation Steps</b></summary>
  358 +
  359 +```bash
  360 +# 1. Install system dependencies (execute on host machine)
  361 +sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo
  362 +```
  363 +
  364 +</details>
  365 +
  366 +<details>
  367 +<summary><b>🪟 Windows Installation Steps</b></summary>
  368 +
  369 +```powershell
  370 +# 1. Download and install GTK3 Runtime (execute on host machine)
  371 +# Visit: https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases
  372 +# Download the latest .exe file and install
  373 +
  374 +# 2. Restart command line or IDE
  375 +```
  376 +
  377 +</details>
  378 +
  379 +> 💡 **Tip**: If using Docker deployment, no need to manually install these dependencies, the Docker image already contains all necessary system dependencies.
  380 +
  381 +### 4. Install Playwright Browser Drivers
320 382
321 ```bash 383 ```bash
322 # Install browser drivers (for crawler functionality) 384 # Install browser drivers (for crawler functionality)
323 playwright install chromium 385 playwright install chromium
324 ``` 386 ```
325 387
326 -### 4. Configure LLM and Database 388 +### 5. Configure LLM and Database
327 389
328 Copy the `.env.example` file in the project root directory and rename it to `.env`. 390 Copy the `.env.example` file in the project root directory and rename it to `.env`.
329 391
@@ -361,9 +423,9 @@ INSIGHT_ENGINE_MODEL_NAME= @@ -361,9 +423,9 @@ INSIGHT_ENGINE_MODEL_NAME=
361 ``` 423 ```
362 Recommended LLM API Provider: [aihubmix](https://aihubmix.com/?aff=8Ds9) 424 Recommended LLM API Provider: [aihubmix](https://aihubmix.com/?aff=8Ds9)
363 425
364 -### 5. Launch System 426 +### 6. Launch System
365 427
366 -#### 5.1 Complete System Launch (Recommended) 428 +#### 6.1 Complete System Launch (Recommended)
367 429
368 ```bash 430 ```bash
369 # In project root directory, activate conda environment 431 # In project root directory, activate conda environment
@@ -390,7 +452,7 @@ python app.py @@ -390,7 +452,7 @@ python app.py
390 452
391 Visit http://localhost:5000 to use the complete system 453 Visit http://localhost:5000 to use the complete system
392 454
393 -#### 5.2 Launch Individual Agents 455 +#### 6.2 Launch Individual Agents
394 456
395 ```bash 457 ```bash
396 # Start QueryEngine 458 # Start QueryEngine
@@ -403,7 +465,7 @@ streamlit run SingleEngineApp/media_engine_streamlit_app.py --server.port 8502 @@ -403,7 +465,7 @@ streamlit run SingleEngineApp/media_engine_streamlit_app.py --server.port 8502
403 streamlit run SingleEngineApp/insight_engine_streamlit_app.py --server.port 8501 465 streamlit run SingleEngineApp/insight_engine_streamlit_app.py --server.port 8501
404 ``` 466 ```
405 467
406 -#### 5.3 Crawler System Standalone Use 468 +#### 6.3 Crawler System Standalone Use
407 469
408 This section has detailed configuration documentation: [MindSpider Usage Guide](./MindSpider/README.md) 470 This section has detailed configuration documentation: [MindSpider Usage Guide](./MindSpider/README.md)
409 471