이 글에서 가장 먼저 확인할 것은 무엇인가요?

Moonshine Voice는 CPU에서 실행하는 로컬 음성 인식 도구예요. 영어용 CLI는 마이크 입력 중 전사를 갱신하고, 현재 한국어 Tiny 모델은 비스트리밍 방식으로 제공돼요.

로컬 음성 인식·합성

최종 업데이트 2026-10-30

Moonshine으로 GPU 없이 영어 음성을 실시간 받아쓰기

영어는 실시간 모델로 시험할 수 있지만, 한국어 모델은 아직 스트리밍 경로와 라이선스가 다릅니다.

Moonshine Voice는 CPU¹에서 실행하는 로컬 음성 인식 도구예요. 영어용 CLI²는 마이크 입력 중 전사를 갱신하고, 현재 한국어 Tiny 모델은 비스트리밍 방식으로 제공돼요.

실행 조건과 핵심 내용

영어 마이크 예제는 moonshine-voice mic --language en으로 시작해요.
공식 도구 설명은 CPU·모바일·브라우저에서의 기기 내 실행을 안내해요.
한국어는 아직 streaming checkpoint가 없어 표준 실시간 경로와 구분해야 해요.

영어 실시간 입력부터 시작해요

Moonshine Voice는 말소리를 텍스트로 바꾸는 로컬 음성 인식 도구예요. CPU에서도 실행하고, 영어 마이크 CLI는 사용자가 말하는 동안 전사 내용을 화면에 갱신합니다. 오디오 입력을 서버로 보내지 않고 기기에서 처리하는 구성이 목표라면 짧은 마이크 시험으로 먼저 작업 흐름을 확인할 수 있어요. Moonshine Voice 안내

Windows PowerShell에서 실행

python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install moonshine-voice
moonshine-voice mic --language en

공식 빠른 시작은 moonshine-voice를 설치한 뒤 mic 명령으로 영어 마이크를 여는 절차예요. 운영체제에 맞게 가상환경³을 활성화한 다음 패키지를 설치하세요. 첫 실행에서 모델 자산을 준비하므로 인터넷 연결과 로컬 저장 공간이 필요합니다.

가상환경과 Moonshine CLI 준비

python -m venv .venv
source .venv/bin/activate
python -m pip install moonshine-voice
moonshine-voice mic --language en

마이크 옆의 노트북에 음성 파형이 표시된 화면 — 마이크 권한을 허용한 뒤 영어로 짧게 말해요.

마이크 권한과 실시간 문장을 확인해요

운영체제에서 터미널의 마이크 권한을 허용하면 말한 문장이 표시돼요. 짧게 말하고 잠시 멈춰 전사가 새 텍스트를 추가하거나 문장을 마무리하는지 확인하세요. 출력이 나오지 않으면 운영체제의 개인정보 설정에서 터미널 마이크 권한을 켜고, CLI가 선택한 언어가 en인지 살펴보세요. 공식 Quickstart

웹 앱에 받아쓰기를 넣으려면 브라우저용 @moonshine-ai/moonshine-wasm을 사용할 수 있어요. 공식 문서의 패키지 설치 또는 CDN 예제에서 시작해 모델 다운로드와 마이크 권한 요청을 연결하면 됩니다.

한국어 모델은 실시간 영어 경로와 달라요

현재 모델 문서는 한국어를 스트리밍 지원 언어에 포함하지 않고, 26M 파라미터 Tiny 비스트리밍 모델을 별도로 안내해요. 영어 CLI의 실시간 사용 흐름을 한국어 받아쓰기에 그대로 적용할 수는 없습니다. 한국어 음성이 필요하다면 실제 문장으로 먼저 시험하세요. Moonshine 모델 목록

Moonshine 모델 목록은 영어 스트리밍 모델을 MIT로, 한국어 Tiny 모델을 Community License로 구분해요. 해당 Community License는 비상업적 조건이므로 상업 서비스나 유료 제품에 쓰려면 이 체크포인트⁴를 사용할 수 있다고 가정하지 마세요. 용도가 영어 실시간 전사인지 한국어 오프라인 인식인지 먼저 정하면 모델과 라이선스를 함께 고르기 쉬워요.

헤드폰과 마이크, 전사 작업 화면이 놓인 책상 — 말하는 동안 바뀌는 전사를 확인해요.

실시간 표시가 내 작업에 맞는지 판단해요

영어 회의의 짧은 구간을 읽고 화면의 숫자와 고유명사를 원음과 비교하세요. 잘 인식된 문장은 메모 초안에 붙여 넣고, 회의록에 옮기기 전에는 중요한 이름을 녹음에서 다시 들으면 됩니다.

녹음기와 메모, 음성 인식 결과를 듣는 헤드폰 — 필요한 언어가 실시간 지원 대상인지 모델 목록에서 확인해요.

용어 각주

CPU — 운영체제와 일반 프로그램 명령을 실행하고, AI에서는 전처리·데이터 이동 등 범용 연산을 맡는 중앙 처리 장치입니다.
본문으로 돌아가기
CLI — Command-Line Interface의 약자입니다. 터미널에 명령어를 입력해 프로그램을 조작하는 방식입니다.
본문으로 돌아가기
Python 가상환경 — 프로젝트별로 Python 패키지를 분리해 설치하는 공간입니다. 패키지 버전 충돌을 줄이는 데 쓰입니다.
본문으로 돌아가기
체크포인트 — 학습된 모델의 가중치 등을 저장한 파일입니다. 같은 모델 계열도 버전이나 용도에 따라 다른 체크포인트를 쓸 수 있습니다.
본문으로 돌아가기

자주 묻는 질문

이 글에서 가장 먼저 확인할 것은 무엇인가요?: Moonshine Voice는 CPU에서 실행하는 로컬 음성 인식 도구예요. 영어용 CLI는 마이크 입력 중 전사를 갱신하고, 현재 한국어 Tiny 모델은 비스트리밍 방식으로 제공돼요.
선택하지 않는 편이 좋은 경우는 언제인가요?: Moonshine 모델 목록은 영어 스트리밍 모델을 MIT로, 한국어 Tiny 모델을 Community License로 구분해요. 해당 Community License는 비상업적 조건이므로 상업 서비스나 유료 제품에 쓰려면 이 체크포인트를 사용할 수 있다고 가정하지 마세요. 용도가 영어 실시간 전사인지 한국어 오프라인 인식인지 먼저 정하면 모델과 라이선스를 함께 고르기 쉬워요.
조건과 출처는 어디서 확인하나요?: Moonshine 모델 목록은 영어 스트리밍 모델을 MIT로, 한국어 Tiny 모델을 Community License로 구분해요. 해당 Community License는 비상업적 조건이므로 상업 서비스나 유료 제품에 쓰려면 이 체크포인트를 사용할 수 있다고 가정하지 마세요. 용도가 영어 실시간 전사인지 한국어 오프라인 인식인지 먼저 정하면 모델과 라이선스를 함께 고르기 쉬워요.