Spaces:
Runtime error
Runtime error
Update README
Browse files
README.md
CHANGED
|
@@ -14,25 +14,27 @@ license: mit
|
|
| 14 |
|
| 15 |
## Introduction π
|
| 16 |
|
| 17 |
-
RAGTheDocs is an open-source library that allows you to
|
| 18 |
|
| 19 |
-
##
|
| 20 |
-
|
| 21 |
-
- **Web Scraping and Analysis:** RAGtheDocs automatically scrapes and embeds documentation from any website generated by ReadTheDocs/Sphinx
|
| 22 |
|
| 23 |
-
|
|
|
|
| 24 |
|
| 25 |
-
-
|
| 26 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 27 |
|
| 28 |
-
|
| 29 |
|
| 30 |
-
TODO
|
| 31 |
|
| 32 |
-
##
|
| 33 |
|
| 34 |
-
|
| 35 |
|
| 36 |
-
|
| 37 |
|
| 38 |
-
|
|
|
|
| 14 |
|
| 15 |
## Introduction π
|
| 16 |
|
| 17 |
+
RAGTheDocs is an open-source library that allows you to deploy retrieval augmented generation (RAG) on any readthedocs documentation with a one-click deploy on huggingface spaces!
|
| 18 |
|
| 19 |
+
## Usage
|
|
|
|
|
|
|
| 20 |
|
| 21 |
+
1) Go to the [example space](https://huggingface.co/spaces/jerpint/RAGTheDocs)
|
| 22 |
+
2) Duplicate the space:
|
| 23 |
|
| 24 |
+

|
| 25 |
|
| 26 |
+
3) Set your environment variables:
|
| 27 |
+
* OPENAI_API_KEY: Needed for the app to work, e.g. `sk-...`
|
| 28 |
+
* READTHEDOCS_URL: The url of the website you are interested in scraping
|
| 29 |
+
* READTHEDOCS_VERSION: This is important only if there exist multiple versions of the docs (e.g. "en/v0.2.7" or "en/latest"). If left empty, it will scrape all available versions.
|
| 30 |
|
| 31 |
+
**WARNING** This library is experimental and automatically calls OpenAI APIs for you. Use at your own risk! β οΈ
|
| 32 |
|
|
|
|
| 33 |
|
| 34 |
+
## Features π
|
| 35 |
|
| 36 |
+
- **Web Scraping and embeddings:** RAGtheDocs automatically scrapes and embeds documentation from any website generated by ReadTheDocs/Sphinx using OpenAI embeddings
|
| 37 |
|
| 38 |
+
- **RAG Interface:** It comes built-in with a gradio UI for users to interact with [Buster π€](github.com/jerpint/buster) our RAG agent.
|
| 39 |
|
| 40 |
+
- **Customization Options:** Tailor RAGtheDocs to your needs with customizable settings and options.
|