# 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로 동기화
```