본문으로 건너뛰기
렛츠코딩
← 렛츠코딩 블로그

도구

Python 3.11 윈도우 설치 방법, Whisper를 쓰기 위한 준비

음성 인식 도구 Whisper를 쓰려면 Python이 필요합니다. 윈도우에 Python 3.11을 설치하고, PATH 체크와 py 명령으로 설치를 확인하고, 자주 막히는 문제를 푸는 방법을 정리했습니다.

이형구렛츠코딩앤플레이학원 원장약 7분

먼저 설치할 프로그램은 없습니다. 이 글부터 바로 시작하면 됩니다.

Python은 많은 AI 도구가 만들어진 프로그래밍 언어이자, 그렇게 만든 프로그램을 실행해 주는 환경입니다. Python을 설치한다는 것은 Python으로 만든 프로그램을 내 컴퓨터에서 돌릴 수 있게 준비한다는 뜻입니다.

외국어로 쓰인 책과 번역가에 비유할 수 있습니다. Whisper라는 책은 Python이라는 언어로 쓰여 있습니다. 컴퓨터가 이 책을 읽으려면 Python을 아는 번역가가 옆에 있어야 합니다. 여러분이 Python 문법을 배울 필요는 없고, 번역가만 들여놓으면 됩니다.

이 수업에서 하는 일

「영상 제작을 위한 AI 활용」 수업은 녹음을 Whisper로 받아 적고, Hyperframes로 장면을 영상으로 만들고, Concat으로 편집하고, kie.ai로 필요한 장면을 생성하는 흐름으로 진행합니다.

Python은 첫 단계인 Whisper를 설치하고 실행하는 데 필요합니다. 수업에서 Python 코드를 직접 쓰지는 않습니다.

이 시리즈는 Python 3.11을 기준으로 합니다. 공식 Whisper 안내에는 Python 3.8부터 3.11까지와 호환된다고 적혀 있습니다. 더 높은 버전에서도 될 수 있지만, 수업에서 문제가 생기지 않도록 확인된 범위 안의 3.11로 맞춥니다.

윈도우에 설치하기

python.org 첫 화면의 큰 다운로드 버튼은 가장 최신 버전을 받습니다. 이 수업에서는 3.11을 직접 골라서 받아야 합니다.

1) https://www.python.org/downloads/release/python-3119/ 에 접속합니다. Python 3.11.9 안내 페이지입니다. 2) 페이지 아래 Files 목록에서 Windows installer (64-bit)를 받습니다. 파일 이름은 python-3.11.9-amd64.exe입니다. 3) 받은 파일을 실행합니다. 4) 첫 화면 아래쪽의 Add python.exe to PATH 칸을 반드시 체크합니다. 설치 파일에 따라 Add Python 3.11 to PATH처럼 조금 다르게 적혀 있을 수 있는데, PATH라는 단어가 들어간 칸이면 같은 것입니다. 이 수업에서 가장 중요한 단계입니다. 5) Install Now를 누릅니다. 6) 설치가 성공했다는 화면이 나오면 Close를 누릅니다.

3.11.9를 고르는 이유가 있습니다. Python 3.11은 지금 보안 수정만 받는 단계라서, 그 뒤로 나온 3.11 버전은 윈도우 설치 파일 없이 소스 코드로만 배포됩니다. python.org 윈도우 다운로드 목록에서 설치 파일이 있는 마지막 3.11 버전이 3.11.9입니다.

첫 화면 아래쪽에는 py 런처(py.exe)를 관리자 권한으로 설치할지 묻는 칸도 있습니다. Python 공식 문서에 따르면 Install Now는 관리자 권한 없이 내 계정에 설치되는데, py 런처를 모든 사용자용으로 설치할 때는 관리자 권한이 필요합니다. 회사 PC에서 관리자 권한이 없다면 이 칸의 체크를 끄고 설치하세요.

winget을 쓸 수 있다면 PowerShell에서 아래 명령으로 설치해도 됩니다.

winget install Python.Python.3.11

이 명령은 python.org의 3.11.9 설치 파일을 받아 설치합니다.

어느 방법이든 설치가 끝나면 열려 있는 PowerShell 창을 닫고 새 창을 여세요. 이전 창에서는 새로 설치한 Python을 찾지 못합니다.

설치 확인

새 PowerShell 창에서 아래 명령을 차례로 입력합니다.

py --version
py -3.11 -m pip --version

py는 윈도우용 Python 실행 도우미입니다. 첫 줄은 설치된 Python 버전을 보여 줍니다. 둘째 줄은 Python 3.11에 딸린 pip가 준비됐는지 확인합니다. 아래와 비슷하게 나오면 정상입니다. 경로 부분은 컴퓨터마다 다릅니다.

Python 3.11.9
pip (버전 숫자) from C:\Users\(내 계정)\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip (python 3.11)

첫 줄에 3.11이 아닌 다른 버전이 나온다면, 컴퓨터에 다른 Python이 이미 설치되어 있는 것입니다. py는 가장 높은 버전을 먼저 보여 줍니다. 이 경우에도 둘째 줄이 python 3.11로 끝나면 수업 준비에는 문제가 없습니다.

처음 써 보기

Python이 실제로 프로그램을 실행하는지 한 줄 예제로 확인합니다.

py -3.11 -c "print('안녕하세요')"

-3.11은 여러 버전 중 3.11을 쓰라는 뜻이고, -c는 따옴표 안의 Python 한 줄을 실행하라는 뜻입니다. 화면에 안녕하세요가 나오면 됩니다.

다음은 대화형 창을 열어 봅니다.

py -3.11

화면에 >>> 표시가 나오면 Python에 바로 말을 거는 상태입니다. 1 + 2를 입력하고 Enter를 누르면 3이 나옵니다. 빠져나올 때는 exit()를 입력하고 Enter를 누릅니다.

수업에서 Whisper를 설치할 때도 같은 방식으로 py -3.11 -m pip로 시작하는 명령을 씁니다. 버전을 매번 적어 주면, 컴퓨터에 Python이 여러 개 있어도 엉뚱한 버전에 설치되는 일을 막을 수 있습니다.

자주 막히는 곳

1) python을 입력했더니 Microsoft Store가 열리는 경우

윈도우에는 python을 입력하면 Microsoft Store의 Python 페이지를 열어 주는 기능(앱 실행 별칭)이 들어 있습니다. 이 글처럼 py 명령을 쓰면 이 문제를 피할 수 있습니다. python 명령을 꼭 쓰고 싶다면 윈도우 설정에서 앱 실행 별칭을 검색해 python.exe와 python3.exe 항목을 끄세요.

2) py 명령을 찾지 못한다는 오류

py : 'py' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.

설치 전에 연 창을 그대로 쓰고 있다면 새 창을 여세요. 그래도 같다면 설치 파일을 다시 실행해 Modify를 고르고, py 런처 설치 항목이 체크되어 있는지 확인합니다.

3) Add python.exe to PATH 체크를 빠뜨린 경우

py 명령은 PATH 체크와 상관없이 동작하는 경우가 많지만, 나중에 Whisper 같은 프로그램의 명령을 찾지 못하는 원인이 됩니다. 설치 파일을 다시 실행해 Uninstall로 지운 뒤, 체크를 켜고 다시 설치하는 것이 가장 확실합니다.

4) 여러 버전이 섞여 있는 경우

예전에 설치한 Python이 있으면 어떤 버전이 실행되는지 헷갈립니다. 아래 명령으로 설치된 목록을 볼 수 있습니다.

py --list

목록에 3.11이 보이면, 수업에서는 항상 py -3.11을 붙여서 쓰면 됩니다.

5) 회사 PC에서 막히는 경우

설치 권한이 없거나, 나중에 pip로 패키지를 내려받을 때 사내망이 막는 경우가 있습니다. 특히 Whisper는 설치할 때 큰 파일을 여러 개 내려받습니다. 수업 전에 교육 담당자에게 프로그램 설치와 패키지 다운로드가 가능한지 확인해 주세요.

용어 풀이

인터프리터: Python 코드를 한 줄씩 읽어 실행하는 프로그램입니다. 우리가 설치한 Python이 바로 인터프리터입니다. pip: Python용 프로그램(패키지)을 내려받아 설치하는 도구입니다. Python과 함께 설치됩니다. 패키지: 다른 사람이 만들어 공개한 Python 프로그램 묶음입니다. Whisper도 패키지 형태로 설치합니다. py 런처: 윈도우에서 여러 Python 버전 중 원하는 것을 골라 실행해 주는 도우미입니다. 가상환경: 프로젝트마다 패키지를 따로 담아 두는 독립된 공간입니다. 실무에서는 많이 쓰지만, 이 수업에서는 단순하게 진행하려고 쓰지 않습니다.

맥에서는

맥은 python.org의 Python 3.11.9 안내 페이지에서 macOS 64-bit universal2 installer를 받아 설치하거나, Homebrew를 쓰고 있다면 brew install python@3.11로 설치합니다. 맥에는 py 명령이 없으므로, 터미널에서 python3.11 --version과 python3.11 -m pip --version으로 확인합니다. 이 시리즈에서 py -3.11로 쓴 부분은 맥에서는 python3.11로 바꿔 읽으면 됩니다.

다음 글

다음 글에서는 지금 설치한 Python과 앞에서 설치한 FFmpeg를 써서, 녹음을 글과 자막으로 바꾸는 Whisper를 설치합니다. Whisper 한국어 음성 전사, 윈도우에서 설치부터 자막(SRT)까지

시리즈 전체 목록: https://www.letscoding.kr/blog/category/tools

공식 문서: https://www.python.org/downloads/windows/ https://docs.python.org/3.11/using/windows.html https://github.com/openai/whisper 확인일: 2026-11-02