BGarida commited on
Commit
cc7e5fb
·
1 Parent(s): cc7aae4

Deploying PDF Version v23

Browse files
Files changed (3) hide show
  1. .chainlit/config.toml +2 -2
  2. BuildingAChainlitApp.md +0 -206
  3. README.md +2 -111
.chainlit/config.toml CHANGED
@@ -20,7 +20,7 @@ prompt_playground = true
20
 
21
  [UI]
22
  # Name of the app and chatbot.
23
- name = "Chatbot"
24
 
25
  # Description of the app and chatbot. This is used for HTML tags.
26
  # description = ""
@@ -32,7 +32,7 @@ default_collapse_content = true
32
  default_expand_messages = false
33
 
34
  # Hide the chain of thought details from the user in the UI.
35
- hide_cot = false
36
 
37
  # Link to your github repo. This will add a github button in the UI's header.
38
  # github = ""
 
20
 
21
  [UI]
22
  # Name of the app and chatbot.
23
+ name = "Muse"
24
 
25
  # Description of the app and chatbot. This is used for HTML tags.
26
  # description = ""
 
32
  default_expand_messages = false
33
 
34
  # Hide the chain of thought details from the user in the UI.
35
+ hide_cot = true
36
 
37
  # Link to your github repo. This will add a github button in the UI's header.
38
  # github = ""
BuildingAChainlitApp.md CHANGED
@@ -1,214 +1,8 @@
1
  # Building a Chainlit App
2
 
3
- What if we want to take our Week 1 Day 2 assignment - [Pythonic RAG](https://github.com/AI-Maker-Space/AIE4/tree/main/Week%201/Day%202) - and bring it out of the notebook?
4
-
5
- Well - we'll cover exactly that here!
6
-
7
  ## Anatomy of a Chainlit Application
8
 
9
  [Chainlit](https://docs.chainlit.io/get-started/overview) is a Python package similar to Streamlit that lets users write a backend and a front end in a single (or multiple) Python file(s). It is mainly used for prototyping LLM-based Chat Style Applications - though it is used in production in some settings with 1,000,000s of MAUs (Monthly Active Users).
10
 
11
  The primary method of customizing and interacting with the Chainlit UI is through a few critical [decorators](https://blog.hubspot.com/website/decorators-in-python).
12
 
13
- > NOTE: Simply put, the decorators (in Chainlit) are just ways we can "plug-in" to the functionality in Chainlit.
14
-
15
- We'll be concerning ourselves with three main scopes:
16
-
17
- 1. On application start - when we start the Chainlit application with a command like `chainlit run app.py`
18
- 2. On chat start - when a chat session starts (a user opens the web browser to the address hosting the application)
19
- 3. On message - when the users sends a message through the input text box in the Chainlit UI
20
-
21
- Let's dig into each scope and see what we're doing!
22
-
23
- ## On Application Start:
24
-
25
- The first thing you'll notice is that we have the traditional "wall of imports" this is to ensure we have everything we need to run our application.
26
-
27
- ```python
28
- import os
29
- from typing import List
30
- from chainlit.types import AskFileResponse
31
- from aimakerspace.text_utils import CharacterTextSplitter, TextFileLoader
32
- from aimakerspace.openai_utils.prompts import (
33
- UserRolePrompt,
34
- SystemRolePrompt,
35
- AssistantRolePrompt,
36
- )
37
- from aimakerspace.openai_utils.embedding import EmbeddingModel
38
- from aimakerspace.vectordatabase import VectorDatabase
39
- from aimakerspace.openai_utils.chatmodel import ChatOpenAI
40
- import chainlit as cl
41
- ```
42
-
43
- Next up, we have some prompt templates. As all sessions will use the same prompt templates without modification, and we don't need these templates to be specific per template - we can set them up here - at the application scope.
44
-
45
- ```python
46
- system_template = """\
47
- Use the following context to answer a users question. If you cannot find the answer in the context, say you don't know the answer."""
48
- system_role_prompt = SystemRolePrompt(system_template)
49
-
50
- user_prompt_template = """\
51
- Context:
52
- {context}
53
-
54
- Question:
55
- {question}
56
- """
57
- user_role_prompt = UserRolePrompt(user_prompt_template)
58
- ```
59
-
60
- > NOTE: You'll notice that these are the exact same prompt templates we used from the Pythonic RAG Notebook in Week 1 Day 2!
61
-
62
- Following that - we can create the Python Class definition for our RAG pipeline - or *chain*, as we'll refer to it in the rest of this walkthrough.
63
-
64
- Let's look at the definition first:
65
-
66
- ```python
67
- class RetrievalAugmentedQAPipeline:
68
- def __init__(self, llm: ChatOpenAI(), vector_db_retriever: VectorDatabase) -> None:
69
- self.llm = llm
70
- self.vector_db_retriever = vector_db_retriever
71
-
72
- async def arun_pipeline(self, user_query: str):
73
- ### RETRIEVAL
74
- context_list = self.vector_db_retriever.search_by_text(user_query, k=4)
75
-
76
- context_prompt = ""
77
- for context in context_list:
78
- context_prompt += context[0] + "\n"
79
-
80
- ### AUGMENTED
81
- formatted_system_prompt = system_role_prompt.create_message()
82
-
83
- formatted_user_prompt = user_role_prompt.create_message(question=user_query, context=context_prompt)
84
-
85
-
86
- ### GENERATION
87
- async def generate_response():
88
- async for chunk in self.llm.astream([formatted_system_prompt, formatted_user_prompt]):
89
- yield chunk
90
-
91
- return {"response": generate_response(), "context": context_list}
92
- ```
93
-
94
- Notice a few things:
95
-
96
- 1. We have modified this `RetrievalAugmentedQAPipeline` from the initial notebook to support streaming.
97
- 2. In essence, our pipeline is *chaining* a few events together:
98
- 1. We take our user query, and chain it into our Vector Database to collect related chunks
99
- 2. We take those contexts and our user's questions and chain them into the prompt templates
100
- 3. We take that prompt template and chain it into our LLM call
101
- 4. We chain the response of the LLM call to the user
102
- 3. We are using a lot of `async` again!
103
-
104
- Now, we're going to create a helper function for processing uploaded text files.
105
-
106
- First, we'll instantiate a shared `CharacterTextSplitter`.
107
-
108
- ```python
109
- text_splitter = CharacterTextSplitter()
110
- ```
111
-
112
- Now we can define our helper.
113
-
114
- ```python
115
- def process_text_file(file: AskFileResponse):
116
- import tempfile
117
-
118
- with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".txt") as temp_file:
119
- temp_file_path = temp_file.name
120
-
121
- with open(temp_file_path, "wb") as f:
122
- f.write(file.content)
123
-
124
- text_loader = TextFileLoader(temp_file_path)
125
- documents = text_loader.load_documents()
126
- texts = text_splitter.split_texts(documents)
127
- return texts
128
- ```
129
-
130
- Simply put, this downloads the file as a temp file, we load it in with `TextFileLoader` and then split it with our `TextSplitter`, and returns that list of strings!
131
-
132
- #### QUESTION #1:
133
-
134
- Why do we want to support streaming? What about streaming is important, or useful?
135
-
136
- ## On Chat Start:
137
-
138
- The next scope is where "the magic happens". On Chat Start is when a user begins a chat session. This will happen whenever a user opens a new chat window, or refreshes an existing chat window.
139
-
140
- You'll see that our code is set-up to immediately show the user a chat box requesting them to upload a file.
141
-
142
- ```python
143
- while files == None:
144
- files = await cl.AskFileMessage(
145
- content="Please upload a Text File file to begin!",
146
- accept=["text/plain"],
147
- max_size_mb=2,
148
- timeout=180,
149
- ).send()
150
- ```
151
-
152
- Once we've obtained the text file - we'll use our processing helper function to process our text!
153
-
154
- After we have processed our text file - we'll need to create a `VectorDatabase` and populate it with our processed chunks and their related embeddings!
155
-
156
- ```python
157
- vector_db = VectorDatabase()
158
- vector_db = await vector_db.abuild_from_list(texts)
159
- ```
160
-
161
- Once we have that piece completed - we can create the chain we'll be using to respond to user queries!
162
-
163
- ```python
164
- retrieval_augmented_qa_pipeline = RetrievalAugmentedQAPipeline(
165
- vector_db_retriever=vector_db,
166
- llm=chat_openai
167
- )
168
- ```
169
-
170
- Now, we'll save that into our user session!
171
-
172
- > NOTE: Chainlit has some great documentation about [User Session](https://docs.chainlit.io/concepts/user-session).
173
-
174
- ### QUESTION #2:
175
-
176
- Why are we using User Session here? What about Python makes us need to use this? Why not just store everything in a global variable?
177
-
178
- ## On Message
179
-
180
- First, we load our chain from the user session:
181
-
182
- ```python
183
- chain = cl.user_session.get("chain")
184
- ```
185
-
186
- Then, we run the chain on the content of the message - and stream it to the front end - that's it!
187
-
188
- ```python
189
- msg = cl.Message(content="")
190
- result = await chain.arun_pipeline(message.content)
191
-
192
- async for stream_resp in result["response"]:
193
- await msg.stream_token(stream_resp)
194
- ```
195
-
196
- ## 🎉
197
-
198
- With that - you've created a Chainlit application that moves our Pythonic RAG notebook to a Chainlit application!
199
-
200
- ## 🚧 CHALLENGE MODE 🚧
201
-
202
- For an extra challenge - modify the behaviour of your applciation by integrating changes you made to your Pythonic RAG notebook (using new retrieval methods, etc.)
203
-
204
- If you're still looking for a challenge, or didn't make any modifications to your Pythonic RAG notebook:
205
-
206
- 1) Allow users to upload PDFs (this will require you to build a PDF parser as well)
207
- 2) Modify the VectorStore to leverage [Qdrant](https://python-client.qdrant.tech/)
208
-
209
- > NOTE: The motivation for these challenges is simple - the beginning of the course is extremely information dense, and people come from all kinds of different technical backgrounds. In order to ensure that all learners are able to engage with the content confidently and comfortably, we want to focus on the basic units of technical competency required. This leads to a situation where some learners, who came in with more robust technical skills, find the introductory material to be too simple - and these open-ended challenges help us do this!
210
-
211
-
212
-
213
-
214
-
 
1
  # Building a Chainlit App
2
 
 
 
 
 
3
  ## Anatomy of a Chainlit Application
4
 
5
  [Chainlit](https://docs.chainlit.io/get-started/overview) is a Python package similar to Streamlit that lets users write a backend and a front end in a single (or multiple) Python file(s). It is mainly used for prototyping LLM-based Chat Style Applications - though it is used in production in some settings with 1,000,000s of MAUs (Monthly Active Users).
6
 
7
  The primary method of customizing and interacting with the Chainlit UI is through a few critical [decorators](https://blog.hubspot.com/website/decorators-in-python).
8
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
README.md CHANGED
@@ -1,118 +1,9 @@
1
  ---
2
- title: DeployPythonicRAG
3
  emoji: 📉
4
  colorFrom: blue
5
  colorTo: purple
6
  sdk: docker
7
  pinned: false
8
  license: apache-2.0
9
- ---
10
-
11
- # Deploying Pythonic Chat With Your Text File Application
12
-
13
- In today's breakout rooms, we will be following the processed that you saw during the challenge - for reference, the instructions for that are available [here](https://github.com/AI-Maker-Space/Beyond-ChatGPT/tree/main).
14
-
15
- Today, we will repeat the same process - but powered by our Pythonic RAG implementation we created last week.
16
-
17
- You'll notice a few differences in the `app.py` logic - as well as a few changes to the `aimakerspace` package to get things working smoothly with Chainlit.
18
-
19
- ## Reference Diagram (It's Busy, but it works)
20
-
21
- ![image](https://i.imgur.com/IaEVZG2.png)
22
-
23
- ## Deploying the Application to Hugging Face Space
24
-
25
- Due to the way the repository is created - it should be straightforward to deploy this to a Hugging Face Space!
26
-
27
- > NOTE: If you wish to go through the local deployments using `chainlit run app.py` and Docker - please feel free to do so!
28
-
29
- <details>
30
- <summary>Creating a Hugging Face Space</summary>
31
-
32
- 1. Navigate to the `Spaces` tab.
33
-
34
- ![image](https://i.imgur.com/aSMlX2T.png)
35
-
36
- 2. Click on `Create new Space`
37
-
38
- ![image](https://i.imgur.com/YaSSy5p.png)
39
-
40
- 3. Create the Space by providing values in the form. Make sure you've selected "Docker" as your Space SDK.
41
-
42
- ![image](https://i.imgur.com/6h9CgH6.png)
43
-
44
- </details>
45
-
46
- <details>
47
- <summary>Adding this Repository to the Newly Created Space</summary>
48
-
49
- 1. Collect the SSH address from the newly created Space.
50
-
51
- ![image](https://i.imgur.com/Oag0m8E.png)
52
-
53
- > NOTE: The address is the component that starts with `git@hf.co:spaces/`.
54
-
55
- 2. Use the command:
56
-
57
- ```bash
58
- git remote add hf HF_SPACE_SSH_ADDRESS_HERE
59
- ```
60
-
61
- 3. Use the command:
62
-
63
- ```bash
64
- git pull hf main --no-rebase --allow-unrelated-histories -X ours
65
- ```
66
-
67
- 4. Use the command:
68
-
69
- ```bash
70
- git add .
71
- ```
72
-
73
- 5. Use the command:
74
-
75
- ```bash
76
- git commit -m "Deploying Pythonic RAG"
77
- ```
78
-
79
- 6. Use the command:
80
-
81
- ```bash
82
- git push hf main
83
- ```
84
-
85
- 7. The Space should automatically build as soon as the push is completed!
86
-
87
- > NOTE: The build will fail before you complete the following steps!
88
-
89
- </details>
90
-
91
- <details>
92
- <summary>Adding OpenAI Secrets to the Space</summary>
93
-
94
- 1. Navigate to your Space settings.
95
-
96
- ![image](https://i.imgur.com/zh0a2By.png)
97
-
98
- 2. Navigate to `Variables and secrets` on the Settings page and click `New secret`:
99
-
100
- ![image](https://i.imgur.com/g2KlZdz.png)
101
-
102
- 3. In the `Name` field - input `OPENAI_API_KEY` in the `Value (private)` field, put your OpenAI API Key.
103
-
104
- ![image](https://i.imgur.com/eFcZ8U3.png)
105
-
106
- 4. The Space will begin rebuilding!
107
-
108
- </details>
109
-
110
- ## 🎉
111
-
112
- You just deployed Pythonic RAG!
113
-
114
- Try uploading a text file and asking some questions!
115
-
116
- ## 🚧CHALLENGE MODE 🚧
117
-
118
- For more of a challenge, please reference [Building a Chainlit App](./BuildingAChainlitApp.md)!
 
1
  ---
2
+ title: TalkWithPDFs
3
  emoji: 📉
4
  colorFrom: blue
5
  colorTo: purple
6
  sdk: docker
7
  pinned: false
8
  license: apache-2.0
9
+ ---