2023-05-21 15:53:47 +03:00
# Quivr - Your Second Brain, Empowered by Generative AI
2023-05-13 03:02:45 +03:00
2023-05-21 15:53:47 +03:00
< div align = "center" >
< img src = "./logo.png" alt = "Quivr-logo" width = "30%" style = "border-radius: 50%; padding-bottom: 20px" / >
< / div >
2023-05-13 03:02:45 +03:00
2023-08-06 01:33:48 +03:00
[![Discord Follow ](https://dcbadge.vercel.app/api/server/HUpRgp2HG8?style=flat )](https://discord.gg/HUpRgp2HG8)
[![GitHub Repo stars ](https://img.shields.io/github/stars/stangirard/quivr?style=social )](https://github.com/stangirard/quivr)
[![Twitter Follow ](https://img.shields.io/twitter/follow/StanGirard?style=social )](https://twitter.com/_StanGirard)
2023-05-15 10:28:25 +03:00
2023-11-06 21:52:35 +03:00
Quivr, your second brain, utilizes the power of GenerativeAI to be your personal assistant ! Think of it as Obsidian, but turbocharged with AI capabilities.
2023-05-21 02:20:55 +03:00
2023-07-31 10:04:42 +03:00
[Roadmap here ](https://brain.quivr.app/docs/roadmap )
2023-06-05 17:15:34 +03:00
2023-05-21 15:53:47 +03:00
## Key Features 🎯
2023-05-13 03:02:45 +03:00
2023-05-21 15:53:47 +03:00
- **Fast and Efficient**: Designed with speed and efficiency at its core. Quivr ensures rapid access to your data.
- **Secure**: Your data, your control. Always.
2023-10-27 10:38:44 +03:00
- **OS Compatible**: Ubuntu 22 or newer.
2023-11-06 21:52:35 +03:00
- **File Compatibility**: Text, Markdown, PDF, Powerpoint, Excel, CSV, Word, Audio, Video
2023-07-12 10:24:38 +03:00
- **Open Source**: Freedom is beautiful, and so is Quivr. Open source and free to use.
2023-11-06 21:52:35 +03:00
- **Public/Private**: Share your brains with your users via a public link, or keep them private.
- **Marketplace**: Share your brains with the world, or use other people's brains to boost your productivity.
2023-11-29 10:43:06 +03:00
- **Offline Mode**: Quivr works offline, so you can access your data anytime, anywhere.
2023-05-13 03:02:45 +03:00
2023-05-21 15:53:47 +03:00
## Demo Highlights 🎥
2023-05-13 03:16:41 +03:00
2023-05-21 03:08:21 +03:00
https://github.com/StanGirard/quivr/assets/19614572/a6463b73-76c7-4bc0-978d-70562dca71f5
2023-08-01 15:48:20 +03:00
2023-07-12 10:24:38 +03:00
## Getting Started 🚀
2023-05-13 03:02:45 +03:00
2023-05-21 15:53:47 +03:00
Follow these instructions to get a copy of the project up and running on your local machine for development and testing purposes.
2023-05-21 02:20:55 +03:00
2023-07-12 10:24:38 +03:00
You can find everything on the [documentation ](https://brain.quivr.app/ ).
2023-05-13 03:02:45 +03:00
2023-05-21 15:53:47 +03:00
### Prerequisites 📋
2023-05-13 03:02:45 +03:00
2023-07-12 10:24:38 +03:00
Ensure you have the following installed:
2023-05-13 03:02:45 +03:00
2023-05-21 02:20:55 +03:00
- Docker
- Docker Compose
2023-05-19 01:44:09 +03:00
2023-05-13 03:02:45 +03:00
2023-12-02 02:32:06 +03:00
### 60 seconds Installation 💽
2023-05-21 15:53:47 +03:00
- **Step 1**: Clone the repository using **one** of these commands:
2023-05-13 03:02:45 +03:00
2023-05-21 15:53:47 +03:00
- If you don't have an SSH key set up:
2023-07-19 16:58:00 +03:00
2023-05-21 10:21:12 +03:00
```bash
git clone https://github.com/StanGirard/Quivr.git & & cd Quivr
```
2023-07-19 16:58:00 +03:00
2023-05-21 15:53:47 +03:00
- If you have an SSH key set up or want to add it ([guide here](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account))
2023-07-19 16:58:00 +03:00
2023-05-21 10:21:12 +03:00
```bash
git clone git@github.com:StanGirard/Quivr.git & & cd Quivr
```
2023-05-13 03:02:45 +03:00
2023-12-02 02:26:06 +03:00
- **Step 2**: Install prerequisites:
2023-07-19 16:58:00 +03:00
```bash
2023-09-27 10:28:59 +03:00
brew install gum # Windows (via Scoop) scoop install charm-gum
brew install postgresql # Windows (via Scoop) scoop install postgresql
```
2023-07-19 16:58:00 +03:00
2023-07-03 10:50:39 +03:00
2023-09-27 10:28:59 +03:00
2023-12-02 02:26:06 +03:00
- **Step 3**: Copy the `.env.example` files
2023-05-13 03:13:56 +03:00
2023-07-19 16:58:00 +03:00
```bash
2023-12-02 02:26:06 +03:00
cp .env.example .env
2023-07-19 16:58:00 +03:00
```
2023-12-02 02:26:06 +03:00
- **Step 4**: Update the `.env` files
2023-07-19 16:58:00 +03:00
2023-12-02 02:26:06 +03:00
Update **OPENAI_API_KEY** in the `.env` file.
2023-05-13 03:13:56 +03:00
2023-12-02 02:26:06 +03:00
You just need to update the `OPENAI_API_KEY` variable in the `.env` file. You can get your API key [here ](https://platform.openai.com/api-keys ). You need to create an account first. And put your credit card information. Don't worry, you won't be charged unless you use the API. You can find more information about the pricing [here ](https://openai.com/pricing/ ).
2023-05-13 03:13:56 +03:00
2023-12-02 02:32:06 +03:00
```bash
vim .env # or emacs or vscode or nano
```
Quivr can be installed offline and is compatible with [Ollama.ai ](https://ollama.ai ) , in order to do so, follow the instructions [here ](https://brain.quivr.app/docs/Developers/selfHosted/run_fully_local ). It requires some technical expertise. If you need help, feel free to join our [Discord ](https://discord.gg/HUpRgp2HG8 ) and ask for help. The OPENAI_API_KEY is still required if you install Quivr offline but you can put whatever you want in the `.env` file.
2023-12-02 02:26:06 +03:00
- **Step 5**: Launch the db
2023-07-19 16:58:00 +03:00
2023-12-02 02:26:06 +03:00
```bash
docker compose pull
docker compose up db -d
```
2023-06-01 17:01:27 +03:00
2023-12-02 02:26:06 +03:00
- **Step 6**: Use the `migration.sh` script to run the migration scripts
2023-07-19 16:58:00 +03:00
```bash
chmod +x migration.sh
./migration.sh
2023-12-02 02:26:06 +03:00
# Select 1) Create all tables
2023-07-19 16:58:00 +03:00
```
2023-07-31 10:06:13 +03:00
Choose either `Create all tables` if it's your first time or `Run migrations`
if you are updating your database.
2023-11-02 11:49:37 +03:00
Alternatively, you can run the script on the Supabase database via the web
2023-07-31 10:06:13 +03:00
interface (SQL Editor -> `New query` -> paste the script -> `Run` )
2023-07-03 12:11:29 +03:00
2023-07-19 16:58:00 +03:00
All the scripts can be found in the [scripts ](scripts/ ) folder
2023-06-11 20:57:54 +03:00
2023-12-02 02:26:06 +03:00
- **Step 7**: Launch the app
2023-05-13 03:13:56 +03:00
2023-07-19 16:58:00 +03:00
```bash
2023-09-08 12:17:59 +03:00
docker compose up --build
2023-07-19 16:58:00 +03:00
```
2023-05-13 03:02:45 +03:00
2023-12-02 02:26:06 +03:00
- **Step 8**: Navigate to `localhost:8000` in your browser
2023-12-01 00:31:11 +03:00
2023-12-02 02:26:06 +03:00
Once Quivr is running, you need to create an account to access the app. User is `admin` and password is `admin` . Go to [http://localhost:8000/project/default/auth/users ](http://localhost:8000/project/default/auth/users ) and create a new user in the `Users` section. You can then log in with your new user.
2023-05-21 15:53:47 +03:00
2023-12-02 02:26:06 +03:00
- **Step 9**: Login to the app
2023-06-04 00:12:42 +03:00
2023-12-02 02:26:06 +03:00
You can now sign in to the app with your new user. You can access the app at [http://localhost:3000/login ](http://localhost:3000/login ).
2023-05-21 15:53:47 +03:00
## Contributors ✨
2023-07-12 10:24:38 +03:00
Thanks go to these wonderful people:
2023-07-22 14:01:15 +03:00
< a href = "https://github.com/stangirard/quivr/graphs/contributors" >
2023-07-19 16:58:00 +03:00
< img src = "https://contrib.rocks/image?repo=stangirard/quivr" / >
2023-05-21 15:53:47 +03:00
< / a >
## Contribute 🤝
2023-05-13 03:02:45 +03:00
2023-11-02 11:49:37 +03:00
Did you get a pull request? Open it, and we'll review it as soon as possible. Check out our project board [here ](https://github.com/users/StanGirard/projects/5 ) to see what we're currently focused on, and feel free to bring your fresh ideas to the table!
2023-05-13 03:13:56 +03:00
2023-05-21 15:53:47 +03:00
- [Open Issues ](https://github.com/StanGirard/quivr/issues )
- [Open Pull Requests ](https://github.com/StanGirard/quivr/pulls )
- [Good First Issues ](https://github.com/StanGirard/quivr/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22 )
- [Frontend Issues ](https://github.com/StanGirard/quivr/issues?q=is%3Aopen+is%3Aissue+label%3Afrontend )
- [Backend Issues ](https://github.com/StanGirard/quivr/issues?q=is%3Aopen+is%3Aissue+label%3Abackend )
2023-06-30 10:40:21 +03:00
2023-07-01 18:22:28 +03:00
## Sponsors ❤️
2023-11-02 11:49:37 +03:00
This project would not be possible without the support of our sponsors. Thank you for your support!
2023-07-01 18:22:28 +03:00
< a href = "https://www.theodo.fr/" >
2023-07-01 19:50:02 +03:00
< img src = "https://avatars.githubusercontent.com/u/332041?s=200&v=4" alt = "Theodo" style = "padding: 10px" width = "70px" >
2023-07-01 18:22:28 +03:00
< / a >
< a href = "https://www.padok.fr/" >
2023-07-01 19:50:02 +03:00
< img src = "https://avatars.githubusercontent.com/u/46325765?s=200&v=4" alt = "Padok" style = "padding: 10px" width = "70px" >
2023-07-01 18:22:28 +03:00
< / a >
< a href = "https://www.aleios.com/" >
2023-07-01 19:50:02 +03:00
< img src = "https://avatars.githubusercontent.com/u/97908131?s=200&v=4" alt = "Aleios" style = "padding: 10px" width = "70px" >
2023-07-01 18:22:28 +03:00
< / a >
2023-07-01 19:52:01 +03:00
< a href = "https://www.bam.tech/" >
< img src = "https://avatars.githubusercontent.com/u/9597329?s=200&v=4" alt = "BAM" style = "padding: 10px" width = "70px" >
< / a >
2023-07-11 15:41:28 +03:00
< a href = "https://www.sicara.fr/" >
< img src = "https://avatars.githubusercontent.com/u/23194788?s=200&v=4" alt = "Sicara" style = "padding: 10px" width = "70px" >
< / a >
2023-07-01 18:22:28 +03:00
## License 📄
2023-07-05 19:19:25 +03:00
This project is licensed under the Apache 2.0 License - see the [LICENSE ](LICENSE ) file for details
2023-07-01 18:22:28 +03:00
2023-06-30 10:40:21 +03:00
## Stars History 📈
[![Star History Chart ](https://api.star-history.com/svg?repos=StanGirard/quivr&type=Timeline )](https://star-history.com/#StanGirard/quivr& Timeline)