init project

2026-04-23 18:00:36 +09:00
commit 3b087116c0
13 changed files with 341 additions and 0 deletions
@@ -0,0 +1,114 @@
+# 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로 동기화
+```