Quickstart: Enhanced Documentation for Launching DocsGPT and Installing Chrome Extension
5.1 KiB
Launching Web App
Note: Make sure you have Docker installed
On macOS or Linux: Just run the following command::
./setup.sh
This command will install all the necessary dependencies and provide you with an option to download the local model or use OpenAI.
If you prefer to follow manual steps, refer to this guide:
- Open and download this repository with
git clone https://github.com/arc53/DocsGPT.git
. - Create a
.env
file in your root directory and set yourAPI_KEY
with your OpenAI API key. - Run the following commands:
docker-compose build && docker-compose up
. - Navigate to
http://localhost:5173/
.
To stop, simply press Ctrl + C.
For WINDOWS:
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):
- 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).
- After setting up WSL, open the WSL terminal.
- Clone the repository and create the
.env
file:git clone https://github.com/arc53/DocsGPT.git cd DocsGPT echo "API_KEY=Yourkey" > .env echo "VITE_API_STREAMING=true" >> .env
- Run the following command to start the setup with Docker Compose:
./run-with-docker-compose.sh
- Open your web browser and navigate to (http://localhost:5173/).
- To stop the setup, just press
Ctrl + C
in the WSL terminal
Option 2: Using Git Bash or Command Prompt (CMD):
- Install Git for Windows if you haven't already. Download it from the official website: (https://gitforwindows.org/).
- Open Git Bash or Command Prompt.
- Clone the repository and create the
.env
file: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:
./run-with-docker-compose.sh
5.Open your web browser and navigate to (http://localhost:5173/).
6.To stop the setup, just press Ctrl + C in the Git Bash or Command Prompt terminal.
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.
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):
- 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).
- After setting up WSL, open the WSL terminal.
- Clone the repository and create the
.env
file:git clone https://github.com/arc53/DocsGPT.git cd DocsGPT echo "API_KEY=Yourkey" > .env echo "VITE_API_STREAMING=true" >> .env
- Run the following command to start the setup with Docker Compose:
./run-with-docker-compose.sh
- Open your web browser and navigate to (http://localhost:5173/).
- To stop the setup, just press
Ctrl + C
in the WSL terminal
Option 2: Using Git Bash or Command Prompt (CMD):
- Install Git for Windows if you haven't already. You can download it from the official website: (https://gitforwindows.org/).
- Open Git Bash or Command Prompt.
- Clone the repository and create the
.env
file: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:
./run-with-docker-compose.sh
5.Open your web browser and navigate to (http://localhost:5173/).
6.To stop the setup, just press Ctrl + C in the Git Bash or Command Prompt terminal.
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.
Chrome Extension
Installing the Chrome extension:
To enhance your DocsGPT experience, you can install the DocsGPT Chrome extension. Here's how:
- In the DocsGPT GitHub repository, click on the "Code" button and select "Download ZIP".
- Unzip the downloaded file to a location you can easily access.
- Open the Google Chrome browser and click on the three dots menu (upper right corner).
- Select "More Tools" and then "Extensions".
- Turn on the "Developer mode" switch in the top right corner of the Extensions page.
- Click on the "Load unpacked" button.
- Select the "Chrome" folder where the DocsGPT files have been unzipped (docsgpt-main > extensions > chrome).
- The extension should now be added to Google Chrome and can be managed on the Extensions page.
- To disable or remove the extension, simply turn off the toggle switch on the extension card or click the "Remove" button.