Starowo commited on
Commit
bcd8078
·
verified ·
1 Parent(s): b9fe2b4

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +8 -369
README.md CHANGED
@@ -1,369 +1,8 @@
1
- <div align="center">
2
- <a href="https://demo.ragflow.io/">
3
- <img src="web/src/assets/logo-with-text.png" width="520" alt="ragflow logo">
4
- </a>
5
- </div>
6
-
7
- <p align="center">
8
- <a href="./README.md">English</a> |
9
- <a href="./README_zh.md">简体中文</a> |
10
- <a href="./README_tzh.md">繁体中文</a> |
11
- <a href="./README_ja.md">日本語</a> |
12
- <a href="./README_ko.md">한국어</a> |
13
- <a href="./README_id.md">Bahasa Indonesia</a> |
14
- <a href="/README_pt_br.md">Português (Brasil)</a>
15
- </p>
16
-
17
- <p align="center">
18
- <a href="https://x.com/intent/follow?screen_name=infiniflowai" target="_blank">
19
- <img src="https://img.shields.io/twitter/follow/infiniflow?logo=X&color=%20%23f5f5f5" alt="follow on X(Twitter)">
20
- </a>
21
- <a href="https://demo.ragflow.io" target="_blank">
22
- <img alt="Static Badge" src="https://img.shields.io/badge/Online-Demo-4e6b99">
23
- </a>
24
- <a href="https://hub.docker.com/r/infiniflow/ragflow" target="_blank">
25
- <img src="https://img.shields.io/badge/docker_pull-ragflow:v0.17.2-brightgreen" alt="docker pull infiniflow/ragflow:v0.17.2">
26
- </a>
27
- <a href="https://github.com/infiniflow/ragflow/releases/latest">
28
- <img src="https://img.shields.io/github/v/release/infiniflow/ragflow?color=blue&label=Latest%20Release" alt="Latest Release">
29
- </a>
30
- <a href="https://github.com/infiniflow/ragflow/blob/main/LICENSE">
31
- <img height="21" src="https://img.shields.io/badge/License-Apache--2.0-ffffff?labelColor=d4eaf7&color=2e6cc4" alt="license">
32
- </a>
33
- </p>
34
-
35
- <h4 align="center">
36
- <a href="https://ragflow.io/docs/dev/">Document</a> |
37
- <a href="https://github.com/infiniflow/ragflow/issues/4214">Roadmap</a> |
38
- <a href="https://twitter.com/infiniflowai">Twitter</a> |
39
- <a href="https://discord.gg/4XxujFgUN7">Discord</a> |
40
- <a href="https://demo.ragflow.io">Demo</a>
41
- </h4>
42
-
43
- <details open>
44
- <summary><b>📕 Table of Contents</b></summary>
45
-
46
- - 💡 [What is RAGFlow?](#-what-is-ragflow)
47
- - 🎮 [Demo](#-demo)
48
- - 📌 [Latest Updates](#-latest-updates)
49
- - 🌟 [Key Features](#-key-features)
50
- - 🔎 [System Architecture](#-system-architecture)
51
- - 🎬 [Get Started](#-get-started)
52
- - 🔧 [Configurations](#-configurations)
53
- - 🔧 [Build a docker image without embedding models](#-build-a-docker-image-without-embedding-models)
54
- - 🔧 [Build a docker image including embedding models](#-build-a-docker-image-including-embedding-models)
55
- - 🔨 [Launch service from source for development](#-launch-service-from-source-for-development)
56
- - 📚 [Documentation](#-documentation)
57
- - 📜 [Roadmap](#-roadmap)
58
- - 🏄 [Community](#-community)
59
- - 🙌 [Contributing](#-contributing)
60
-
61
- </details>
62
-
63
- ## 💡 What is RAGFlow?
64
-
65
- [RAGFlow](https://ragflow.io/) is an open-source RAG (Retrieval-Augmented Generation) engine based on deep document
66
- understanding. It offers a streamlined RAG workflow for businesses of any scale, combining LLM (Large Language Models)
67
- to provide truthful question-answering capabilities, backed by well-founded citations from various complex formatted
68
- data.
69
-
70
- ## 🎮 Demo
71
-
72
- Try our demo at [https://demo.ragflow.io](https://demo.ragflow.io).
73
-
74
- <div align="center" style="margin-top:20px;margin-bottom:20px;">
75
- <img src="https://github.com/infiniflow/ragflow/assets/7248/2f6baa3e-1092-4f11-866d-36f6a9d075e5" width="1200"/>
76
- <img src="https://github.com/user-attachments/assets/504bbbf1-c9f7-4d83-8cc5-e9cb63c26db6" width="1200"/>
77
- </div>
78
-
79
- ## 🔥 Latest Updates
80
-
81
- - 2025-02-28 Combined with Internet search (Tavily), supports reasoning like Deep Research for any LLMs.
82
- - 2025-02-05 Updates the model list of 'SILICONFLOW' and adds support for Deepseek-R1/DeepSeek-V3.
83
- - 2025-01-26 Optimizes knowledge graph extraction and application, offering various configuration options.
84
- - 2024-12-18 Upgrades Document Layout Analysis model in DeepDoc.
85
- - 2024-12-04 Adds support for pagerank score in knowledge base.
86
- - 2024-11-22 Adds more variables to Agent.
87
- - 2024-11-01 Adds keyword extraction and related question generation to the parsed chunks to improve the accuracy of retrieval.
88
- - 2024-08-22 Support text to SQL statements through RAG.
89
-
90
- ## 🎉 Stay Tuned
91
-
92
- ⭐️ Star our repository to stay up-to-date with exciting new features and improvements! Get instant notifications for new
93
- releases! 🌟
94
-
95
- <div align="center" style="margin-top:20px;margin-bottom:20px;">
96
- <img src="https://github.com/user-attachments/assets/18c9707e-b8aa-4caf-a154-037089c105ba" width="1200"/>
97
- </div>
98
-
99
- ## 🌟 Key Features
100
-
101
- ### 🍭 **"Quality in, quality out"**
102
-
103
- - [Deep document understanding](./deepdoc/README.md)-based knowledge extraction from unstructured data with complicated
104
- formats.
105
- - Finds "needle in a data haystack" of literally unlimited tokens.
106
-
107
- ### 🍱 **Template-based chunking**
108
-
109
- - Intelligent and explainable.
110
- - Plenty of template options to choose from.
111
-
112
- ### 🌱 **Grounded citations with reduced hallucinations**
113
-
114
- - Visualization of text chunking to allow human intervention.
115
- - Quick view of the key references and traceable citations to support grounded answers.
116
-
117
- ### 🍔 **Compatibility with heterogeneous data sources**
118
-
119
- - Supports Word, slides, excel, txt, images, scanned copies, structured data, web pages, and more.
120
-
121
- ### 🛀 **Automated and effortless RAG workflow**
122
-
123
- - Streamlined RAG orchestration catered to both personal and large businesses.
124
- - Configurable LLMs as well as embedding models.
125
- - Multiple recall paired with fused re-ranking.
126
- - Intuitive APIs for seamless integration with business.
127
-
128
- ## 🔎 System Architecture
129
-
130
- <div align="center" style="margin-top:20px;margin-bottom:20px;">
131
- <img src="https://github.com/infiniflow/ragflow/assets/12318111/d6ac5664-c237-4200-a7c2-a4a00691b485" width="1000"/>
132
- </div>
133
-
134
- ## 🎬 Get Started
135
-
136
- ### 📝 Prerequisites
137
-
138
- - CPU >= 4 cores
139
- - RAM >= 16 GB
140
- - Disk >= 50 GB
141
- - Docker >= 24.0.0 & Docker Compose >= v2.26.1
142
- > If you have not installed Docker on your local machine (Windows, Mac, or Linux),
143
- > see [Install Docker Engine](https://docs.docker.com/engine/install/).
144
-
145
- ### 🚀 Start up the server
146
-
147
- 1. Ensure `vm.max_map_count` >= 262144:
148
-
149
- > To check the value of `vm.max_map_count`:
150
- >
151
- > ```bash
152
- > $ sysctl vm.max_map_count
153
- > ```
154
- >
155
- > Reset `vm.max_map_count` to a value at least 262144 if it is not.
156
- >
157
- > ```bash
158
- > # In this case, we set it to 262144:
159
- > $ sudo sysctl -w vm.max_map_count=262144
160
- > ```
161
- >
162
- > This change will be reset after a system reboot. To ensure your change remains permanent, add or update the
163
- > `vm.max_map_count` value in **/etc/sysctl.conf** accordingly:
164
- >
165
- > ```bash
166
- > vm.max_map_count=262144
167
- > ```
168
-
169
- 2. Clone the repo:
170
-
171
- ```bash
172
- $ git clone https://github.com/infiniflow/ragflow.git
173
- ```
174
-
175
- 3. Start up the server using the pre-built Docker images:
176
-
177
- > [!CAUTION]
178
- > All Docker images are built for x86 platforms. We don't currently offer Docker images for ARM64.
179
- > If you are on an ARM64 platform, follow [this guide](https://ragflow.io/docs/dev/build_docker_image) to build a Docker image compatible with your system.
180
-
181
- > The command below downloads the `v0.17.2-slim` edition of the RAGFlow Docker image. See the following table for descriptions of different RAGFlow editions. To download a RAGFlow edition different from `v0.17.2-slim`, update the `RAGFLOW_IMAGE` variable accordingly in **docker/.env** before using `docker compose` to start the server. For example: set `RAGFLOW_IMAGE=infiniflow/ragflow:v0.17.2` for the full edition `v0.17.2`.
182
-
183
- ```bash
184
- $ cd ragflow/docker
185
- $ docker compose -f docker-compose.yml up -d
186
- ```
187
-
188
- | RAGFlow image tag | Image size (GB) | Has embedding models? | Stable? |
189
- |-------------------|-----------------|-----------------------|--------------------------|
190
- | v0.17.2 | &approx;9 | :heavy_check_mark: | Stable release |
191
- | v0.17.2-slim | &approx;2 | ❌ | Stable release |
192
- | nightly | &approx;9 | :heavy_check_mark: | _Unstable_ nightly build |
193
- | nightly-slim | &approx;2 | ❌ | _Unstable_ nightly build |
194
-
195
- 4. Check the server status after having the server up and running:
196
-
197
- ```bash
198
- $ docker logs -f ragflow-server
199
- ```
200
-
201
- _The following output confirms a successful launch of the system:_
202
-
203
- ```bash
204
-
205
- ____ ___ ______ ______ __
206
- / __ \ / | / ____// ____// /____ _ __
207
- / /_/ // /| | / / __ / /_ / // __ \| | /| / /
208
- / _, _// ___ |/ /_/ // __/ / // /_/ /| |/ |/ /
209
- /_/ |_|/_/ |_|\____//_/ /_/ \____/ |__/|__/
210
-
211
- * Running on all addresses (0.0.0.0)
212
- ```
213
-
214
- > If you skip this confirmation step and directly log in to RAGFlow, your browser may prompt a `network anormal`
215
- > error because, at that moment, your RAGFlow may not be fully initialized.
216
-
217
- 5. In your web browser, enter the IP address of your server and log in to RAGFlow.
218
- > With the default settings, you only need to enter `http://IP_OF_YOUR_MACHINE` (**sans** port number) as the default
219
- > HTTP serving port `80` can be omitted when using the default configurations.
220
- 6. In [service_conf.yaml.template](./docker/service_conf.yaml.template), select the desired LLM factory in `user_default_llm` and update
221
- the `API_KEY` field with the corresponding API key.
222
-
223
- > See [llm_api_key_setup](https://ragflow.io/docs/dev/llm_api_key_setup) for more information.
224
-
225
- _The show is on!_
226
-
227
- ## 🔧 Configurations
228
-
229
- When it comes to system configurations, you will need to manage the following files:
230
-
231
- - [.env](./docker/.env): Keeps the fundamental setups for the system, such as `SVR_HTTP_PORT`, `MYSQL_PASSWORD`, and
232
- `MINIO_PASSWORD`.
233
- - [service_conf.yaml.template](./docker/service_conf.yaml.template): Configures the back-end services. The environment variables in this file will be automatically populated when the Docker container starts. Any environment variables set within the Docker container will be available for use, allowing you to customize service behavior based on the deployment environment.
234
- - [docker-compose.yml](./docker/docker-compose.yml): The system relies on [docker-compose.yml](./docker/docker-compose.yml) to start up.
235
-
236
- > The [./docker/README](./docker/README.md) file provides a detailed description of the environment settings and service
237
- > configurations which can be used as `${ENV_VARS}` in the [service_conf.yaml.template](./docker/service_conf.yaml.template) file.
238
-
239
- To update the default HTTP serving port (80), go to [docker-compose.yml](./docker/docker-compose.yml) and change `80:80`
240
- to `<YOUR_SERVING_PORT>:80`.
241
-
242
- Updates to the above configurations require a reboot of all containers to take effect:
243
-
244
- > ```bash
245
- > $ docker compose -f docker-compose.yml up -d
246
- > ```
247
-
248
- ### Switch doc engine from Elasticsearch to Infinity
249
-
250
- RAGFlow uses Elasticsearch by default for storing full text and vectors. To switch to [Infinity](https://github.com/infiniflow/infinity/), follow these steps:
251
-
252
- 1. Stop all running containers:
253
-
254
- ```bash
255
- $ docker compose -f docker/docker-compose.yml down -v
256
- ```
257
-
258
- > [!WARNING]
259
- > `-v` will delete the docker container volumes, and the existing data will be cleared.
260
-
261
- 2. Set `DOC_ENGINE` in **docker/.env** to `infinity`.
262
-
263
- 3. Start the containers:
264
-
265
- ```bash
266
- $ docker compose -f docker-compose.yml up -d
267
- ```
268
-
269
- > [!WARNING]
270
- > Switching to Infinity on a Linux/arm64 machine is not yet officially supported.
271
-
272
- ## 🔧 Build a Docker image without embedding models
273
-
274
- This image is approximately 2 GB in size and relies on external LLM and embedding services.
275
-
276
- ```bash
277
- git clone https://github.com/infiniflow/ragflow.git
278
- cd ragflow/
279
- docker build --build-arg LIGHTEN=1 -f Dockerfile -t infiniflow/ragflow:nightly-slim .
280
- ```
281
-
282
- ## 🔧 Build a Docker image including embedding models
283
-
284
- This image is approximately 9 GB in size. As it includes embedding models, it relies on external LLM services only.
285
-
286
- ```bash
287
- git clone https://github.com/infiniflow/ragflow.git
288
- cd ragflow/
289
- docker build -f Dockerfile -t infiniflow/ragflow:nightly .
290
- ```
291
-
292
- ## 🔨 Launch service from source for development
293
-
294
- 1. Install uv, or skip this step if it is already installed:
295
-
296
- ```bash
297
- pipx install uv
298
- ```
299
-
300
- 2. Clone the source code and install Python dependencies:
301
-
302
- ```bash
303
- git clone https://github.com/infiniflow/ragflow.git
304
- cd ragflow/
305
- uv sync --python 3.10 --all-extras # install RAGFlow dependent python modules
306
- ```
307
-
308
- 3. Launch the dependent services (MinIO, Elasticsearch, Redis, and MySQL) using Docker Compose:
309
-
310
- ```bash
311
- docker compose -f docker/docker-compose-base.yml up -d
312
- ```
313
-
314
- Add the following line to `/etc/hosts` to resolve all hosts specified in **docker/.env** to `127.0.0.1`:
315
-
316
- ```
317
- 127.0.0.1 es01 infinity mysql minio redis
318
- ```
319
-
320
- 4. If you cannot access HuggingFace, set the `HF_ENDPOINT` environment variable to use a mirror site:
321
-
322
- ```bash
323
- export HF_ENDPOINT=https://hf-mirror.com
324
- ```
325
-
326
- 5. Launch backend service:
327
-
328
- ```bash
329
- source .venv/bin/activate
330
- export PYTHONPATH=$(pwd)
331
- bash docker/launch_backend_service.sh
332
- ```
333
-
334
- 6. Install frontend dependencies:
335
- ```bash
336
- cd web
337
- npm install
338
- ```
339
- 7. Launch frontend service:
340
-
341
- ```bash
342
- npm run dev
343
- ```
344
-
345
- _The following output confirms a successful launch of the system:_
346
-
347
- ![](https://github.com/user-attachments/assets/0daf462c-a24d-4496-a66f-92533534e187)
348
-
349
- ## 📚 Documentation
350
-
351
- - [Quickstart](https://ragflow.io/docs/dev/)
352
- - [User guide](https://ragflow.io/docs/dev/category/guides)
353
- - [References](https://ragflow.io/docs/dev/category/references)
354
- - [FAQ](https://ragflow.io/docs/dev/faq)
355
-
356
- ## 📜 Roadmap
357
-
358
- See the [RAGFlow Roadmap 2025](https://github.com/infiniflow/ragflow/issues/4214)
359
-
360
- ## 🏄 Community
361
-
362
- - [Discord](https://discord.gg/4XxujFgUN7)
363
- - [Twitter](https://twitter.com/infiniflowai)
364
- - [GitHub Discussions](https://github.com/orgs/infiniflow/discussions)
365
-
366
- ## 🙌 Contributing
367
-
368
- RAGFlow flourishes via open-source collaboration. In this spirit, we embrace diverse contributions from the community.
369
- If you would like to be a part, review our [Contribution Guidelines](./CONTRIBUTING.md) first.
 
1
+ title: ragflow
2
+ emoji: 👁
3
+ colorFrom: blue
4
+ colorTo: indigo
5
+ sdk: docker
6
+ pinned: false
7
+ license: apache-2.0
8
+ short_description: none