From f2f021bfd1f87bcbbf7b870bd3674152c156b34f Mon Sep 17 00:00:00 2001 From: Ikko Eltociear Ashimine <eltociear@gmail.com> Date: Thu, 4 Apr 2024 10:26:39 +0900 Subject: [PATCH] docs: Add Japanese README (#224) ### What problem does this PR solve? I created Japanese translated README. ### Type of change - [x] Documentation Update --- README.md | 3 +- README_ja.md | 182 +++++++++++++++++++++++++++++++++++++++++++++++++++ README_zh.md | 3 +- 3 files changed, 186 insertions(+), 2 deletions(-) create mode 100644 README_ja.md diff --git a/README.md b/README.md index 158ff8a..3070eaf 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,8 @@ <p align="center"> <a href="./README.md">English</a> | - <a href="./README_zh.md">简体ä¸ć–‡</a> + <a href="./README_zh.md">简体ä¸ć–‡</a> | + <a href="./README_ja.md">日本語</a> </p> <p align="center"> diff --git a/README_ja.md b/README_ja.md new file mode 100644 index 0000000..bd64189 --- /dev/null +++ b/README_ja.md @@ -0,0 +1,182 @@ +<div align="center"> +<a href="https://demo.ragflow.io/"> +<img src="web/src/assets/logo-with-text.png" width="350" alt="ragflow logo"> +</a> +</div> + +<p align="center"> + <a href="./README.md">English</a> | + <a href="./README_zh.md">简体ä¸ć–‡</a> | + <a href="./README_ja.md">日本語</a> +</p> + +<p align="center"> + <a href="https://demo.ragflow.io" target="_blank"> + <img alt="Static Badge" src="https://img.shields.io/badge/RAGFLOW-LLM-white?&labelColor=dd0af7"></a> + <a href="https://hub.docker.com/r/infiniflow/ragflow" target="_blank"> + <img src="https://img.shields.io/badge/docker_pull-ragflow:v1.0-brightgreen" + alt="docker pull ragflow:v1.0"></a> + <a href="https://github.com/infiniflow/ragflow/blob/main/LICENSE"> + <img height="21" src="https://img.shields.io/badge/License-Apache--2.0-ffffff?style=flat-square&labelColor=d4eaf7&color=7d09f1" alt="license"> + </a> +</p> + +## đź’ˇ RAGFlow ă¨ăŻďĽź + +[RAGFlow](https://demo.ragflow.io) ăŻă€ć·±ă„文書ç†č§Łă«ĺźşăĄă„ăźă‚ŞăĽă—ăłă‚˝ăĽă‚ąă® RAG (Retrieval-Augmented Generation) エăłă‚¸ăłă§ă‚る。LLMďĽĺ¤§č¦Źć¨ˇč¨€čŞžă˘ă‡ă«ďĽ‰ă‚’組ăżĺă‚Źă›ă‚‹ă“ă¨ă§ă€ć§ă€…ăŞč¤‡é›‘ăŞă•ă‚©ăĽăžăăă®ă‡ăĽă‚żă‹ă‚‰ć ąć‹ ă®ă‚る引用ă«čŁŹć‰“ăˇă•ă‚Śăźă€çśźĺ®źĺ‘łă®ă‚る質問応ç”ć©źč˝ă‚’ćŹäľ›ă—ă€ă‚らゆる規模ă®ă“ジăŤă‚ąă«ĺç†ĺŚ–ă•ă‚Śăź RAG ăŻăĽă‚Żă•ăăĽă‚’ćŹäľ›ă—ăľă™ă€‚ + +## 🌟 主ăŞç‰ąĺľ´ + +### 🍠**"Quality in, quality out"** + +- 複雑ăŞĺ˝˘ĺĽŹă®éťžć§‹é€ 化ă‡ăĽă‚żă‹ă‚‰ă®[ć·±ă„文書ç†č§Ł](./deepdoc/README.md)ă™ăĽă‚ąă®çźĄč抽出。 +- ć–‡ĺ—通り無é™ă®ăăĽă‚Żăłă‹ă‚‰"干ă—草ă®ĺ±±ă®ä¸ă®é‡ť"を見ă¤ă‘る。 + +### 🍱 **ă†ăłă—ă¬ăĽăă™ăĽă‚ąă®ăăŁăłă‚ŻĺŚ–** + +- 知的ă§čެćŽă—ă‚„ă™ă„。 +- 豊富ăŞă†ăłă—ă¬ăĽăă‚Şă—ă‚·ă§ăłă€‚ + +### 🌱 **ăŹă«ă‚·ăŤăĽă‚·ă§ăłăŚč»˝ć¸›ă•ă‚Śăźć ąć‹ ă®ă‚る引用** + +- äşşé–“ă®ä»‹ĺ…Ąă‚’可č˝ă«ă™ă‚‹ă†ă‚ă‚ąăăăŁăłă‚ăłă‚°ă®č¦–覚化。 +- 重č¦ăŞĺŹ‚č€ć–‡çŚ®ă®ă‚Żă‚¤ăă‚Żă“ăĄăĽă¨ă€ć ąć‹ ă‚ă‚‹ç”ăをサăťăĽăă™ă‚‹čż˝č·ˇĺŹŻč˝ăŞĺĽ•ç”¨ă€‚ + +### 🍔 **異種ă®ă‡ăĽă‚żă‚˝ăĽă‚ąă¨ă®äş’換性** + +- Wordă€ă‚ąă©ă‚¤ă‰ă€Excelă€txtă€ç”»ĺŹă€ă‚ąă‚ăŁăłă‚łă”ăĽă€ć§‹é€ 化ă‡ăĽă‚żă€Web ăšăĽă‚¸ăŞă©ă‚’サăťăĽă。 + +### 🛀 **自動化ă•ă‚ŚăźćĄ˝ăŞ RAG ăŻăĽă‚Żă•ăăĽ** + +- 個人ă‹ă‚‰ĺ¤§äĽćĄăľă§ĺŻľĺżśă™ă‚‹ĺç†ĺŚ–ă•ă‚ŚăźRAGă‚ŞăĽă‚±ă‚ąăă¬ăĽă‚·ă§ăłă€‚ +- č¨ĺ®šĺŹŻč˝ăŞ LLM ă¨ă‚¨ăłă™ăă‡ă‚Łăłă‚°ă˘ă‡ă«ă€‚ +- 複数ă®ćłčµ·ă¨čžŤĺă•ă‚Śăźĺ†Ťă©ăłă‚Żä»ă‘。 +- ă“ジăŤă‚ąă¨ă®ă‚·ăĽă ă¬ă‚ąăŞçµ±ĺă®ăźă‚ă®ç›´ć„źçš„㪠API。 + +## 🔎 ă‚·ă‚ąă†ă 構ć + +<div align="center" style="margin-top:20px;margin-bottom:20px;"> +<img src="https://github.com/infiniflow/ragflow/assets/12318111/d6ac5664-c237-4200-a7c2-a4a00691b485" width="1000"/> +</div> + +## 🎬 始ă‚ă‚‹ + +### đź“ť ĺż…č¦ćťˇä»¶ + +- CPU >= 2 cores +- RAM >= 8 GB +- Docker + > ăăĽă‚«ă«ăžă‚·ăłďĽWindowsă€Macă€ăľăźăŻ Linux)㫠Docker をイăłă‚ąăăĽă«ă—ă¦ă„ăŞă„ĺ ´ĺăŻă€[Docker Engine ă®ă‚¤ăłă‚ąăăĽă«](https://docs.docker.com/engine/install/)を参照ă—ă¦ăŹă ă•ă„。 + +### 🚀 サăĽăăĽă‚’čµ·ĺ‹• + +1. `vm.max_map_count` > 65535 ă§ă‚ă‚‹ă“ă¨ă‚’確認ă™ă‚‹: + + > `vm.max_map_count` ă®ĺ€¤ă‚’ăェăă‚Żă™ă‚‹ă«ăŻ: + > + > ```bash + > $ sysctl vm.max_map_count + > ``` + > + > `vm.max_map_count` ㌠65535 ă‚り大ăŤă„値ă§ăŞă‘ă‚Śă°ăŞă‚»ăăă™ă‚‹ă€‚ + > + > ```bash + > # In this case, we set it to 262144: + > $ sudo sysctl -w vm.max_map_count=262144 + > ``` + > + > ă“ă®ĺ¤‰ć›´ăŻă‚·ă‚ąă†ă 再起動後ă«ăŞă‚»ăăă•ă‚Śă‚‹ă€‚変更をć’äą…çš„ăŞă‚‚ă®ă«ă™ă‚‹ă«ăŻă€**/etc/sysctl.conf** ă® `vm.max_map_count` 値をé©ĺ®śčż˝ĺŠ ăľăźăŻć›´ć–°ă™ă‚‹: + > + > ```bash + > vm.max_map_count=262144 + > ``` + +2. ăŞăťă‚¸ăăŞă‚’ă‚ŻăăĽăłă™ă‚‹: + + ```bash + $ git clone https://github.com/infiniflow/ragflow.git + ``` + +3. ă“ă«ă‰ć¸ăżă® Docker イăˇăĽă‚¸ă‚’ă“ă«ă‰ă—ă€ă‚µăĽăăĽă‚’čµ·ĺ‹•ă™ă‚‹: + + ```bash + $ cd ragflow/docker + $ docker compose up -d + ``` + + > コアイăˇăĽă‚¸ă®ă‚µă‚¤ă‚şăŻç´„ 15 GB ă§ă€ăăĽă‰ă«ć™‚é–“ăŚă‹ă‹ă‚‹ĺ ´ĺăŚă‚ă‚Šăľă™ă€‚ + +4. サăĽăăĽă‚’ç«‹ăˇä¸Šă’ăźĺľŚă€ă‚µăĽăăĽă®çŠ¶ć…‹ă‚’確認ă™ă‚‹: + + ```bash + $ docker logs -f ragflow-server + ``` + + _以下ă®ĺ‡şĺŠ›ăŻă€ă‚·ă‚ąă†ă ăŚćŁĺ¸¸ă«čµ·ĺ‹•ă—ăźă“ă¨ă‚’確認ă™ă‚‹ă‚‚ă®ă§ă™:_ + + ```bash + ____ ______ __ + / __ \ ____ _ ____ _ / ____// /____ _ __ + / /_/ // __ `// __ `// /_ / // __ \| | /| / / + / _, _// /_/ // /_/ // __/ / // /_/ /| |/ |/ / + /_/ |_| \__,_/ \__, //_/ /_/ \____/ |__/|__/ + /____/ + + * Running on all addresses (0.0.0.0) + * Running on http://127.0.0.1:9380 + * Running on http://172.22.0.5:9380 + INFO:werkzeug:Press CTRL+C to quit + ``` + +5. ウェă–ă–ă©ă‚¦ă‚¶ă§ă€ă—ăăłă—ăă«ĺľ“ăŁă¦ă‚µăĽăăĽă® IP アă‰ă¬ă‚ąă‚’入力ă—ă€RAGFlow ă«ăグイăłă—ăľă™ă€‚ + > ă‡ă•ă‚©ă«ăă®č¨ĺ®šă‚’使用ă™ă‚‹ĺ ´ĺă€ă‡ă•ă‚©ă«ăă® HTTP サăĽă“ăłă‚°ăťăĽă `80` ăŻçśç•Ąă§ăŤă‚‹ă®ă§ă€ä¸Žăられăźă‚·ăŠăŞă‚Şă§ăŻă€`http://172.22.0.5`ďĽăťăĽă番号ăŻçśç•ĄďĽ‰ă ă‘を入力ă™ă‚Śă°ă‚ă„。 +6. [service_conf.yaml](./docker/service_conf.yaml) ă§ă€`user_default_llm` ă§ĺ¸Śćś›ă® LLM ă•ă‚ˇă‚ŻăăŞă‚’é¸ćŠžă—ă€`API_KEY` ă•ă‚ŁăĽă«ă‰ă‚’対応ă™ă‚‹ API ă‚ăĽă§ć›´ć–°ă™ă‚‹ă€‚ + + > č©łă—ăŹăŻ [./docs/llm_api_key_setup.md](./docs/llm_api_key_setup.md) を参照ă—ă¦ăŹă ă•ă„。 + + _ă‚·ă§ăĽă®é–‹ĺą•ă§ă™ďĽ_ + +## 🔧 ă‚łăłă•ă‚Łă‚° + +ă‚·ă‚ąă†ă ă‚łăłă•ă‚Łă‚°ă«é–˘ă—ă¦ăŻă€ä»Ąä¸‹ă®ă•ă‚ˇă‚¤ă«ă‚’管ç†ă™ă‚‹ĺż…č¦ăŚă‚ă‚‹: + +- [.env](./docker/.env): `SVR_HTTP_PORT`ă€`MYSQL_PASSWORD`ă€`MINIO_PASSWORD` ăŞă©ă®ă‚·ă‚ąă†ă ă®ĺźşćś¬č¨ĺ®šă‚’äżťćŚă™ă‚‹ă€‚ +- [service_conf.yaml](./docker/service_conf.yaml): ăăクエăłă‰ă®ă‚µăĽă“ă‚ąă‚’č¨ĺ®šă—ăľă™ă€‚ +- [docker-compose.yml](./docker/docker-compose.yml): ă‚·ă‚ąă†ă ă®čµ·ĺ‹•ăŻ [docker-compose.yml](./docker/docker-compose.yml) ă«äľťĺă—ă¦ă„る。 + +[.env](./docker/.env) ă•ă‚ˇă‚¤ă«ă®ĺ¤‰ć›´ăŚ [service_conf.yaml](./docker/service_conf.yaml) ă•ă‚ˇă‚¤ă«ă®ĺ†…容ă¨ä¸€č‡´ă—ă¦ă„ă‚‹ă“ă¨ă‚’確認ă™ă‚‹ĺż…č¦ăŚă‚ă‚Šăľă™ă€‚ + +> [./docker/README](./docker/README.md) ă•ă‚ˇă‚¤ă«ăŻç’°ĺ˘č¨ĺ®šă¨ă‚µăĽă“ă‚ąă‚łăłă•ă‚Łă‚°ă®č©łç´°ăŞčެćŽă‚’ćŹäľ›ă—ă€[./docker/README](./docker/README.md) ă•ă‚ˇă‚¤ă«ă«č¨čĽ‰ă•ă‚Śă¦ă„ă‚‹ĺ…¨ă¦ă®ç’°ĺ˘č¨ĺ®šăŚ [service_conf.yaml](./docker/service_conf.yaml) ă•ă‚ˇă‚¤ă«ă®ĺŻľĺżśă™ă‚‹ă‚łăłă•ă‚Łă‚°ă¨ä¸€č‡´ă—ă¦ă„ă‚‹ă“ă¨ă‚’確認ă™ă‚‹ă“ă¨ăŚçľ©ĺ‹™ä»ă‘られă¦ă„ăľă™ă€‚ + +ă‡ă•ă‚©ă«ăă® HTTP サăĽă“ăłă‚°ăťăĽă(80)ă‚’ć›´ć–°ă™ă‚‹ă«ăŻă€[docker-compose.yml](./docker/docker-compose.yml) ă«ă‚˘ă‚Żă‚»ă‚ąă—ă¦ă€`80:80` ă‚’ `<YOUR_SERVING_PORT>:80` ă«ĺ¤‰ć›´ă—ăľă™ă€‚ + +> ă™ăąă¦ă®ă‚·ă‚ąă†ă č¨ĺ®šă®ă‚˘ăă—ă‡ăĽăを有効ă«ă™ă‚‹ă«ăŻă€ă‚·ă‚ąă†ă ă®ĺ†Ťčµ·ĺ‹•ăŚĺż…č¦ă§ă™: +> +> ```bash +> $ docker-compose up -d +> ``` + +## 🛠️ ă‚˝ăĽă‚ąă‹ă‚‰ă“ă«ă‰ă™ă‚‹ + +ă‚˝ăĽă‚ąă‹ă‚‰DockerイăˇăĽă‚¸ă‚’ă“ă«ă‰ă™ă‚‹ă«ăŻ: + +```bash +$ git clone https://github.com/infiniflow/ragflow.git +$ cd ragflow/ +$ docker build -t infiniflow/ragflow:v1.0 . +$ cd ragflow/docker +$ docker compose up -d +``` + +## đź“ś ăăĽă‰ăžăă— + +[RAGFlow ăăĽă‰ăžăă— 2024](https://github.com/infiniflow/ragflow/issues/162) を参照 + +## 🏄 ă‚łăźăĄă‹ă†ă‚Ł + +- [Discord](https://discord.gg/uqQ4YMDf) +- [Twitter](https://twitter.com/infiniflowai) + +## 🙌 ă‚łăłăăŞă“ăĄăĽă + +RAGFlow ăŻă‚ŞăĽă—ăłă‚˝ăĽă‚ąă®ă‚łă©ăśă¬ăĽă‚·ă§ăłă«ă‚ăŁă¦ç™şĺ±•ă—ă¦ăŤăľă—ăźă€‚ă“ă®ç˛ľçĄžă«ĺźşăĄăŤă€ç§ăźăˇăŻă‚łăźăĄă‹ă†ă‚Łă‹ă‚‰ă®ĺ¤šć§ăŞă‚łăłăăŞă“ăĄăĽăを受ă‘ĺ…Ąă‚Śă¦ă„ăľă™ă€‚ ĺŹ‚ĺŠ ă‚’ĺ¸Śćś›ă•ă‚Śă‚‹ć–ąăŻă€ăľăš[ă‚łăłăăŞă“ăĄăĽă‚·ă§ăłă‚¬ă‚¤ă‰](https://github.com/infiniflow/ragflow/blob/main/docs/CONTRIBUTING.md)ă‚’ă”覧ăŹă ă•ă„。 diff --git a/README_zh.md b/README_zh.md index 0454657..91a0cd7 100644 --- a/README_zh.md +++ b/README_zh.md @@ -6,7 +6,8 @@ <p align="center"> <a href="./README.md">English</a> | - <a href="./README_zh.md">简体ä¸ć–‡</a> + <a href="./README_zh.md">简体ä¸ć–‡</a> | + <a href="./README_ja.md">日本語</a> </p> <p align="center"> -- GitLab