Skip to content

Commit c9594f3

Browse files
committed
Merge branch '1.0.0'
1 parent a8bf29f commit c9594f3

File tree

390 files changed

+9099
-6658
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

390 files changed

+9099
-6658
lines changed

.gitignore

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ __pycache__
55
.python-version
66
*.egg-info
77
venv
8+
venv*
89
dist
910
build
1011
~
@@ -16,4 +17,6 @@ verba_config.json
1617
text-generation-inference
1718
test.py
1819
cache.txt
19-
.ruff_cache
20+
.ruff_cache
21+
*_secrets.json
22+
ollama

CHANGELOG.md

Lines changed: 67 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,43 +2,101 @@
22

33
All notable changes to this project will be documented in this file.
44

5+
## [1.0.0] - Beautiful Verba Update
6+
7+
### Added
8+
9+
- Added DaisyUI
10+
- Optimized frontend codebase
11+
- Fully Reworked Verba Design
12+
- Fully Responsive, optimized for all screen sizes
13+
- Customization Capabilities
14+
- Added Default, Darkmode, Weaviate themes
15+
- Full text, color, image customization
16+
- Improve Chat Interface
17+
- Better formatting of markdown + code
18+
- Keep conversations saved in localBrowser storage
19+
- Better Debugging by providing more information about current states
20+
- Improve Document Viewer Interface
21+
- Add Pagination
22+
- Add Sorting
23+
- Use Aggregation for Filtering
24+
- Improve Status Overview
25+
- Reworked Frontend + Optimize Code
26+
- Sort status entries
27+
- Improve Loading Speed by using Aggregation
28+
- Improve Component Selection for both Ingestion and RAG
29+
- Added new configuraiton that will be passed between frontend and backend
30+
- Cleaned codebase, merged interfaces and managers to single files
31+
- Added clean endpoints for better code readability
32+
- Reworked on interfaces
33+
- Added better console and logging for ingestion
34+
- More Configuration
35+
- Enable/Disable Caching and Autocomplete Suggestions
36+
- Improved verba_config.json
37+
- Ability to enable/disable caching + autosuggestions
38+
- Add Google Gemini as new Embedder and Generator
39+
- Added .CSV support (all file types available in Unstructured IO)
40+
- More test data
41+
- Add Ollama as Generator and Embedding Component
42+
- Add Support for Cohere R+
43+
- Improved WindowRetriever Context Generation
44+
- Show RAW Context in Frontend + Save in LocalStorage
45+
- Save Settings and Configuration in Weaviate
46+
47+
### Changed
48+
49+
- Changed to AppRouter framework
50+
- Changed frontend project structure
51+
- Changed backend project structure
52+
- Removed Llama Generator Component
53+
54+
### Fixed
55+
56+
- Using Accelerator Library
57+
558
## [0.4.0] - 11.04.2024
659

760
### Added
61+
862
- Improved Docker Documentation
963
- Improved Docker Settings
1064
- New Environment Variables for OpenAI proxies: OpenAI_BASE_URL (LiteLLM support) (https://github.com/weaviate/Verba/issues/56)
1165
- Increased version
1266

1367
### Changed
68+
1469
- Removed spaCy from project
1570

1671
### Fixed
72+
1773
- Python not working on version 3.12, 3.11, and 3.9
1874
- GitHub Links on README
1975
- Fix Docker Default Vectorizer (https://github.com/weaviate/Verba/issues/50)
2076
- Fix requirements.txt spelling error
2177
- Minor Bug fixes
2278

23-
2479
## [0.3.1] - 15.11.2023
2580

2681
### Added
82+
2783
- PDFReader powered by PyPDF2
2884
- TokenChunker powered by tiktoken
2985
- Ruff Linting (set as pre-commit)
3086
- Markdown Formatting for chat messages (https://github.com/weaviate/Verba/issues/48)
3187

3288
### Fixed
89+
3390
- Added missing dependencies
3491
- Fixed restart bug
3592
- Fixed MiniLM Cuda to_device bug (https://github.com/weaviate/Verba/issues/41)
3693
- Fixed Config Issues (https://github.com/weaviate/Verba/issues/51)
37-
- Fixed Weaviate Embedded Headers for Cohere
94+
- Fixed Weaviate Embedded Headers for Cohere
3895

3996
## [0.3.0] - 12.09.2023
4097

4198
### Added
99+
42100
- Refactor modular architecture
43101
- Add ability to import data through the frontend, CLI, and script
44102
- Add Readers (SimpleReader, PathReader, GithubReader, PDFReader)
@@ -57,32 +115,37 @@ All notable changes to this project will be documented in this file.
57115
- Added technical docs and contribution guidelines
58116

59117
### Fixed
118+
60119
- Error handling for data ingestion (handling chunk size)
61120
- Schmea handling on startup
62121

63122
### Changed
123+
64124
- Removed Simple- and AdvancedEngine logic
65125

66126
## [0.2.3] - 05.09.2023
67127

68128
### Added
129+
69130
- OpenAI API documentation example dataset
70131

71132
## [0.2.2] - 31.08.2023
72133

73134
### Release!
135+
74136
- First version of Verba released! (many to come :)
75137

76138
### Added
139+
77140
- Verba favicon
78141

79142
### Fixed
143+
80144
- Add static files to package
81145
- Weaviate Embedded not shutting down
82146

83147
## [0.1.0] - 29.08.2023
84148

85149
### Added
86-
- Prepare Verba for first release
87-
88150

151+
- Prepare Verba for first release

Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
FROM python:3.10
1+
FROM python:3.11
22
WORKDIR /Verba
33
COPY . /Verba
44
RUN pip install -e '.'

FRONTEND.md

Lines changed: 14 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,25 @@
1-
# 🎨 Verba - Frontend Documentation 🎨
1+
# Verba - Frontend Documentation
22

3-
Welcome to the Verba frontend documentation. Our frontend is a React application utilizing the robust Next.js framework, designed to offer a dynamic and interactive document search and display experience. Below are the instructions to help you set up and understand the structure of the frontend, which can be found within the [frontend](./frontend/) directory of our repository.
3+
Verba's Frontend is a [NextJS](https://nextjs.org/) application used together with [TailwindCSS](https://tailwindcss.com/) and [DaisyUI](https://daisyui.com/).
44

55
## 🚀 Setting Up the Frontend
66

77
To get your local copy of the Verba frontend up and running, please follow these simple steps:
88

9+
1. Clone Repository
10+
11+
```git
12+
13+
git clone https://github.com/weaviate/Verba.git
14+
15+
```
16+
917
1. **Node.js Requirement**:
10-
- Confirm that Node.js version `>=18.16.0` is installed on your system. If you need to install or update Node.js, visit the official [Node.js website](https://nodejs.org/).
18+
19+
- Confirm that Node.js version `>=21.3.0` is installed on your system. If you need to install or update Node.js, visit the official [Node.js website](https://nodejs.org/).
1120

1221
2. **Installation**:
22+
1323
- Navigate to the frontend directory: `cd frontend`
1424
- Run `npm install` to install the dependencies required for the project.
1525

@@ -19,25 +29,7 @@ To get your local copy of the Verba frontend up and running, please follow these
1929

2030
## 📦 Building Static Pages for FastAPI
2131

22-
If you wish to serve the frontend through FastAPI, you need to build static pages:
32+
If you wish to serve and update the frontend through FastAPI, you need to build static pages:
2333

2434
1. **Build Process**:
2535
- Execute `npm run build` to generate the static production build. The output will be directed to the FastAPI folder configured to serve the static content.
26-
27-
## 🎨 Styling with Tailwind CSS
28-
29-
Verba's frontend is styled with Tailwind CSS, a utility-first CSS framework, along with global CSS classes for a consistent and modern design language. Here's how styling is managed:
30-
31-
- **Tailwind CSS**:
32-
- We use Tailwind CSS for responsive design and to apply styles directly in the JSX code using utility classes.
33-
- For custom styling, the `tailwind.config.js` file can be modified.
34-
35-
- **Global Styles**:
36-
- Global stylesheets are located in the `styles` directory. These are used for overarching styles that apply to the entire application.
37-
38-
- **Assets**:
39-
- All static assets such as images and animations are housed in the `public` directory.
40-
- These assets are referenced directly in the codebase and are automatically optimized by Next.js.
41-
42-
By following these guidelines, you'll be able to contribute to the frontend of Verba effectively. We value your contributions and are excited to see the creative ways you'll enhance the Verba experience.
43-

PYTHON_TUTORIAL.md

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# Installing Python and Setting Up a Virtual Environment
2+
3+
Before you can use Verba, you'll need to ensure that `Python >=3.10.0` is installed on your system and that you can create a virtual environment for a safer and cleaner project setup.
4+
5+
## Installing Python
6+
7+
Python is required to run Verba. If you don't have Python installed, follow these steps:
8+
9+
### For Windows:
10+
11+
Download the latest Python installer from the official Python website.
12+
Run the installer and make sure to check the box that says `Add Python to PATH` during installation.
13+
14+
### For macOS:
15+
16+
You can install Python using Homebrew, a package manager for macOS, with the following command in the terminal:
17+
18+
```
19+
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
20+
```
21+
22+
Then install Python:
23+
24+
```
25+
brew install python
26+
```
27+
28+
### For Linux:
29+
30+
Python usually comes pre-installed on most Linux distributions. If it's not, you can install it using your distribution's package manager. You can read more about it [here](https://opensource.com/article/20/4/install-python-linux)
31+
32+
## Setting Up a Virtual Environment
33+
34+
It's recommended to use a virtual environment to avoid conflicts with other projects or system-wide Python packages.
35+
36+
### Install the virtualenv package:
37+
38+
First, ensure you have pip installed (it comes with Python if you're using version 3.4 and above).
39+
Install virtualenv by running:
40+
41+
```
42+
pip install virtualenv
43+
```
44+
45+
### Create a Virtual Environment:
46+
47+
Navigate to your project's directory in the terminal.
48+
Run the following command to create a virtual environment named venv (you can name it anything you like):
49+
50+
```
51+
python3 -m virtualenv venv
52+
```
53+
54+
### Activate the Virtual Environment:
55+
56+
- On Windows, activate the virtual environment by running:
57+
58+
```
59+
venv\Scripts\activate.bat
60+
```
61+
62+
- On macOS and Linux, activate it with:
63+
64+
```
65+
source venv/bin/activate
66+
```
67+
68+
Once your virtual environment is activated, you'll see its name in the terminal prompt. Now you're ready to install Verba using the steps provided in the Quickstart sections.
69+
70+
> Remember to deactivate the virtual environment when you're done working with Verba by simply running deactivate in the terminal.

0 commit comments

Comments
 (0)