Thomas (Tom) Gardos commited on
Commit
d62dc89
Β·
unverified Β·
2 Parent(s): 52ce66d 691433b

Merge pull request #77 from DL4DS/readme_cleanup

Browse files
Files changed (1) hide show
  1. README.md +13 -37
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
- Please view `docs/setup.md` for more information on setting up the project.
 
 
 
 
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
- See the [docs](https://github.com/DL4DS/dl4ds_tutor/tree/main/docs) for more information.
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 main branch.
 
 
 
 
100
 
101
- Please view `docs/contribute.md` for more information on contributing.
 
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/).