AI Language Speaking Coach v6

영어/중국어 말하기 훈련용 Streamlit 웹앱입니다.

v6 핵심 개선

• 질문 관련성 평가: 질문과 답변이 맞는지 판단
• STT 이해 확인: AI가 사용자의 답변을 어떻게 이해했는지 표시
• 답변 품질 점수: 관련성, 자연스러움, 어휘 다양성, 문장 완성도, 회화 흐름
• 엉뚱한 답변 감지
• 단순한 I ... 구조 반복 감지
• 원어민/자연화 버전 제안
• 중국어: 간체, 병음, 한국어 뜻, 성조/발음 주의점
• Follow-up 질문 자동 생성
• 복습 카드/약점 누적 저장
• 교정문장 TTS 재생
• iPad/Safari 사용을 위한 배포 가이드 포함

Windows 실행

압축을 푼 뒤 run_windows.bat 더블클릭.

또는:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
streamlit run app.py

macOS 실행

run_mac.command 더블클릭. 실행 권한 문제가 있으면 터미널에서:

chmod +x run_mac.command
./run_mac.command

iPad에서 사용

iPad에서 직접 Python 앱을 실행하는 방식은 권장하지 않습니다. 아래 중 하나를 사용하세요.

1) 같은 Wi-Fi 접속

PC/Mac에서 앱 실행 후 터미널에 표시되는 Network URL 예: http://192.168.0.10:8501 를 iPad Safari에서 입력합니다.

2) Streamlit Cloud 배포

1. GitHub에 이 폴더 업로드
2. Streamlit Community Cloud에서 새 앱 생성
3. app.py 선택
4. App settings > Secrets에 아래 등록

OPENAI_API_KEY="sk-..."

5. 배포된 URL을 iPad Safari에서 열고, 공유 버튼 > 홈 화면에 추가

API Key

앱 사이드바에서 직접 입력하거나 .env 파일에 저장하세요.

OPENAI_API_KEY=sk-...

비용 절약 팁

• 실시간 티키타카 대신 현재 방식(녹음→분석→음성재생)을 기본으로 쓰세요.
• TTS는 전체 피드백이 아니라 자연화 문장/반복문장만 재생합니다.
• 긴 답변보다 20~60초 단위 답변을 반복하세요.