AI 학습의 여정 - 실행 가이드

부산수학문화관 전시용 AI 학습 체험 게임

🎯 빠른 시작 (Windows)

방법 1: 자동 설치 스크립트 (추천)

1. 이 폴터에서 마우스 우클릭 → "PowerShell에서 열기" 또는 "터미널에서 열기"
2. 아래 명령어 입력:

.\start-windows.ps1

3. 브라우저가 자동으로 열리면 즐기세요!

---

방법 2: 수동 설치

1단계: uv 설치

# PowerShell에서 실행
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

설치 후 PowerShell을 재시작하거나 refreshenv 명령어를 실행하세요.

2단계: Python 설치 확인

python --version

• Python이 없다면: https://python.org 에서 Python 3.9 이상 다운로드 및 설치
• 설치 시 "Add Python to PATH" 꼭 체크!

3단계: 의존성 설치

# pyproject.toml에 정의된 의존성 설치
uv sync

4단계: 서버 실행

uv run python main.py

5단계: 브라우저에서 접속

서버가 실행되면 자동으로 브라우저가 열립니다.

수동으로 접속하려면: http://localhost:8080

---

🍎 macOS / Linux 실행 방법

자동 설치 스크립트

chmod +x start-mac.sh
./start-mac.sh

수동 설치

# 1. uv 설치
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Python 설치 확인
python3 --version

# 3. 의존성 설치 (pyproject.toml 기준)
uv sync

# 4. 서버 실행
uv run python main.py

---

📁 프로젝트 구조

prototype/
├── main.py              # 서버 메인 파일
├── templates/
│   └── index.html       # 웹 페이지
├── static/
│   ├── js/              # 자바스크립트 파일
│   └── css/             # 스타일 파일
├── pyproject.toml       # 프로젝트 설정 및 의존성
├── uv.lock              # 의존성 잠금 파일
├── start-windows.ps1    # Windows 자동 실행 스크립트
├── start-mac.sh         # Mac/Linux 자동 실행 스크립트
└── README.md            # 이 파일

---

🎮 게임 설명

1-1단계: AI 회귀 학습

좌표평면에 점을 찍으면 AI가 자동으로 최적의 회귀선을 찾습니다.

1-2단계: 내가 회귀선 그리기

주어진 산점도에 직접 회귀선을 그리고 AI와 비교핳보세요.

2단계: 퍼셉트론 분류

두 종류의 도형을 배치하고 결정 경계가 형성되는 과정을 확인하세요.

3단계: 신경망

비선형 문제를 은닉층을 통해 해결하는 과정을 체험하세요.

---

❓ 문제 해결

"uv" 명령어를 찾을 수 없습니다

→ uv가 설치되지 않았거나 PATH에 등록되지 않았습니다. → 터미널을 재시작하거나 PATH를 새로고침하세요.

"python" 명령어를 찾을 수 없습니다

→ Python이 설치되지 않았거나 PATH에 등록되지 않았습니다. → https://python.org 에서 Python 3.9 이상 설치 ("Add Python to PATH" 체크!)

포트 8080이 이미 사용 중입니다

→ 다른 프로그램이 8080 포트를 사용 중입니다. → main.py 파일에서 port=8080을 다른 숫자(예: 8000)로 변경 후 재실행

의존성 설치 오류

→ uv sync 명령어를 실행했는지 확인하세요 → 인터넷 연결을 확인하세요

브라우저가 자동으로 안 열립니다

→ 수동으로 http://localhost:8080 접속

---

🛑 서버 종료 방법

실행 중인 터미널/파워셸 창에서 Ctrl + C를 누르세요.

---

📞 지원

실행에 문제가 있으면 개발자에게 문의하세요.

시스템 요구사항:

• Windows 10/11, macOS 10.14+, 또는 Linux
• Python 3.9 이상
• 웹 브라우저 (Chrome, Edge, Firefox, Safari)