Files
youlbot/docs/jetbrains-gateway-setup.md
T
2026-04-23 18:00:36 +09:00

115 lines
2.8 KiB
Markdown

# JetBrains Gateway 원격 개발 환경 설정
> Windows PC에서 편집 → Mac Mini M4에서 실행하는 환경 구축 가이드
```
Windows PC Mac Mini M4
┌─────────────────┐ ┌─────────────────────┐
│ JetBrains │ SSH 연결 │ PyCharm 백엔드 │
│ Gateway │ ─────────▶│ ~/youlbot/chat.py │
│ (얇은 클라이언트) │ │ mlx-lm + M4 GPU │
└─────────────────┘ └─────────────────────┘
Windows에서 편집 Mac에서 실행
```
---
## 1단계: Mac에서 SSH 활성화
Mac Mini에서 아래 경로로 이동해 **원격 로그인**을 켭니다.
```
시스템 설정 → 일반 → 공유 → 원격 로그인 ON
```
활성화 후 화면에 표시되는 `사용자명@IP주소`를 메모해 둡니다.
---
## 2단계: 프로젝트를 Mac으로 전송 (Git)
### Windows에서 (PowerShell)
```bash
cd C:/workspace_python/youlbot
git add .
git commit -m "init: chat.py 초기 코드"
git remote add origin https://github.com/본인계정/youlbot.git
git push -u origin master
```
### Mac 터미널에서
```bash
cd ~
git clone https://github.com/본인계정/youlbot.git
cd youlbot
python -m venv py_ai
source py_ai/bin/activate
pip install -r requirements.txt
```
---
## 3단계: JetBrains Gateway 설치 (Windows)
아래 공식 사이트에서 다운로드 후 설치합니다.
```
https://www.jetbrains.com/remote-development/gateway/
```
---
## 4단계: Gateway에서 Mac 연결
1. Gateway 실행
2. **New Connection****SSH** 선택
3. 아래 정보 입력
| 항목 | 값 |
|------|-----|
| Host | Mac의 IP 주소 |
| Username | Mac 사용자명 |
| Authentication | Password 또는 SSH Key |
4. **Check Connection** 클릭해 연결 확인
5. IDE 선택: **PyCharm** → 버전 선택 → **Download and Start IDE**
- Mac에 PyCharm 백엔드가 자동 설치됩니다 (최초 1회, 수분 소요)
6. 프로젝트 경로 입력: `~/youlbot` → 열기
---
## 5단계: Python 인터프리터 설정
PyCharm이 열리면 아래 경로에서 인터프리터를 연결합니다.
```
Settings → Project → Python Interpreter
→ Add Interpreter → Add Local Interpreter
→ ~/youlbot/py_ai 가상환경 선택
```
---
## 6단계: 실행 확인
PyCharm 터미널에서 아래 명령어로 챗봇을 실행합니다.
```bash
source py_ai/bin/activate
python chat.py
```
첫 실행 시 HuggingFace에서 모델(약 4.5GB)이 자동 다운로드됩니다.
---
## 이후 개발 흐름
```
1. Windows Gateway에서 코드 수정
2. Mac PyCharm 터미널에서 python chat.py 실행
3. 변경사항은 git push/pull로 동기화
```