writinwaters commited on
Commit
e5aa7c3
Β·
1 Parent(s): d3d8d70

0331 config (#176)

Browse files

* Updated steps

* Miscellaneous updates

Files changed (1) hide show
  1. README.md +47 -52
README.md CHANGED
@@ -20,15 +20,13 @@
20
  <img height="21" src="https://img.shields.io/badge/License-Apache--2.0-ffffff?style=flat-square&labelColor=d4eaf7&color=7d09f1" alt="license">
21
  </a>
22
  </p>
23
- ## πŸ’‘ What is RagFlow?
24
 
25
- [RagFlow](http://demo.ragflow.io) is a knowledge management platform built on custom-build document understanding engine and LLM, with reasoned and well-founded answers to your question. Clone this repository, you can deploy your own knowledge management platform to empower your business with AI.
26
 
27
- <div align="center" style="margin-top:20px;margin-bottom:20px;">
28
- <img src="https://github.com/infiniflow/ragflow/assets/12318111/b24a7a5f-4d1d-4a30-90b1-7b0ec558b79d" width="1000"/>
29
- </div>
30
 
31
  ## 🌟 Key Features
 
32
  - 🍭**Custom-build document understanding engine.** Our deep learning engine is made according to the needs of analyzing and searching various type of documents in different domain.
33
  - For documents from different domain for different purpose, the engine applies different analyzing and search strategy.
34
  - Easily intervene and manipulate the data proccessing procedure when things goes beyond expectation.
@@ -57,56 +55,41 @@
57
 
58
  - CPU >= 2 cores
59
  - RAM >= 8 GB
60
- - Docker
61
- - `vm.max_map_count` > 65535
62
-
63
- > To check the value of `vm.max_map_count`:
64
- >
65
- > ```bash
66
- > $ sysctl vm.max_map_count
67
- > ```
68
- >
69
- > Reset `vm.max_map_count` to a value greater than 65535 if it is not.
70
- >
71
- > ```bash
72
- > # In this case, we set it to 262144:
73
- > $ sudo sysctl -w vm.max_map_count=262144
74
- > ```
75
- >
76
- > This change will be reset after a system reboot. To ensure your change remains permanent, add or update the `vm.max_map_count` value in **/etc/sysctl.conf** accordingly:
77
- >
78
- > ```bash
79
- > vm.max_map_count=262144
80
- > ```
81
-
82
-
83
-
84
- ### Start up the RagFlow server
85
-
86
- 1. Clone the repo:
87
 
88
  ```bash
89
  $ git clone https://github.com/infiniflow/ragflow.git
90
  ```
91
 
92
-
93
-
94
- 2. **Recommended**: In **docker/service_conf.yaml**, select the desired LLM factory in `user_default_llm` and update the `API_KEY` field with your own.
95
 
96
- > - You can still continue with the default settings, but it is highly recommended that you use your own API key the next time you log into the system.
97
- > - RagFlow now supports the flowing LLM factories: OpenAI, Tongyi-Qianwen, ZHIPU-AI, and Moonshot.
98
 
99
- 3. You now presented with two options for building the system: Using the pre-built images or building the images from source:
100
-
101
- ```bash
102
- # To use the pre-built images:
103
- $ cd ragflow/docker
104
- $ docker compose up -d
105
- ```
106
  ```bash
107
- # To build the images from source:
108
- $ cd ragflow/
109
- $ docker build -t infiniflow/ragflow:v1.0 .
110
  $ cd ragflow/docker
111
  $ docker compose up -d
112
  ```
@@ -115,7 +98,7 @@
115
 
116
  4. Check the server status after pulling all images and having Docker up and running:
117
  ```bash
118
- $ docker logs -f ragflow-server
119
  ```
120
  *The following output confirms a successful launch of the system:*
121
 
@@ -133,7 +116,8 @@
133
  INFO:werkzeug:Press CTRL+C to quit
134
  ```
135
 
136
- 5. In your browser, enter the IP address of your server and now you can try it out.
 
137
 
138
 
139
  ## πŸ”§ Configurations
@@ -148,16 +132,27 @@ Updates to system configurations require a system reboot to take effect *docker-
148
 
149
  > If you change anything in [.env](./docker/.env), please check [service_conf.yaml](./docker/service_conf.yaml) which is a configuration of the back-end service and should be consistent with [.env](./docker/.env).
150
 
 
 
 
 
 
 
 
 
 
 
 
 
151
  ## πŸ“œ Roadmap
152
 
153
- See the [RagFlow Roadmap 2024](https://github.com/infiniflow/ragflow/issues/162)
154
 
155
  ## πŸ„ Community
156
 
157
  - [Discord](https://discord.gg/uqQ4YMDf)
158
  - [Twitter](https://twitter.com/infiniflowai)
159
- - GitHub Discussions
160
 
161
  ## πŸ™Œ Contributing
162
 
163
- RagFlow flourishes via open-source collaboration. In this spirit, we embrace diverse contributions from the community. If you would like to be a part, review our [Contribution Guidelines](https://github.com/infiniflow/ragflow/blob/main/CONTRIBUTING.md) first.
 
20
  <img height="21" src="https://img.shields.io/badge/License-Apache--2.0-ffffff?style=flat-square&labelColor=d4eaf7&color=7d09f1" alt="license">
21
  </a>
22
  </p>
 
23
 
24
+ ## πŸ’‘ What is RAGFlow?
25
 
26
+ [RAGFlow](http://demo.ragflow.io) is a knowledge management platform built on custom-build document understanding engine and LLM, with reasoned and well-founded answers to your question. Clone this repository, you can deploy your own knowledge management platform to empower your business with AI.
 
 
27
 
28
  ## 🌟 Key Features
29
+
30
  - 🍭**Custom-build document understanding engine.** Our deep learning engine is made according to the needs of analyzing and searching various type of documents in different domain.
31
  - For documents from different domain for different purpose, the engine applies different analyzing and search strategy.
32
  - Easily intervene and manipulate the data proccessing procedure when things goes beyond expectation.
 
55
 
56
  - CPU >= 2 cores
57
  - RAM >= 8 GB
58
+ - Docker: If you have not installed Docker on your local machine (Windows, Mac, or Linux), see [Install Docker Engine](https://docs.docker.com/engine/install/).
59
+
60
+ ### Start up the server
61
+
62
+ 1. Ensure `vm.max_map_count` > 65535:
63
+
64
+ > To check the value of `vm.max_map_count`:
65
+ >
66
+ > ```bash
67
+ > $ sysctl vm.max_map_count
68
+ > ```
69
+ >
70
+ > Reset `vm.max_map_count` to a value greater than 65535 if it is not.
71
+ >
72
+ > ```bash
73
+ > # In this case, we set it to 262144:
74
+ > $ sudo sysctl -w vm.max_map_count=262144
75
+ > ```
76
+ >
77
+ > This change will be reset after a system reboot. To ensure your change remains permanent, add or update the `vm.max_map_count` value in **/etc/sysctl.conf** accordingly:
78
+ >
79
+ > ```bash
80
+ > vm.max_map_count=262144
81
+ > ```
82
+
83
+ 2. Clone the repo:
 
84
 
85
  ```bash
86
  $ git clone https://github.com/infiniflow/ragflow.git
87
  ```
88
 
 
 
 
89
 
90
+ 3. Build the pre-built Docker images and start up the server:
 
91
 
 
 
 
 
 
 
 
92
  ```bash
 
 
 
93
  $ cd ragflow/docker
94
  $ docker compose up -d
95
  ```
 
98
 
99
  4. Check the server status after pulling all images and having Docker up and running:
100
  ```bash
101
+ $ docker logs -f ragflow-server
102
  ```
103
  *The following output confirms a successful launch of the system:*
104
 
 
116
  INFO:werkzeug:Press CTRL+C to quit
117
  ```
118
 
119
+ 5. In your web browser, enter the IP address of your server as prompted.
120
+ *The show is on!*
121
 
122
 
123
  ## πŸ”§ Configurations
 
132
 
133
  > If you change anything in [.env](./docker/.env), please check [service_conf.yaml](./docker/service_conf.yaml) which is a configuration of the back-end service and should be consistent with [.env](./docker/.env).
134
 
135
+ ## πŸ› οΈ Build from source
136
+
137
+ To build the Docker images from source:
138
+
139
+ ```bash
140
+ $ git clone https://github.com/infiniflow/ragflow.git
141
+ $ cd ragflow/
142
+ $ docker build -t infiniflow/ragflow:v1.0 .
143
+ $ cd ragflow/docker
144
+ $ docker compose up -d
145
+ ```
146
+
147
  ## πŸ“œ Roadmap
148
 
149
+ See the [RAGFlow Roadmap 2024](https://github.com/infiniflow/ragflow/issues/162)
150
 
151
  ## πŸ„ Community
152
 
153
  - [Discord](https://discord.gg/uqQ4YMDf)
154
  - [Twitter](https://twitter.com/infiniflowai)
 
155
 
156
  ## πŸ™Œ Contributing
157
 
158
+ RAGFlow flourishes via open-source collaboration. In this spirit, we embrace diverse contributions from the community. If you would like to be a part, review our [Contribution Guidelines](https://github.com/infiniflow/ragflow/blob/main/CONTRIBUTING.md) first.