Sarah Bentley commited on
Commit
4044674
Β·
1 Parent(s): cbd4b8f

readme update

Browse files
Files changed (1) hide show
  1. README.md +50 -47
README.md CHANGED
@@ -43,11 +43,60 @@ pip install -r requirements.txt
43
  - In config.py, set the BASE_MODEL variable to your base model of choice from HuggingFace.
44
  - Keep in mind it's better to have a small, lightweight model if you plan on finetuning.
45
 
46
- 3. After you update the code, you can run the chatbot locally:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
47
  ```bash
48
  python app.py
49
  ```
50
 
 
51
  ## Deploying to Hugging Face
52
 
53
  To deploy your chatbot as a free web interface using Hugging Face Spaces:
@@ -107,49 +156,3 @@ To deploy your chatbot as a free web interface using Hugging Face Spaces:
107
 
108
  Your chatbot should now be accessible to anyone through their web browser!
109
 
110
- ## Repository Organization
111
-
112
- ```
113
- boston-school-chatbot/
114
- β”œβ”€β”€ app.py # Gradio web interface - implement the chat function
115
- β”œβ”€β”€ requirements.txt # Python dependencies
116
- β”œβ”€β”€ chatbot_development.ipynb # Notebook for developing and testing your chatbot
117
- β”œβ”€β”€ .env # Add this file yourself for storing your HF_TOKEN
118
- β”œβ”€β”€ config.py # Holds variables for the models from HuggingFace you will use
119
- β”œβ”€β”€ chatbot_conversation_example.txt # Example conversation we might want to have with this chatbot
120
- └── src/
121
- β”œβ”€β”€ model.py # Model loading/saving (already implemented)
122
- └── chat.py # SchoolChatbot class (implement this)
123
- ```
124
-
125
- ### Key Files:
126
-
127
- - **app.py**: Creates the web interface using Gradio. You only need to implement the `chat` function that generates responses.
128
-
129
- - **chat.py**: Contains the `SchoolChatbot` class where you'll implement:
130
- - `format_prompt`: Format user input into proper prompts
131
- - `get_response`: Generate responses using the model
132
-
133
- - **config.py**: Contains the `BASE_MODEL` and `MY_MODEL` variables, which are names of models on HuggingFace. Update the `MY_MODEL` variable if you create a new model and upload it to the HuggingFace Hub.
134
-
135
- - **chatbot_development.ipynb**: Jupyter notebook for:
136
- - Experimenting with the chatbot
137
- - Trying different approaches
138
- - Testing responses before deployment
139
-
140
- ### What You Need to Implement:
141
-
142
- 1. In `chat.py`:
143
- - Complete the `SchoolChatbot` class methods
144
- - Design how the chatbot formats prompts
145
- - Implement response generation
146
-
147
- 2. In `app.py`:
148
- - Implement the `chat` function to work with Gradio
149
- - The rest of the file is already set up
150
-
151
- 3. Use `chatbot_development.ipynb` to:
152
- - Develop and test your implementation
153
- - Try different approaches
154
- - Verify everything works before deployment
155
-
 
43
  - In config.py, set the BASE_MODEL variable to your base model of choice from HuggingFace.
44
  - Keep in mind it's better to have a small, lightweight model if you plan on finetuning.
45
 
46
+
47
+
48
+ ## Repository Organization
49
+
50
+ ```
51
+ boston-school-chatbot/
52
+ β”œβ”€β”€ app.py # Gradio web interface - implement the chat function
53
+ β”œβ”€β”€ requirements.txt # Python dependencies
54
+ β”œβ”€β”€ chatbot_development.ipynb # Notebook for developing and testing your chatbot
55
+ β”œβ”€β”€ .env # Add this file yourself for storing your HF_TOKEN
56
+ β”œβ”€β”€ config.py # Holds variables for the models from HuggingFace you will use
57
+ β”œβ”€β”€ chatbot_conversation_example.txt # Example conversation we might want to have with this chatbot
58
+ └── src/
59
+ β”œβ”€β”€ model.py # Model loading/saving (already implemented)
60
+ └── chat.py # SchoolChatbot class (implement this)
61
+ ```
62
+
63
+ ### Key Files:
64
+
65
+ - **app.py**: Creates the web interface using Gradio. You only need to implement the `chat` function that generates responses.
66
+
67
+ - **chat.py**: Contains the `SchoolChatbot` class where you'll implement:
68
+ - `format_prompt`: Format user input into proper prompts
69
+ - `get_response`: Generate responses using the model
70
+
71
+ - **config.py**: Contains the `BASE_MODEL` and `MY_MODEL` variables, which are names of models on HuggingFace. Update the `MY_MODEL` variable if you create a new model and upload it to the HuggingFace Hub.
72
+
73
+ - **chatbot_development.ipynb**: Jupyter notebook for:
74
+ - Experimenting with the chatbot
75
+ - Trying different approaches
76
+ - Testing responses before deployment
77
+
78
+ ### What You Need to Implement:
79
+
80
+ 1. In `chat.py`:
81
+ - Complete the `SchoolChatbot` class methods
82
+ - Design how the chatbot formats prompts
83
+ - Implement response generation
84
+
85
+ 2. In `app.py`:
86
+ - Implement the `chat` function to work with Gradio
87
+ - The rest of the file is already set up
88
+
89
+ 3. Use `chatbot_development.ipynb` to:
90
+ - Develop and test your implementation
91
+ - Try different approaches
92
+ - Verify everything works before deployment
93
+
94
+ 4. After you update the code, you can run the chatbot locally:
95
  ```bash
96
  python app.py
97
  ```
98
 
99
+
100
  ## Deploying to Hugging Face
101
 
102
  To deploy your chatbot as a free web interface using Hugging Face Spaces:
 
156
 
157
  Your chatbot should now be accessible to anyone through their web browser!
158