Spaces:
Build error
Build error
Merge pull request #77 from DL4DS/readme_cleanup
Browse files
README.md
CHANGED
|
@@ -18,9 +18,12 @@ Hugging Face [Space](https://huggingface.co/spaces/dl4ds/dl4ds_tutor). It is pus
|
|
| 18 |
A "development" version of the Tutor is running live at [DL4DS Tutor -- Dev](https://dl4ds-tutor-dev.hf.space/) from this Hugging Face
|
| 19 |
[Space](https://huggingface.co/spaces/dl4ds/tutor_dev). It is pushed automatically from the `dev_branch` branch of this repo by this
|
| 20 |
[Actions Workflow](https://github.com/DL4DS/dl4ds_tutor/blob/dev_branch/.github/workflows/push_to_hf_space_prototype.yml) upon a push to `dev_branch`.
|
| 21 |
-
## Running Locally
|
| 22 |
|
| 23 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 24 |
|
| 25 |
1. **Clone the Repository**
|
| 26 |
```bash
|
|
@@ -49,40 +52,9 @@ Please view `docs/setup.md` for more information on setting up the project.
|
|
| 49 |
chainlit run main.py
|
| 50 |
```
|
| 51 |
|
| 52 |
-
|
| 53 |
-
|
| 54 |
-
## File Structure
|
| 55 |
-
|
| 56 |
-
```plaintext
|
| 57 |
-
code/
|
| 58 |
-
βββ modules
|
| 59 |
-
β βββ chat # Contains the chatbot implementation
|
| 60 |
-
β βββ chat_processor # Contains the implementation to process and log the conversations
|
| 61 |
-
β βββ config # Contains the configuration files
|
| 62 |
-
β βββ dataloader # Contains the implementation to load the data from the storage directory
|
| 63 |
-
β βββ retriever # Contains the implementation to create the retriever
|
| 64 |
-
β βββ vectorstore # Contains the implementation to create the vector database
|
| 65 |
-
βββ public
|
| 66 |
-
β βββ logo_dark.png # Dark theme logo
|
| 67 |
-
β βββ logo_light.png # Light theme logo
|
| 68 |
-
β βββ test.css # Custom CSS file
|
| 69 |
-
βββ main.py
|
| 70 |
|
| 71 |
-
|
| 72 |
-
docs/ # Contains the documentation to the codebase and methods used
|
| 73 |
-
|
| 74 |
-
storage/
|
| 75 |
-
βββ data # Store files and URLs here
|
| 76 |
-
βββ logs # Logs directory, includes logs on vector DB creation, tutor logs, and chunks logged in JSON files
|
| 77 |
-
βββ models # Local LLMs are loaded from here
|
| 78 |
-
|
| 79 |
-
vectorstores/ # Stores the created vector databases
|
| 80 |
-
|
| 81 |
-
.env # This needs to be created, store the API keys here
|
| 82 |
-
```
|
| 83 |
-
- `code/modules/vectorstore/vectorstore.py`: Instantiates the `VectorStore` class to create the vector database.
|
| 84 |
-
- `code/modules/vectorstore/store_manager.py`: Instantiates the `VectorStoreManager:` class to manage the vector database, and all associated methods.
|
| 85 |
-
- `code/modules/retriever/retriever.py`: Instantiates the `Retriever` class to create the retriever.
|
| 86 |
|
| 87 |
|
| 88 |
## Docker
|
|
@@ -96,6 +68,10 @@ docker run -it --rm -p 8000:8000 dev
|
|
| 96 |
|
| 97 |
## Contributing
|
| 98 |
|
| 99 |
-
Please create an issue if you have any suggestions or improvements, and start working on it by creating a branch and by making a pull request to the
|
|
|
|
|
|
|
|
|
|
|
|
|
| 100 |
|
| 101 |
-
|
|
|
|
| 18 |
A "development" version of the Tutor is running live at [DL4DS Tutor -- Dev](https://dl4ds-tutor-dev.hf.space/) from this Hugging Face
|
| 19 |
[Space](https://huggingface.co/spaces/dl4ds/tutor_dev). It is pushed automatically from the `dev_branch` branch of this repo by this
|
| 20 |
[Actions Workflow](https://github.com/DL4DS/dl4ds_tutor/blob/dev_branch/.github/workflows/push_to_hf_space_prototype.yml) upon a push to `dev_branch`.
|
|
|
|
| 21 |
|
| 22 |
+
## Setup
|
| 23 |
+
|
| 24 |
+
Please visit [setup](https://dl4ds.github.io/dl4ds_tutor/guide/setup/) for more information on setting up the project.
|
| 25 |
+
|
| 26 |
+
## Running Locally
|
| 27 |
|
| 28 |
1. **Clone the Repository**
|
| 29 |
```bash
|
|
|
|
| 52 |
chainlit run main.py
|
| 53 |
```
|
| 54 |
|
| 55 |
+
## Documentation
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 56 |
|
| 57 |
+
Please visit the [docs](https://dl4ds.github.io/dl4ds_tutor/) for more information.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 58 |
|
| 59 |
|
| 60 |
## Docker
|
|
|
|
| 68 |
|
| 69 |
## Contributing
|
| 70 |
|
| 71 |
+
Please create an issue if you have any suggestions or improvements, and start working on it by creating a branch and by making a pull request to the `dev_branch`.
|
| 72 |
+
|
| 73 |
+
Please visit [contribute](https://dl4ds.github.io/dl4ds_tutor/guide/contribute/) for more information on contributing.
|
| 74 |
+
|
| 75 |
+
## Future Work
|
| 76 |
|
| 77 |
+
For more information on future work, please visit [roadmap](https://dl4ds.github.io/dl4ds_tutor/guide/readmap/).
|