Asankhaya Sharma
commited on
Commit
Β·
5cbd50f
1
Parent(s):
4e00df7
README.md
CHANGED
|
@@ -1,13 +1,174 @@
|
|
| 1 |
-
|
| 2 |
-
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Quivr
|
| 2 |
+
|
| 3 |
+
<p align="center">
|
| 4 |
+
<img src="../logo.png" alt="Quivr-logo" width="30%">
|
| 5 |
+
<p align="center">
|
| 6 |
+
|
| 7 |
+
<a href="https://discord.gg/HUpRgp2HG8">
|
| 8 |
+
<img src="https://img.shields.io/badge/discord-join%20chat-blue.svg" alt="Join our Discord" height="40">
|
| 9 |
+
</a>
|
| 10 |
+
|
| 11 |
+
Quivr is your second brain in the cloud, designed to easily store and retrieve unstructured information. It's like Obsidian but powered by generative AI.
|
| 12 |
+
|
| 13 |
+
## Features
|
| 14 |
+
|
| 15 |
+
- **Store Anything**: Quivr can handle almost any type of data you throw at it. Text, images, code snippets, you name it.
|
| 16 |
+
- **Generative AI**: Quivr uses advanced AI to help you generate and retrieve information.
|
| 17 |
+
- **Fast and Efficient**: Designed with speed and efficiency in mind. Quivr makes sure you can access your data as quickly as possible.
|
| 18 |
+
- **Secure**: Your data is stored securely in the cloud and is always under your control.
|
| 19 |
+
- **Compatible Files**:
|
| 20 |
+
- **Text**
|
| 21 |
+
- **Markdown**
|
| 22 |
+
- **PDF**
|
| 23 |
+
- **Audio**
|
| 24 |
+
- **Video**
|
| 25 |
+
- **Open Source**: Quivr is open source and free to use.
|
| 26 |
+
## Demo
|
| 27 |
+
|
| 28 |
+
|
| 29 |
+
### Demo with GPT3.5
|
| 30 |
+
https://github.com/StanGirard/quivr/assets/19614572/80721777-2313-468f-b75e-09379f694653
|
| 31 |
+
|
| 32 |
+
|
| 33 |
+
### Demo with Claude 100k context
|
| 34 |
+
https://github.com/StanGirard/quivr/assets/5101573/9dba918c-9032-4c8d-9eea-94336d2c8bd4
|
| 35 |
+
|
| 36 |
+
## Getting Started
|
| 37 |
+
|
| 38 |
+
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
|
| 39 |
+
|
| 40 |
+
### Prerequisites
|
| 41 |
+
|
| 42 |
+
Make sure you have the following installed before continuing:
|
| 43 |
+
|
| 44 |
+
- Python 3.10 or higher
|
| 45 |
+
- Pip
|
| 46 |
+
- Virtualenv
|
| 47 |
+
|
| 48 |
+
You'll also need a [Supabase](https://supabase.com/) account for:
|
| 49 |
+
|
| 50 |
+
- A new Supabase project
|
| 51 |
+
- Supabase Project API key
|
| 52 |
+
- Supabase Project URL
|
| 53 |
+
|
| 54 |
+
### Installing
|
| 55 |
+
|
| 56 |
+
- Clone the repository
|
| 57 |
+
|
| 58 |
+
```bash
|
| 59 |
+
git clone [email protected]:StanGirard/Quivr.git && cd Quivr
|
| 60 |
+
```
|
| 61 |
+
|
| 62 |
+
- Create a virtual environment
|
| 63 |
+
|
| 64 |
+
```bash
|
| 65 |
+
virtualenv venv
|
| 66 |
+
```
|
| 67 |
+
|
| 68 |
+
- Activate the virtual environment
|
| 69 |
+
|
| 70 |
+
```bash
|
| 71 |
+
source venv/bin/activate
|
| 72 |
+
```
|
| 73 |
+
|
| 74 |
+
- Install the dependencies
|
| 75 |
+
|
| 76 |
+
```bash
|
| 77 |
+
pip install -r requirements.txt
|
| 78 |
+
```
|
| 79 |
+
|
| 80 |
+
- Copy the streamlit secrets.toml example file
|
| 81 |
+
|
| 82 |
+
```bash
|
| 83 |
+
cp .streamlit/secrets.toml.example .streamlit/secrets.toml
|
| 84 |
+
```
|
| 85 |
+
|
| 86 |
+
- Add your credentials to .streamlit/secrets.toml file
|
| 87 |
+
|
| 88 |
+
```toml
|
| 89 |
+
supabase_url = "SUPABASE_URL"
|
| 90 |
+
supabase_service_key = "SUPABASE_SERVICE_KEY"
|
| 91 |
+
openai_api_key = "OPENAI_API_KEY"
|
| 92 |
+
anthropic_api_key = "ANTHROPIC_API_KEY" # Optional
|
| 93 |
+
```
|
| 94 |
+
|
| 95 |
+
_Note that the `supabase_service_key` is found in your Supabase dashboard under Project Settings -> API. Use the `anon` `public` key found in the `Project API keys` section._
|
| 96 |
+
|
| 97 |
+
- Run the following migration scripts on the Supabase database via the web interface (SQL Editor -> `New query`)
|
| 98 |
+
|
| 99 |
+
```sql
|
| 100 |
+
-- Enable the pgvector extension to work with embedding vectors
|
| 101 |
+
create extension vector;
|
| 102 |
+
|
| 103 |
+
-- Create a table to store your documents
|
| 104 |
+
create table documents (
|
| 105 |
+
id bigserial primary key,
|
| 106 |
+
content text, -- corresponds to Document.pageContent
|
| 107 |
+
metadata jsonb, -- corresponds to Document.metadata
|
| 108 |
+
embedding vector(1536) -- 1536 works for OpenAI embeddings, change if needed
|
| 109 |
+
);
|
| 110 |
+
|
| 111 |
+
CREATE FUNCTION match_documents(query_embedding vector(1536), match_count int)
|
| 112 |
+
RETURNS TABLE(
|
| 113 |
+
id bigint,
|
| 114 |
+
content text,
|
| 115 |
+
metadata jsonb,
|
| 116 |
+
-- we return matched vectors to enable maximal marginal relevance searches
|
| 117 |
+
embedding vector(1536),
|
| 118 |
+
similarity float)
|
| 119 |
+
LANGUAGE plpgsql
|
| 120 |
+
AS $$
|
| 121 |
+
# variable_conflict use_column
|
| 122 |
+
BEGIN
|
| 123 |
+
RETURN query
|
| 124 |
+
SELECT
|
| 125 |
+
id,
|
| 126 |
+
content,
|
| 127 |
+
metadata,
|
| 128 |
+
embedding,
|
| 129 |
+
1 -(documents.embedding <=> query_embedding) AS similarity
|
| 130 |
+
FROM
|
| 131 |
+
documents
|
| 132 |
+
ORDER BY
|
| 133 |
+
documents.embedding <=> query_embedding
|
| 134 |
+
LIMIT match_count;
|
| 135 |
+
END;
|
| 136 |
+
$$;
|
| 137 |
+
```
|
| 138 |
+
|
| 139 |
+
and
|
| 140 |
+
|
| 141 |
+
```sql
|
| 142 |
+
create table
|
| 143 |
+
stats (
|
| 144 |
+
-- A column called "time" with data type "timestamp"
|
| 145 |
+
time timestamp,
|
| 146 |
+
-- A column called "details" with data type "text"
|
| 147 |
+
chat boolean,
|
| 148 |
+
embedding boolean,
|
| 149 |
+
details text,
|
| 150 |
+
metadata jsonb,
|
| 151 |
+
-- An "integer" primary key column called "id" that is generated always as identity
|
| 152 |
+
id integer primary key generated always as identity
|
| 153 |
+
);
|
| 154 |
+
```
|
| 155 |
+
|
| 156 |
+
- Run the app
|
| 157 |
+
|
| 158 |
+
```bash
|
| 159 |
+
streamlit run main.py
|
| 160 |
+
```
|
| 161 |
+
|
| 162 |
+
## Built With
|
| 163 |
+
|
| 164 |
+
* [NextJS](https://nextjs.org/) - The React framework used.
|
| 165 |
+
* [FastAPI](https://fastapi.tiangolo.com/) - The API framework used.
|
| 166 |
+
* [Supabase](https://supabase.io/) - The open source Firebase alternative.
|
| 167 |
+
|
| 168 |
+
## Contributing
|
| 169 |
+
|
| 170 |
+
Open a pull request and we'll review it as soon as possible.
|
| 171 |
+
|
| 172 |
+
## Star History
|
| 173 |
+
|
| 174 |
+
[](https://star-history.com/#StanGirard/quivr&Date)
|
app.py
ADDED
|
@@ -0,0 +1,135 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# main.py
|
| 2 |
+
import os
|
| 3 |
+
import tempfile
|
| 4 |
+
|
| 5 |
+
import streamlit as st
|
| 6 |
+
from files import file_uploader, url_uploader
|
| 7 |
+
from question import chat_with_doc
|
| 8 |
+
from brain import brain
|
| 9 |
+
from langchain.embeddings import HuggingFaceInferenceAPIEmbeddings
|
| 10 |
+
from langchain.vectorstores import SupabaseVectorStore
|
| 11 |
+
from supabase import Client, create_client
|
| 12 |
+
from explorer import view_document
|
| 13 |
+
from stats import get_usage_today
|
| 14 |
+
|
| 15 |
+
supabase_url = st.secrets.supabase_url
|
| 16 |
+
supabase_key = st.secrets.supabase_service_key
|
| 17 |
+
openai_api_key = st.secrets.openai_api_key
|
| 18 |
+
anthropic_api_key = st.secrets.anthropic_api_key
|
| 19 |
+
hf_api_key = st.secrets.hf_api_key
|
| 20 |
+
supabase: Client = create_client(supabase_url, supabase_key)
|
| 21 |
+
self_hosted = st.secrets.self_hosted
|
| 22 |
+
|
| 23 |
+
# embeddings = OpenAIEmbeddings(openai_api_key=openai_api_key)
|
| 24 |
+
|
| 25 |
+
|
| 26 |
+
embeddings = HuggingFaceInferenceAPIEmbeddings(
|
| 27 |
+
api_key=hf_api_key,
|
| 28 |
+
model_name="BAAI/bge-large-en-v1.5"
|
| 29 |
+
)
|
| 30 |
+
|
| 31 |
+
vector_store = SupabaseVectorStore(supabase, embeddings, query_name='match_documents', table_name="documents")
|
| 32 |
+
|
| 33 |
+
models = ["llama-2"]
|
| 34 |
+
|
| 35 |
+
if openai_api_key:
|
| 36 |
+
models += ["gpt-3.5-turbo", "gpt-4"]
|
| 37 |
+
|
| 38 |
+
if anthropic_api_key:
|
| 39 |
+
models += ["claude-v1", "claude-v1.3",
|
| 40 |
+
"claude-instant-v1-100k", "claude-instant-v1.1-100k"]
|
| 41 |
+
|
| 42 |
+
# Set the theme
|
| 43 |
+
st.set_page_config(
|
| 44 |
+
page_title="meraKB",
|
| 45 |
+
layout="wide",
|
| 46 |
+
initial_sidebar_state="expanded",
|
| 47 |
+
)
|
| 48 |
+
|
| 49 |
+
|
| 50 |
+
st.title("π§ meraKB - Your digital brain π§ ")
|
| 51 |
+
st.markdown("Store your knowledge in a vector store and chat with it.")
|
| 52 |
+
if self_hosted == "false":
|
| 53 |
+
st.markdown('**π’ Note: In the public demo, access to functionality is restricted. You can only use the GPT-3.5-turbo model and upload files up to 1Mb. To use more models and upload larger files, consider self-hosting meraKB.**')
|
| 54 |
+
|
| 55 |
+
st.markdown("---\n\n")
|
| 56 |
+
|
| 57 |
+
st.session_state["overused"] = False
|
| 58 |
+
if self_hosted == "false":
|
| 59 |
+
usage = get_usage_today(supabase)
|
| 60 |
+
if usage > st.secrets.usage_limit:
|
| 61 |
+
st.markdown(
|
| 62 |
+
f"<span style='color:red'>You have used {usage} tokens today, which is more than your daily limit of {st.secrets.usage_limit} tokens. Please come back later or consider self-hosting.</span>", unsafe_allow_html=True)
|
| 63 |
+
st.session_state["overused"] = True
|
| 64 |
+
else:
|
| 65 |
+
st.markdown(f"<span style='color:blue'>Usage today: {usage} tokens out of {st.secrets.usage_limit}</span>", unsafe_allow_html=True)
|
| 66 |
+
st.write("---")
|
| 67 |
+
|
| 68 |
+
|
| 69 |
+
|
| 70 |
+
|
| 71 |
+
# Initialize session state variables
|
| 72 |
+
if 'model' not in st.session_state:
|
| 73 |
+
st.session_state['model'] = "llama-2"
|
| 74 |
+
if 'temperature' not in st.session_state:
|
| 75 |
+
st.session_state['temperature'] = 0.1
|
| 76 |
+
if 'chunk_size' not in st.session_state:
|
| 77 |
+
st.session_state['chunk_size'] = 500
|
| 78 |
+
if 'chunk_overlap' not in st.session_state:
|
| 79 |
+
st.session_state['chunk_overlap'] = 0
|
| 80 |
+
if 'max_tokens' not in st.session_state:
|
| 81 |
+
st.session_state['max_tokens'] = 500
|
| 82 |
+
|
| 83 |
+
# Create a radio button for user to choose between adding knowledge or asking a question
|
| 84 |
+
user_choice = st.radio(
|
| 85 |
+
"Choose an action", ('Add Knowledge', 'Chat with your Brain', 'Forget', "Explore"))
|
| 86 |
+
|
| 87 |
+
st.markdown("---\n\n")
|
| 88 |
+
|
| 89 |
+
if user_choice == 'Add Knowledge':
|
| 90 |
+
# Display chunk size and overlap selection only when adding knowledge
|
| 91 |
+
st.sidebar.title("Configuration")
|
| 92 |
+
st.sidebar.markdown(
|
| 93 |
+
"Choose your chunk size and overlap for adding knowledge.")
|
| 94 |
+
st.session_state['chunk_size'] = st.sidebar.slider(
|
| 95 |
+
"Select Chunk Size", 100, 1000, st.session_state['chunk_size'], 50)
|
| 96 |
+
st.session_state['chunk_overlap'] = st.sidebar.slider(
|
| 97 |
+
"Select Chunk Overlap", 0, 100, st.session_state['chunk_overlap'], 10)
|
| 98 |
+
|
| 99 |
+
# Create two columns for the file uploader and URL uploader
|
| 100 |
+
col1, col2 = st.columns(2)
|
| 101 |
+
|
| 102 |
+
with col1:
|
| 103 |
+
file_uploader(supabase, vector_store)
|
| 104 |
+
with col2:
|
| 105 |
+
url_uploader(supabase, vector_store)
|
| 106 |
+
elif user_choice == 'Chat with your Brain':
|
| 107 |
+
# Display model and temperature selection only when asking questions
|
| 108 |
+
st.sidebar.title("Configuration")
|
| 109 |
+
st.sidebar.markdown(
|
| 110 |
+
"Choose your model and temperature for asking questions.")
|
| 111 |
+
if self_hosted != "false":
|
| 112 |
+
st.session_state['model'] = st.sidebar.selectbox(
|
| 113 |
+
"Select Model", models, index=(models).index(st.session_state['model']))
|
| 114 |
+
else:
|
| 115 |
+
st.sidebar.write("**Model**: gpt-3.5-turbo")
|
| 116 |
+
st.sidebar.write("**Self Host to unlock more models such as claude-v1 and GPT4**")
|
| 117 |
+
st.session_state['model'] = "gpt-3.5-turbo"
|
| 118 |
+
st.session_state['temperature'] = st.sidebar.slider(
|
| 119 |
+
"Select Temperature", 0.1, 1.0, st.session_state['temperature'], 0.1)
|
| 120 |
+
if st.secrets.self_hosted != "false":
|
| 121 |
+
st.session_state['max_tokens'] = st.sidebar.slider(
|
| 122 |
+
"Select Max Tokens", 500, 4000, st.session_state['max_tokens'], 500)
|
| 123 |
+
else:
|
| 124 |
+
st.session_state['max_tokens'] = 500
|
| 125 |
+
|
| 126 |
+
chat_with_doc(st.session_state['model'], vector_store, stats_db=supabase)
|
| 127 |
+
elif user_choice == 'Forget':
|
| 128 |
+
st.sidebar.title("Configuration")
|
| 129 |
+
|
| 130 |
+
brain(supabase)
|
| 131 |
+
elif user_choice == 'Explore':
|
| 132 |
+
st.sidebar.title("Configuration")
|
| 133 |
+
view_document(supabase)
|
| 134 |
+
|
| 135 |
+
st.markdown("---\n\n")
|