soyailabs / GIT_SETUP.md
SOY NV AI
๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ์ƒ์„ฑ ๊ธฐ๋Šฅ ๊ฐœ์„ : ๊ธฐ์กด ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ๋ณ‘ํ•ฉ ๋ฐ ํšŒ์ฐจ ์ •๋ณด ์œ ์ง€
d234e06
|
raw
history blame
1.93 kB
# Git ์›๊ฒฉ ์ €์žฅ์†Œ ์„ค์ • ๊ฐ€์ด๋“œ
## ํ˜„์žฌ ์ƒํƒœ
- โœ… ๋กœ์ปฌ Git ์ €์žฅ์†Œ ์ดˆ๊ธฐํ™” ์™„๋ฃŒ
- โœ… ๋ชจ๋“  ํŒŒ์ผ ์ปค๋ฐ‹ ์™„๋ฃŒ
- โœ… master ๋ธŒ๋žœ์น˜ ์ค€๋น„ ์™„๋ฃŒ
## ์›๊ฒฉ ์ €์žฅ์†Œ ์„ค์ • ๋ฐฉ๋ฒ•
### 1. GitHub์— ์ƒˆ ์ €์žฅ์†Œ ๋งŒ๋“ค๊ธฐ
1. GitHub์— ๋กœ๊ทธ์ธ: https://github.com
2. ์šฐ์ธก ์ƒ๋‹จ์˜ **+** ๋ฒ„ํŠผ ํด๋ฆญ โ†’ **New repository** ์„ ํƒ
3. ์ €์žฅ์†Œ ์ •๋ณด ์ž…๋ ฅ:
- Repository name: `soy-nv-ai` (๋˜๋Š” ์›ํ•˜๋Š” ์ด๋ฆ„)
- Description: `SOY NV AI - Web novel training system with RAG functionality`
- Public ๋˜๋Š” Private ์„ ํƒ
- **โš ๏ธ ์ค‘์š”: "Initialize this repository with a README" ์ฒดํฌํ•˜์ง€ ๋งˆ์„ธ์š”!**
4. **Create repository** ํด๋ฆญ
### 2. ์›๊ฒฉ ์ €์žฅ์†Œ ์—ฐ๊ฒฐ ๋ฐ ํ‘ธ์‹œ
#### ๋ฐฉ๋ฒ• 1: PowerShell ์Šคํฌ๋ฆฝํŠธ ์‚ฌ์šฉ (๊ถŒ์žฅ)
```powershell
.\setup_remote.ps1
```
์Šคํฌ๋ฆฝํŠธ๊ฐ€ ์›๊ฒฉ ์ €์žฅ์†Œ URL์„ ์ž…๋ ฅ๋ฐ›๊ณ  ์ž๋™์œผ๋กœ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.
#### ๋ฐฉ๋ฒ• 2: ์ˆ˜๋™์œผ๋กœ ์„ค์ •
```powershell
# ์›๊ฒฉ ์ €์žฅ์†Œ ์ถ”๊ฐ€ (GitHub ์ €์žฅ์†Œ URL๋กœ ๋ณ€๊ฒฝ)
git remote add origin https://github.com/์‚ฌ์šฉ์ž๋ช…/์ €์žฅ์†Œ๋ช….git
# ์›๊ฒฉ ์ €์žฅ์†Œ ํ™•์ธ
git remote -v
# ๋งˆ์Šคํ„ฐ ๋ธŒ๋žœ์น˜ ํ‘ธ์‹œ
git push -u origin master
```
### 3. GitHub CLI ์‚ฌ์šฉ (์„ ํƒ์‚ฌํ•ญ)
GitHub CLI๊ฐ€ ์„ค์น˜๋˜์–ด ์žˆ๋‹ค๋ฉด:
```powershell
# ์ƒˆ ์ €์žฅ์†Œ ์ƒ์„ฑ ๋ฐ ํ‘ธ์‹œ
gh repo create soy-nv-ai --public --source=. --remote=origin --push
```
## ์ฃผ์˜์‚ฌํ•ญ
- `.gitignore` ํŒŒ์ผ์— ๋‹ค์Œ์ด ํฌํ•จ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค:
- `venv/` - ๊ฐ€์ƒํ™˜๊ฒฝ
- `instance/` - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํŒŒ์ผ
- `uploads/*` - ์—…๋กœ๋“œ๋œ ํŒŒ์ผ
- `__pycache__/` - Python ์บ์‹œ
- ๋ฏผ๊ฐํ•œ ์ •๋ณด๋Š” ์ปค๋ฐ‹ํ•˜์ง€ ๋งˆ์„ธ์š”:
- ๋น„๋ฐ€๋ฒˆํ˜ธ
- API ํ‚ค
- ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํŒŒ์ผ
## ๋‹ค์Œ ๋‹จ๊ณ„
์›๊ฒฉ ์ €์žฅ์†Œ ์„ค์ • ํ›„:
1. GitHub์—์„œ ์ €์žฅ์†Œ ํ™•์ธ
2. ํ•„์š”์‹œ `.env` ํŒŒ์ผ์„ ์ถ”๊ฐ€ํ•˜์—ฌ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ๊ด€๋ฆฌ
3. README.md ์—…๋ฐ์ดํŠธ (ํ”„๋กœ์ ํŠธ ์„ค๋ช… ์ถ”๊ฐ€)