-
Notifications
You must be signed in to change notification settings - Fork 34
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore: added English translation for the docs
- Loading branch information
Showing
3 changed files
with
367 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,49 @@ | ||
# Contribution Guide | ||
Thank you for your valuable time. Your contributions will make this project better! Before submitting a contribution, please take some time to read the getting started guide below. | ||
|
||
## Semantic Versioning | ||
This project follows semantic versioning. We release patch versions for important bug fixes, minor versions for new features or non-important changes, and major versions for significant and incompatible changes. | ||
|
||
Each major change will be recorded in the `changelog`. | ||
|
||
## Submitting Pull Request | ||
1. Fork [this repository](https://github.com/Chanzhaoyu/chatgpt-web) and create a branch from `main`. For new feature implementations, submit a pull request to the `feature` branch. For other changes, submit to the `main` branch. | ||
2. Install the `pnpm` tool using `npm install pnpm -g`. | ||
3. Install the `Eslint` plugin for `VSCode`, or enable `eslint` functionality for other editors such as `WebStorm`. | ||
4. Execute `pnpm bootstrap` in the root directory. | ||
5. Execute `pnpm install` in the `/service/` directory. | ||
6. Make changes to the codebase. If applicable, ensure that appropriate testing has been done. | ||
7. Execute `pnpm lint:fix` in the root directory to perform a code formatting check. | ||
8. Execute `pnpm type-check` in the root directory to perform a type check. | ||
9. Submit a git commit, following the [Commit Guidelines](#commit-guidelines). | ||
10. Submit a `pull request`. If there is a corresponding `issue`, please link it using the [linking-a-pull-request-to-an-issue keyword](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword). | ||
|
||
## Commit Guidelines | ||
|
||
Commit messages should follow the [conventional-changelog standard](https://www.conventionalcommits.org/en/v1.0.0/): | ||
|
||
```bash | ||
<type>[optional scope]: <description> | ||
|
||
[optional body] | ||
|
||
[optional footer] | ||
``` | ||
|
||
### Commit Types | ||
|
||
The following is a list of commit types: | ||
|
||
- feat: New feature or functionality | ||
- fix: Bug fix | ||
- docs: Documentation update | ||
- style: Code style or component style update | ||
- refactor: Code refactoring, no new features or bug fixes introduced | ||
- perf: Performance optimization | ||
- test: Unit test | ||
- chore: Other commits that do not modify src or test files | ||
|
||
|
||
## License | ||
|
||
[MIT](./license) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,312 @@ | ||
# ChatGPT Web | ||
|
||
<div style="font-size: 1.5rem;"> | ||
<a href="./README.md">中文</a> | | ||
<a href="./README.en.md">English</a> | ||
</div> | ||
</br> | ||
|
||
> Disclaimer: This project is only released on GitHub, under the MIT License, free and for open-source learning purposes. There will be no account selling, paid services, discussion groups, or forums. Beware of fraud. | ||
![cover](./docs/c1.png) | ||
![cover2](./docs/c2.png) | ||
|
||
- [ChatGPT Web](#chatgpt-web) | ||
- [Introduction](#introduction) | ||
- [Roadmap](#roadmap) | ||
- [Prerequisites](#prerequisites) | ||
- [Node](#node) | ||
- [PNPM](#pnpm) | ||
- [Fill in the Keys](#fill-in-the-keys) | ||
- [Install Dependencies](#install-dependencies) | ||
- [Backend](#backend) | ||
- [Frontend](#frontend) | ||
- [Run in Test Environment](#run-in-test-environment) | ||
- [Backend Service](#backend-service) | ||
- [Frontend Webpage](#frontend-webpage) | ||
- [Packaging](#packaging) | ||
- [Using Docker](#using-docker) | ||
- [Docker Parameter Example](#docker-parameter-example) | ||
- [Docker Build & Run](#docker-build--run) | ||
- [Docker Compose](#docker-compose) | ||
- [Deploying with Railway](#deploying-with-railway) | ||
- [Railway Environment Variables](#railway-environment-variables) | ||
- [Manual Packaging](#manual-packaging) | ||
- [Backend Service](#backend-service-1) | ||
- [Frontend Webpage](#frontend-webpage-1) | ||
- [FAQ](#faq) | ||
- [Contributing](#contributing) | ||
- [Sponsor](#sponsor) | ||
- [License](#license) | ||
|
||
## Introduction | ||
|
||
Supports dual models, provides two unofficial `ChatGPT API` methods: | ||
|
||
| Method | Free? | Reliability | Quality | | ||
| --------------------------------------------- | ------ | ----------- | ------- | | ||
| `ChatGPTAPI(gpt-3.5-turbo-0301)` | No | Reliable | Relatively clumsy | | ||
| `ChatGPTUnofficialProxyAPI(Web accessToken)` | Yes | Relatively unreliable | Smart | | ||
|
||
Comparison: | ||
1. `ChatGPTAPI` uses `gpt-3.5-turbo-0301` to simulate `ChatGPT` through the official `OpenAI` completion `API` (the most reliable method, but it is not free and does not use models specifically tuned for chat). | ||
2. `ChatGPTUnofficialProxyAPI` accesses `ChatGPT`'s backend `API` via an unofficial proxy server to bypass `Cloudflare` (uses the real `ChatGPT`, is very lightweight, but depends on third-party servers and has rate limits). | ||
|
||
[Details](https://github.com/Chanzhaoyu/chatgpt-web/issues/138) | ||
|
||
Switching Methods: | ||
1. Go to the `service/.env` file. | ||
2. For `OpenAI API Key`, fill in the `OPENAI_API_KEY` field [(Get apiKey)](https://platform.openai.com/overview). | ||
3. For `Web API`, fill in the `OPENAI_ACCESS_TOKEN` field [(Get accessToken)](https://chat.openai.com/api/auth/session). | ||
4. When both are present, `OpenAI API Key` takes precedence. | ||
|
||
Reverse Proxy: | ||
|
||
Available when using `ChatGPTUnofficialProxyAPI`. | ||
|
||
```shell | ||
# service/.env | ||
API_REVERSE_PROXY= | ||
``` | ||
|
||
Environment Variables: | ||
|
||
For all parameter variables, check [here](#docker-parameter-example) or see: | ||
|
||
``` | ||
/service/.env | ||
``` | ||
|
||
## Roadmap | ||
[✓] Dual models | ||
|
||
[✓] Multiple session storage and context logic | ||
|
||
[✓] Formatting and beautifying code-like message types | ||
|
||
[✓] Multilingual interface | ||
|
||
[✓] Interface themes | ||
|
||
[✗] More... | ||
|
||
## Prerequisites | ||
|
||
### Node | ||
|
||
`node` requires version `^16 || ^18` (`node >= 14` requires installation of [fetch polyfill](https://github.com/developit/unfetch#usage-as-a-polyfill)), and multiple local `node` versions can be managed using [nvm](https://github.com/nvm-sh/nvm). | ||
|
||
```shell | ||
node -v | ||
``` | ||
|
||
### PNPM | ||
If you have not installed `pnpm` before: | ||
```shell | ||
npm install pnpm -g | ||
``` | ||
|
||
### Fill in the Keys | ||
|
||
Get `Openai Api Key` or `accessToken` and fill in the local environment variables [jump](#introduction) | ||
|
||
``` | ||
# service/.env file | ||
# OpenAI API Key - https://platform.openai.com/overview | ||
OPENAI_API_KEY= | ||
# change this to an `accessToken` extracted from the ChatGPT site's `https://chat.openai.com/api/auth/session` response | ||
OPENAI_ACCESS_TOKEN= | ||
``` | ||
|
||
## Install Dependencies | ||
|
||
> To make it easier for `backend developers` to understand, we did not use the front-end `workspace` mode, but stored it in different folders. If you only need to do secondary development of the front-end page, delete the `service` folder. | ||
### Backend | ||
|
||
Enter the `/service` folder and run the following command | ||
|
||
```shell | ||
pnpm install | ||
``` | ||
|
||
### Frontend | ||
Run the following command in the root directory | ||
```shell | ||
pnpm bootstrap | ||
``` | ||
|
||
## Run in Test Environment | ||
### Backend Service | ||
|
||
Enter the `/service` folder and run the following command | ||
|
||
```shell | ||
pnpm start | ||
``` | ||
|
||
### Frontend Webpage | ||
Run the following command in the root directory | ||
```shell | ||
pnpm dev | ||
``` | ||
|
||
## Packaging | ||
|
||
### Using Docker | ||
|
||
#### Docker Parameter Example | ||
|
||
- `OPENAI_API_KEY` one of two | ||
- `OPENAI_ACCESS_TOKEN` one of two, `OPENAI_API_KEY` takes precedence when both are present | ||
- `OPENAI_API_BASE_URL` optional, available when `OPENAI_API_KEY` is set | ||
- `API_REVERSE_PROXY` optional, available when `OPENAI_ACCESS_TOKEN` is set [Reference](#introduction) | ||
- `TIMEOUT_MS` timeout, in milliseconds, optional | ||
- `SOCKS_PROXY_HOST` optional, effective with SOCKS_PROXY_PORT | ||
- `SOCKS_PROXY_PORT` optional, effective with SOCKS_PROXY_HOST | ||
|
||
![docker](./docs/docker.png) | ||
|
||
#### Docker Build & Run | ||
|
||
```bash | ||
docker build -t chatgpt-web . | ||
|
||
# foreground operation | ||
docker run --name chatgpt-web --rm -it -p 3002:3002 --env OPENAI_API_KEY=your_api_key chatgpt-web | ||
|
||
# background operation | ||
docker run --name chatgpt-web -d -p 3002:3002 --env OPENAI_API_KEY=your_api_key chatgpt-web | ||
|
||
# running address | ||
http://localhost:3002/ | ||
``` | ||
|
||
#### Docker Compose | ||
|
||
[Hub Address](https://hub.docker.com/repository/docker/chenzhaoyu94/chatgpt-web/general) | ||
|
||
```yml | ||
version: '3' | ||
|
||
services: | ||
app: | ||
image: chenzhaoyu94/chatgpt-web # always use latest, pull the tag image again when updating | ||
ports: | ||
- 3002:3002 | ||
environment: | ||
# one of two | ||
OPENAI_API_KEY: xxxxxx | ||
# one of two | ||
OPENAI_ACCESS_TOKEN: xxxxxx | ||
# api interface url, optional, available when OPENAI_API_KEY is set | ||
OPENAI_API_BASE_URL: xxxx | ||
# reverse proxy, optional | ||
API_REVERSE_PROXY: xxx | ||
# timeout, in milliseconds, optional | ||
TIMEOUT_MS: 60000 | ||
# socks proxy, optional, effective with SOCKS_PROXY_PORT | ||
SOCKS_PROXY_HOST: xxxx | ||
# socks proxy port, optional, effective with SOCKS_PROXY_HOST | ||
SOCKS_PROXY_PORT: xxxx | ||
``` | ||
The `OPENAI_API_BASE_URL` is optional and only used when setting the `OPENAI_API_KEY`. | ||
|
||
### Deployment with Railway | ||
|
||
[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template/yytmgc) | ||
|
||
#### Railway Environment Variables | ||
|
||
| Environment Variable | Required | Description | | ||
| -------------------- | -------- | ------------------------------------------------------------------------------------------------- | | ||
| `PORT` | Required | Default: `3002` | | ||
| `TIMEOUT_MS` | Optional | Timeout in milliseconds. | | ||
| `OPENAI_API_KEY` | Optional | Required for `OpenAI API`. `apiKey` can be obtained from [here](https://platform.openai.com/overview). | | ||
| `OPENAI_ACCESS_TOKEN`| Optional | Required for `Web API`. `accessToken` can be obtained from [here](https://chat.openai.com/api/auth/session).| | ||
| `OPENAI_API_BASE_URL` | Optional, only for `OpenAI API` | API endpoint. | | ||
| `API_REVERSE_PROXY` | Optional, only for `Web API` | Reverse proxy address for `Web API`. [Details](https://github.com/transitive-bullshit/chatgpt-api#reverse-proxy) | | ||
| `SOCKS_PROXY_HOST` | Optional, effective with `SOCKS_PROXY_PORT` | Socks proxy. | | ||
| `SOCKS_PROXY_PORT` | Optional, effective with `SOCKS_PROXY_HOST` | Socks proxy port. | | ||
|
||
> Note: Changing environment variables in Railway will cause re-deployment. | ||
|
||
### Manual packaging | ||
|
||
#### Backend service | ||
|
||
> If you don't need the `node` interface of this project, you can skip the following steps. | ||
|
||
Copy the `service` folder to a server that has a `node` service environment. | ||
|
||
```shell | ||
# Install | ||
pnpm install | ||
# Build | ||
pnpm build | ||
# Run | ||
pnpm prod | ||
``` | ||
|
||
PS: You can also run `pnpm start` directly on the server without packaging. | ||
|
||
#### Frontend webpage | ||
|
||
1. Modify `VITE_APP_API_BASE_URL` in `.env` at the root directory to your actual backend interface address. | ||
2. Run the following command in the root directory and then copy the files in the `dist` folder to the root directory of your website service. | ||
|
||
[Reference information](https://cn.vitejs.dev/guide/static-deploy.html#building-the-app) | ||
|
||
```shell | ||
pnpm build | ||
``` | ||
|
||
## Frequently Asked Questions | ||
|
||
Q: Why does Git always report an error when committing? | ||
|
||
A: Because there is submission information verification, please follow the [Commit Guidelines](./CONTRIBUTING.en.md). | ||
|
||
Q: Where to change the request interface if only the frontend page is used? | ||
|
||
A: The `VITE_GLOB_API_URL` field in the `.env` file at the root directory. | ||
|
||
Q: All red when saving the file? | ||
|
||
A: For `vscode`, please install the recommended plug-in of the project or manually install the `Eslint` plug-in. | ||
|
||
Q: Why doesn't the frontend have a typewriter effect? | ||
|
||
A: One possible reason is that after Nginx reverse proxying, buffering is turned on, and Nginx will try to buffer a certain amount of data from the backend before sending it to the browser. Please try adding `proxy_buffering off;` after the reverse proxy parameter and then reloading Nginx. Other web server configurations are similar. | ||
|
||
## Contributing | ||
|
||
Please read the [Contributing Guidelines](./CONTRIBUTING.en.md) before contributing. | ||
|
||
Thanks to all the contributors! | ||
|
||
<a href="https://github.com/Chanzhaoyu/chatgpt-web/graphs/contributors"> | ||
<img src="https://contrib.rocks/image?repo=Chanzhaoyu/chatgpt-web" /> | ||
</a> | ||
|
||
## Sponsorship | ||
|
||
If you find this project helpful and circumstances permit, you can give me a little support. Thank you very much for your support~ | ||
|
||
<div style="display: flex; gap: 20px;"> | ||
<div style="text-align: center"> | ||
<img style="max-width: 100%" src="./docs/wechat.png" alt="WeChat" /> | ||
<p>WeChat Pay</p> | ||
</div> | ||
<div style="text-align: center"> | ||
<img style="max-width: 100%" src="./docs/alipay.png" alt="Alipay" /> | ||
<p>Alipay</p> | ||
</div> | ||
</div> | ||
|
||
## License | ||
MIT © [ChenZhaoYu](./license) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters