hgzero/ai-python/start.sh
Minseo-Jo 9bf3597cec AI 서비스 Python 마이그레이션 및 프론트엔드 연동 문서 추가
주요 변경사항:
- AI 서비스 Java → Python (FastAPI) 완전 마이그레이션
- 포트 변경: 8083 → 8086
- SSE 스트리밍 기능 구현 및 테스트 완료
- Claude API 연동 (claude-3-5-sonnet-20241022)
- Redis 슬라이딩 윈도우 방식 텍스트 축적
- Azure Event Hub 연동 준비 (STT 텍스트 수신)

프론트엔드 연동 지원:
- API 연동 가이드 업데이트 (Python 버전 반영)
- Mock 데이터 개발 가이드 신규 작성
- STT 개발 완료 전까지 Mock 데이터로 UI 개발 가능

기술 스택:
- Python 3.13
- FastAPI 0.104.1
- Anthropic Claude API 0.42.0
- Redis (asyncio) 5.0.1
- Azure Event Hub 5.11.4
- Pydantic 2.10.5

테스트 결과:
-  서비스 시작 정상
-  헬스 체크 성공
-  SSE 스트리밍 동작 확인
-  Redis 연결 정상

다음 단계:
- STT (Azure Speech) 서비스 연동 개발
- Event Hub를 통한 실시간 텍스트 수신
- E2E 통합 테스트 (STT → AI → Frontend)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 11:52:30 +09:00

36 lines
892 B
Bash
Executable File

#!/bin/bash
# AI Service (Python) 시작 스크립트
echo "======================================"
echo "AI Service (Python) 시작"
echo "======================================"
# 가상환경 활성화 (선택사항)
# source venv/bin/activate
# 의존성 설치 확인
if [ ! -d "venv" ]; then
echo "가상환경이 없습니다. 생성 중..."
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
else
source venv/bin/activate
fi
# .env 파일 확인
if [ ! -f ".env" ]; then
echo ".env 파일이 없습니다. .env.example을 복사합니다."
cp .env.example .env
echo "⚠️ .env 파일에 실제 API 키를 설정해주세요."
fi
# FastAPI 서버 시작
echo "======================================"
echo "FastAPI 서버 시작 중..."
echo "Port: 8086"
echo "======================================"
python3 main.py