From 932e1b76b2c5510c735d8d279af4ad9a9bbaa266 Mon Sep 17 00:00:00 2001
From: EJClaw <claude-bot@ejclaw>
Date: Sun, 9 Aug 2026 21:53:09 +0900
Subject: [PATCH] docs(readme): fix run commands to use workspace venv
 (python/pytest not on PATH)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 README.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index ab3c650..611f291 100644
--- a/README.md
+++ b/README.md
@@ -75,10 +75,12 @@ MeloTTS 등(이 호스트에 기존 자산 있음)으로 음성 응답. 말 끊
 
 ## 실행
 
+이 호스트에는 `python` 별칭이 없으므로 워크스페이스 venv를 사용한다(`.venv/bin/python`, 없으면 `python3`).
+
 ```bash
-python -m wsai            # mock 데모 (의존성·키 불필요, 몇 프레임 돌고 종료)
-python -m wsai --env      # WSAI_* 환경변수로 조립
-pytest                    # 스모크 테스트
+.venv/bin/python -m wsai            # mock 데모 (의존성·키 불필요, 몇 프레임 돌고 종료)
+.venv/bin/python -m wsai --env      # WSAI_* 환경변수로 조립
+.venv/bin/python -m pip install pytest && .venv/bin/python -m pytest -q   # 스모크 테스트(pytest 미설치 시 먼저 설치)
 ```
 
 ## 파일 / 디렉터리