RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.
Go agent-harnessagent-native-databaseagentic-aiagentic-retrievalagentic-searchaiai-agentscontext-enginecontext-engineeringcontext-managementharness-engineeringknowledge-compilationragretrieval-augmented-generationretrieval-harnesssearch-harness
docs: add macOS notes to the launch-from-source guide (#19970)
JHWu11171ca2b9ca24c3
diff --git a/docs/develop/launch_ragflow_from_source.md b/docs/develop/launch_ragflow_from_source.mdindex 5312949f08..aacca6a50a 100644--- a/docs/develop/launch_ragflow_from_source.md+++ b/docs/develop/launch_ragflow_from_source.md@@ -58,6 +58,17 @@ cd ragflow/uv sync --python 3.13 --group test --frozen && uv pip install sdk/python --group test```+:::note macOS+On macOS, some Python dependencies link against native libraries that are not installed by default. Install them with Homebrew before launching the backend service:++ ```bash+ brew install unixodbc jemalloc pkg-config+ ```++- `unixodbc` provides `libodbc.2.dylib`, which the `pyodbc` package links against. Without it, `import pyodbc` fails with `Library not loaded: .../libodbc.2.dylib` (the full path is `$(brew --prefix unixodbc)/lib/libodbc.2.dylib`; `/opt/homebrew` on Apple Silicon, `/usr/local` on Intel), and the ExeSQL agent tool fails to load (look for `Warning: Failed to import module exesql` at startup).+- `jemalloc` and `pkg-config` are required by the preload commands used to launch the task executor; see step 5 of [Launch the RAGFlow Backend Service](#launch-the-ragflow-backend-service).+:::+### Launch Third-Party ServicesThe following command launches the 'base' services (MinIO, Elasticsearch, Redis, and MySQL) using Docker Compose:@@ -105,6 +116,14 @@ docker compose -f docker/docker-compose-base.yml up -dJEMALLOC_PATH=$(pkg-config --variable=libdir jemalloc)/libjemalloc.so;LD_PRELOAD=$JEMALLOC_PATH python rag/svr/task_executor.py -i 1;```++ On macOS, use the Homebrew dylib and `DYLD_INSERT_LIBRARIES` instead:++ ```shell+ JEMALLOC_PATH=$(pkg-config --variable=libdir jemalloc)/libjemalloc.2.dylib;+ DYLD_INSERT_LIBRARIES=$JEMALLOC_PATH python rag/svr/task_executor.py -i 1;+ ```+```shellpython api/ragflow_server.py;```