2023-09-07 11:36:39 +00:00
## Launching Web App
2023-10-15 04:20:09 +00:00
**Note**: Make sure you have Docker installed
2023-09-07 11:36:39 +00:00
2023-10-15 04:20:09 +00:00
**On macOS or Linux:**
2023-10-29 22:06:24 +00:00
Just run the following command:
2023-10-02 23:39:12 +00:00
2023-10-30 10:06:37 +00:00
```bash
2023-10-29 22:06:24 +00:00
./setup.sh
```
2023-10-02 23:39:12 +00:00
2024-01-09 00:18:04 +00:00
This command will install all the necessary dependencies and provide you with an option to use our LLM API, download the local model or use OpenAI.
2023-10-02 23:39:12 +00:00
2023-10-15 04:20:09 +00:00
If you prefer to follow manual steps, refer to this guide:
2023-10-02 23:39:12 +00:00
2023-10-15 04:20:09 +00:00
1. Open and download this repository with
2023-10-30 10:06:37 +00:00
```bash
git clone https://github.com/arc53/DocsGPT.git
2023-10-29 22:06:24 +00:00
```
2024-01-09 00:18:04 +00:00
2. Create a `.env` file in your root directory and set your `API_KEY` with your [OpenAI API key ](https://platform.openai.com/account/api-keys ). (optional in case you want to use OpenAI)
2023-10-15 04:20:09 +00:00
3. Run the following commands:
2023-10-30 10:06:37 +00:00
```bash
docker-compose build & & docker-compose up
2023-10-29 22:06:24 +00:00
```
2023-10-30 10:20:19 +00:00
4. Navigate to http://localhost:5173/.
2023-09-07 11:36:39 +00:00
2023-10-29 22:06:24 +00:00
To stop, simply press **Ctrl + C** .
2023-10-15 04:20:09 +00:00
2023-10-15 04:24:25 +00:00
**For WINDOWS:**
2023-10-15 04:20:09 +00:00
To run the setup on Windows, you have two options: using the Windows Subsystem for Linux (WSL) or using Git Bash or Command Prompt.
**Option 1: Using Windows Subsystem for Linux (WSL):**
1. Install WSL if you haven't already. You can follow the official Microsoft documentation for installation: (https://learn.microsoft.com/en-us/windows/wsl/install).
2. After setting up WSL, open the WSL terminal.
3. Clone the repository and create the `.env` file:
2023-10-30 10:06:37 +00:00
```bash
2023-10-15 04:20:09 +00:00
git clone https://github.com/arc53/DocsGPT.git
cd DocsGPT
echo "API_KEY=Yourkey" > .env
echo "VITE_API_STREAMING=true" >> .env
```
4. Run the following command to start the setup with Docker Compose:
2023-10-30 10:06:37 +00:00
```bash
2023-10-29 22:06:24 +00:00
./run-with-docker-compose.sh
```
2023-10-30 10:06:37 +00:00
6. Open your web browser and navigate to http://localhost:5173/.
2023-10-29 22:06:24 +00:00
7. To stop the setup, just press **Ctrl + C** in the WSL terminal
2023-10-15 04:20:09 +00:00
**Option 2: Using Git Bash or Command Prompt (CMD):**
1. Install Git for Windows if you haven't already. Download it from the official website: (https://gitforwindows.org/).
2. Open Git Bash or Command Prompt.
3. Clone the repository and create the `.env` file:
2023-10-30 10:06:37 +00:00
```bash
2023-10-15 04:20:09 +00:00
git clone https://github.com/arc53/DocsGPT.git
cd DocsGPT
echo "API_KEY=Yourkey" > .env
echo "VITE_API_STREAMING=true" >> .env
```
2023-10-29 22:06:24 +00:00
4. Run the following command to start the setup with Docker Compose:
2023-10-30 10:06:37 +00:00
```bash
2023-10-29 22:06:24 +00:00
./run-with-docker-compose.sh
```
2023-10-30 10:06:37 +00:00
5. Open your web browser and navigate to http://localhost:5173/.
2023-10-29 22:06:24 +00:00
6. To stop the setup, just press **Ctrl + C** in the Git Bash or Command Prompt terminal.
2023-10-15 04:20:09 +00:00
These steps should help you set up and run the project on Windows using either WSL or Git Bash/Command Prompt.
**Important:** Ensure that Docker is installed and properly configured on your Windows system for these steps to work.
2023-09-07 11:36:39 +00:00
2023-10-12 09:18:44 +00:00
For WINDOWS:
To run the given setup on Windows, you can use the Windows Subsystem for Linux (WSL) or a Git Bash terminal to execute similar commands. Here are the steps adapted for Windows:
Option 1: Using Windows Subsystem for Linux (WSL):
1. Install WSL if you haven't already. You can follow the official Microsoft documentation for installation: (https://learn.microsoft.com/en-us/windows/wsl/install).
2. After setting up WSL, open the WSL terminal.
3. Clone the repository and create the `.env` file:
2023-10-30 10:06:37 +00:00
```bash
2023-10-12 09:18:44 +00:00
git clone https://github.com/arc53/DocsGPT.git
cd DocsGPT
echo "API_KEY=Yourkey" > .env
echo "VITE_API_STREAMING=true" >> .env
```
4. Run the following command to start the setup with Docker Compose:
2023-10-30 10:06:37 +00:00
```bash
./run-with-docker-compose.sh
```
5. Open your web browser and navigate to http://localhost:5173/.
2023-10-29 22:06:24 +00:00
6. To stop the setup, just press **Ctrl + C** in the WSL terminal.
2023-10-12 09:18:44 +00:00
Option 2: Using Git Bash or Command Prompt (CMD):
1. Install Git for Windows if you haven't already. You can download it from the official website: (https://gitforwindows.org/).
2. Open Git Bash or Command Prompt.
3. Clone the repository and create the `.env` file:
2023-10-30 10:06:37 +00:00
```bash
2023-10-12 09:18:44 +00:00
git clone https://github.com/arc53/DocsGPT.git
cd DocsGPT
echo "API_KEY=Yourkey" > .env
echo "VITE_API_STREAMING=true" >> .env
```
2023-10-29 22:06:24 +00:00
4. Run the following command to start the setup with Docker Compose:
2023-10-30 10:06:37 +00:00
```bash
2023-10-29 22:06:24 +00:00
./run-with-docker-compose.sh
```
2023-10-30 10:06:37 +00:00
5. Open your web browser and navigate to http://localhost:5173/.
2023-10-29 22:06:24 +00:00
6. To stop the setup, just press **Ctrl + C** in the Git Bash or Command Prompt terminal.
2023-10-12 09:18:44 +00:00
These steps should help you set up and run the project on Windows using either WSL or Git Bash/Command Prompt. Make sure you have Docker installed and properly configured on your Windows system for this to work.