|
| 1 | +# GeminiProChat |
| 2 | + |
| 3 | +[English](README.md) | [中文](README_cn.md) | [Italiano](README_it.md) | [日本語](README_jp.md) | 한국어 |
| 4 | + |
| 5 | +Gemini Pro Chat을 위한 미니멀한 웹 UI입니다. |
| 6 | + |
| 7 | +> [!WARNING] |
| 8 | +> **면책 조항:** 이 프로젝트는 Google과 제휴하거나, Google의 승인 또는 후원을 받지 않았습니다. Google의 Gemini Pro API를 사용하는 독립적인 프로젝트입니다. |
| 9 | +
|
| 10 | +라이브 데모: [Gemini Pro Chat](https://gprochat.orzllc.com) |
| 11 | + |
| 12 | +[](https://www.geminiprochat.com) |
| 13 | + |
| 14 | +## 배포 |
| 15 | + |
| 16 | +### Vercel로 배포하기(권장) |
| 17 | + |
| 18 | +[](https://vercel.com/new/clone?repository-url=https://github.com/babaohuang/GeminiProChat&env=GEMINI_API_KEY&envDescription=Google%20API%20Key%20for%20GeminiProChat&envLink=https://makersuite.google.com/app/apikey&project-name=gemini-pro-chat&repository-name=gemini-pro-chat&demo-title=Gemini%20Pro%20Chat&demo-description=Minimal%20web%20UI%20for%20Gemini%20Pro.&demo-url=https%3A%2F%2Fgeminiprochat.com&demo-image=https%3A%2F%2Fgeminiprochat.com%2Ficon.svg) |
| 19 | + |
| 20 | +위 버튼을 클릭하고 안내에 따르면 나만의 앱 복사본을 배포할 수 있습니다. |
| 21 | + |
| 22 | + |
| 23 | +### Railway에 배포하기 |
| 24 | + |
| 25 | +[](https://railway.app/template/v9QL5u?referralCode=tSzmIe) |
| 26 | + |
| 27 | +위 버튼을 클릭하고 안내에 따르면 Railway에 배포할 수 있습니다. |
| 28 | + |
| 29 | +### Zeabur에 배포하기 |
| 30 | + |
| 31 | +[](https://zeabur.com/templates/1103PJ) |
| 32 | + |
| 33 | +위 버튼을 클릭하고 안내에 따르면 Zeabur에 배포할 수 있습니다. |
| 34 | + |
| 35 | +### Docker로 배포하기 |
| 36 | + |
| 37 | +Docker로 배포하려면 다음 명령어를 사용하면 됩니다. |
| 38 | + |
| 39 | +```bash |
| 40 | +docker run --name geminiprochat \ |
| 41 | +--restart always \ |
| 42 | +-p 3000:3000 \ |
| 43 | +-itd \ |
| 44 | +-e GEMINI_API_KEY=your_api_key_here \ |
| 45 | +babaohuang/geminiprochat:latest |
| 46 | +``` |
| 47 | +`your_api_key_here` 부분은 반드시 본인의 GEMINI API 키로 바꿔주세요. |
| 48 | + |
| 49 | +이렇게 하면 **geminiprochat** 서비스가 시작되며, `http://localhost:3000`에서 접속할 수 있습니다. |
| 50 | + |
| 51 | +## 환경 변수 |
| 52 | + |
| 53 | +환경 변수를 통해 웹사이트를 제어할 수 있습니다. |
| 54 | + |
| 55 | +| 이름 | 설명 | 필수 여부 | |
| 56 | +| --- | --- | --- | |
| 57 | +| `GEMINI_API_KEY` | GEMINI API 키입니다. [여기](https://makersuite.google.com/app/apikey)에서 발급받을 수 있습니다.| **✔** | |
| 58 | +| `API_BASE_URL` | GEMINI API용 커스텀 base url입니다. 언제 사용해야 하는지는 [여기](https://github.com/babaohuang/GeminiProChat?tab=readme-ov-file#solution-for-user-location-is-not-supported-for-the-api-use)를 참고하세요. | ❌ | |
| 59 | +| `HEAD_SCRIPTS` | 페이지의 `</head>` 앞에 애널리틱스나 기타 스크립트를 삽입합니다. | ❌ | |
| 60 | +| `PUBLIC_SECRET_KEY` | 프로젝트용 비밀 문자열입니다. API 호출 서명을 생성하는 데 사용됩니다. | ❌ | |
| 61 | +| `SITE_PASSWORD` | 사이트 비밀번호를 설정합니다. 콤마로 구분해 여러 개의 비밀번호를 지정할 수도 있습니다. 설정하지 않으면 사이트는 공개 상태가 됩니다. | ❌ | |
| 62 | +| `GEMINI_MODEL_NAME` | 사용할 Gemini 모델을 지정합니다. 설정하지 않으면 기본값은 `gemini-2.5-flash`입니다. | ❌ | |
| 63 | + |
| 64 | +## 로컬에서 실행하기 |
| 65 | + |
| 66 | +### 사전 환경 |
| 67 | +1. **Node**: 개발 환경과 배포 환경 모두 `Node v18` 이상을 사용하고 있는지 확인하세요. 로컬에서 여러 `node` 버전을 관리할 때는 [nvm](https://github.com/nvm-sh/nvm)을 사용할 수 있습니다. |
| 68 | + |
| 69 | + ```bash |
| 70 | + node -v |
| 71 | + ``` |
| 72 | + |
| 73 | +2. **PNPM**: 의존성 관리에는 [pnpm](https://pnpm.io/) 사용을 권장합니다. pnpm을 아직 설치하지 않았다면 다음 명령어로 설치할 수 있습니다. |
| 74 | + |
| 75 | + ```bash |
| 76 | + npm i -g pnpm |
| 77 | + ``` |
| 78 | + |
| 79 | +3. **GEMINI_API_KEY**: 이 애플리케이션을 실행하기 전에 Google에서 API 키를 발급받아야 합니다. [https://makersuite.google.com/app/apikey](https://makersuite.google.com/app/apikey)에서 API 키를 등록할 수 있습니다. |
| 80 | + |
| 81 | +### 시작하기 |
| 82 | + |
| 83 | +1. 의존성을 설치합니다. |
| 84 | + |
| 85 | + ```bash |
| 86 | + pnpm install |
| 87 | + ``` |
| 88 | + |
| 89 | +2. `.env.example` 파일을 복사한 뒤 `.env`로 이름을 바꾸고, 해당 파일에 [`GEMINI_API_KEY`](https://makersuite.google.com/app/apikey)를 추가합니다. |
| 90 | + |
| 91 | + ```bash |
| 92 | + GEMINI_API_KEY=AIzaSy... |
| 93 | + ``` |
| 94 | + |
| 95 | +3. 애플리케이션을 실행합니다. 로컬 프로젝트는 `http://localhost:3000/`에서 실행됩니다. |
| 96 | + |
| 97 | + ```bash |
| 98 | + pnpm run dev |
| 99 | + ``` |
| 100 | + |
| 101 | +## 감사의 말 |
| 102 | + |
| 103 | +이 프로젝트는 다음 오픈소스 프로젝트에서 영감을 받았으며, 이를 기반으로 만들어졌습니다. |
| 104 | + |
| 105 | +- [ChatGPT-Demo](https://github.com/anse-app/chatgpt-demo) - 기본 코드베이스와 기능을 제공해 주었습니다. |
| 106 | + |
| 107 | +## Star History |
| 108 | + |
| 109 | +[](https://star-history.com/#babaohuang/geminiprochat&Timeline) |
| 110 | + |
| 111 | +## 커피 한 잔 사주기 |
| 112 | + |
| 113 | +이 저장소가 도움이 되셨다면, 커피 한 잔 사주세요. 정말 감사하겠습니다!😄 |
| 114 | + |
| 115 | +<a href="https://www.buymeacoffee.com/babaohuang" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174"></a> |
| 116 | + |
| 117 | +## 추천 AI 도구 |
| 118 | + |
| 119 | + |
| 120 | +[ElevenMusic | World's best AI music generator](https://elevenmusic.ai?utm_source=geminiprochatgithub) |
0 commit comments