> For the complete documentation index, see [llms.txt](https://melissa-industry.gitbook.io/projectlucia_client/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://melissa-industry.gitbook.io/projectlucia_client/project-lucia-hiyori-edition.md).

# # 📘 Project Lucia - Hiyori Edition 가이드북

**프로젝트 루시아(Project Lucia) 클라이언트 사용자 가이드에 오신 것을 환영합니다.** 본 가이드북은 \*\*히요리 에디션(Hiyori Edition)\*\*을 기준으로 작성되었습니다.

### 🖥️ 시스템 요구 사양

본 클라이언트의 원활한 구동을 위한 권장 및 최소 사양입니다.

| 항목                  | <p>최소 사양 (Minimum)<br><code>\*음성 인식 미사용 기준</code></p>  | <p>권장 사양 (Recommended)<br><code>\*모든 AI 기능 활성화 기준</code></p>     |
| ------------------- | ------------------------------------------------------ | ---------------------------------------------------------------- |
| **운영체제 (OS)**       | Windows 10 / 11 (64-bit 전용)                            | Windows 10 / 11 (64-bit 전용)                                      |
| **프로세서 (CPU)**      | <p>Intel Core i3 / AMD Ryzen 3 이상<br>(듀얼 코어 이상 필수)</p> | <p>Intel Core i5 / AMD Ryzen 5 이상<br>(쿼드 코어 이상 권장)</p>           |
| **메모리 (RAM)**       | 4 GB RAM 이상                                            | 8 GB \~ 16 GB RAM 이상                                             |
| **그래픽 (GPU)**       | Intel UHD Graphics 등 최신 내장 그래픽                         | <p>NVIDIA GTX 1660 / RTX 3050급 이상<br>(VRAM 4GB 이상 외장 GPU 필수)</p> |
| **저장 장치 (Storage)** | 1 GB 이상의 여유 공간                                         | 10 GB 이상의 여유 공간 (SSD 강력 권장)                                      |
| **오디오 입력 (Audio)**  | 없음 (텍스트 전용 대화 가능)                                      | <p>깨끗한 수음이 가능한 마이크 필수<br>(화자 인식 및 실시간 STT용)</p>                  |
| **네트워크 (Network)**  | 서버 및 SQL 연결을 위한 인터넷 환경                                 | 상시 안정적인 초고속 인터넷 환경                                               |

> ⚠️ **주의사항**
>
> * 본 프로그램은 **Windows OS 기반**으로 동작합니다. Linux, iOS, Android 환경에서는 동작을 보장하지 않습니다.
> * 클라이언트 실행 시 **기본 RAM 소모량은 약 200MB** 수준이나, 원활한 OS 멀티태스킹과 Live2D 렌더링 처리를 위해 최소 4GB 이상의 메모리가 확보되어야 합니다.
> * **내장 그래픽 환경:** STT를 미사용하거나 `Base Q5` 모델 적용 및 그래픽 설정을 `Low/VeryLow`로 설정 권장.
> * **외장 그래픽 환경:** 강력 추천 STT 모델인 `Large-v3-Turbo Q8` 모델 사용 시 약 2.0GB VRAM이 요구되므로, `High` 옵션 구동을 위해 4GB 이상의 VRAM이 필수입니다.

***

### 1. 로딩 스크린 (Loading)

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2Fsk0y8f6MXJGRN1JeHuGk%2Fimage.png?alt=media&amp;token=334d3e98-506d-48c9-84b9-0335ae308124" alt=""><figcaption></figcaption></figure>

프로그램 실행 시 로딩 스크린이 표시되며, 시스템은 자동으로 다음 항목들을 점검합니다. 점검 결과에 따라 SD 캐릭터의 표정이 변화하며 상태를 알려줍니다.

* **사용자 설정:** 사전에 저장된 사용자 설정을 불러옵니다.
* **SQL 연결:** 데이터베이스 연결 상태를 점검합니다.
* **Server 연결:** `ProjectLucia_Server`와의 통신 상태를 점검합니다.
* **AI 모델 확인:**
  * `VAD 모델` (음성 감지)
  * `Whisper 모델` (음성 인식)
  * `Keyword 모델` (호출어 감지)
  * `Alert 모델` (윈도우알림 감지)

***

### 2. 메인 화면 (Main)

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2FCSlgY3PmNROSSXUfM5ar%2Fimage.png?alt=media&amp;token=f0c1a731-bbc0-4602-a9b9-dacfd8e2b987" alt=""><figcaption></figcaption></figure>

메인 화면은 히요와의 대화 및 실시간 상태 모니터링을 수행하는 공간입니다.

#### 2.1 주요 영역 구성

* **입력 영역:** 텍스트를 입력하여 대화를 진행합니다.
* **대화 영역:** 캐릭터의 답변이 표시되는 공간입니다.
* **상태 아이콘:** 시스템의 현재 상태를 시각적으로 표시합니다.
  * 🕚 **Think 상태 (11시):**  추론모드 설정 상태(Gemma4 만 지원)
  * 🕐 **Server 상태 (1시):** 서버 연결 상태
  * 🕖 **음성인식 상태 (7시):** 마이크 및 인식 동작 상태
  * 🕔 **실시간 대화 상태 (5시):** 대화 루프 동작 상태

#### 2.2 제어 버튼

| 버튼         | 기능 설명                         |
| ---------- | ----------------------------- |
| **설정**     | 환경 설정 메뉴를 열거나 닫습니다.           |
| **대화 기록**  | 지난 대화 내역을 확인하는 메뉴를 엽니다.       |
| **음성 인식**  | 마이크를 켜거나 끕니다 (On/Off).        |
| **실시간 대화** | 실시간 대화 모드를 활성화/비활성화 합니다.      |
| **추론 모드**  | 추론 모드를 활성화 시킵니다.(Gemma4 만 가능) |

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2FxQlUOMhU5Rfz6U2VOURe%2Fimage.png?alt=media&amp;token=9ae31dca-188e-459c-bb74-bd768ed2dfd9" alt=""><figcaption></figcaption></figure>

#### 2.3 화면 캡처 기능

* **영역 캡처:** `Pause` 키를 누른 채 마우스로 영역 지정
* **전체 캡처:** `Alt` + `Pause`
* **캡처 도중 취소:** `Esc`&#x20;
* **기능:** 캡처된 이미지를 클릭하여 확대하거나, `X` 버튼을 눌러 닫을 수 있습니다.

***

### 3. 잠금 화면 (Lock Screen)

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2FZEDmYe5nUBb33iYVA5Jc%2Fimage.png?alt=media&amp;token=5bf4c257-cc2f-4a40-b5db-56c7c464171a" alt=""><figcaption></figcaption></figure>

외부 사용자의 접근을 차단합니다. 잠금이 해제되기 전까지는 어떠한 작업도 불가능합니다.

> **🔑 기본 비밀번호 안내**
>
> 초기 설정된 비밀번호는 **`3545`** 입니다.

* **입력 영역:** 비밀번호를 입력합니다.
* **재부팅 보안:** 잠금 상태에서 강제로 재부팅 하더라도, 부팅 직후 잠금 상태가 유지됩니다.

***

### 4. 설정 화면 (Settings)

프로젝트 루시아의 모든 환경 설정을 관리합니다.

#### 4.1 Live2D 설정

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2Ff8vgmTX3tBNVFN0AaKZd%2Fimage.png?alt=media&amp;token=737cf2c7-c99d-49f9-946f-b718e38846c7" alt=""><figcaption></figcaption></figure>

**👤 사용자 설정**

* **사용자 이름:** AI가 사용자를 부를 호칭을 설정합니다.
* **성별:** 남성 / 여성 중 선택.
* **생년월일:** 캘린더를 통해 생일을 설정합니다.

**📏 캐릭터 및 폰트**

* **캐릭터 사이즈:** 화면 내 캐릭터 크기 조절 (0% \~ 100%)
* **말풍선 표시:**
  * `제거`: 표시 안 함
  * `알림만`: 중요 알림 시에만 표시
  * `전부`: 모든 대화 표시
* **폰트 크기:** 말풍선 내 텍스트 크기 조절 (0% \~ 100%)

**✨ 캐릭터 반응**

* **마우스 추적:** 캐릭터의 시선이 마우스 커서를 따라갑니다.
* **터치 모션:** 캐릭터 클릭 시 반응 모션을 출력합니다.
* **대기 모션 (Idle):**
  * 설정한 `최소 시간` \~ `최대 시간` (1분\~60분) 범위 내에서 랜덤하게 모션을 수행합니다.

**⌨️ 입력 설정**

* **키보드 입력:** 프로그램 내 키보드 상호작용을 차단할 수 있습니다.

***

#### 4.2 그래픽 설정

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2FEI95Ce8cBD7secDwZ1I8%2Fimage.png?alt=media&amp;token=b1b99323-ae56-4918-8a03-faa3942ed12e" alt=""><figcaption></figcaption></figure>

**🖥️ 그래픽 프리셋 (Quality Presets)**

| 프리셋          | VSync | 안티앨리어싱 | 이방성 텍스쳐 | 텍스처 품질 | 렌더링 품질 |
| ------------ | :---: | :----: | :-----: | :----: | :----: |
| **VeryLow**  |   절반  |  None  |    끄기   |   1/8  |  버텍스릿  |
| **Low**      |   켜기  |  FXAA  |    끄기   |   1/4  |  버텍스릿  |
| **Medium**   |   절반  |  SMAA  |   일부만   |   1/2  |   포워드  |
| **High**     |   끄기  |  MSAA  |   일부만   |   1/2  |   디퍼드  |
| **VeryHigh** |   끄기  |  SMAA  |    켜기   |   전체   |   디퍼드  |
| **Ultra**    |   끄기  |  MSAA  |   zurl  |   전체   |   디퍼드  |

**⚙️ 상세 설정 가이드**

* **재생 빈도 (VSync):** 모니터 주사율 동기화 여부 (`켜기`, `끄기`, `절반`) 및 최대 프레임을 제한합니다.
*

```
<figure><img src="/files/vsOC7Tihu0l5bjD0gbNU" alt=""><figcaption></figcaption></figure>
```

* **안티앨리어싱 (Anti-Aliasing):** 계단 현상 제거 기술&#x20;
  * **FXAA:** 가장 빠름. 화면 전체를 약간 흐리게 처리. (저사양 추천)
  * **SMAA:** FXAA보다 선명하고 외곽선 처리가 우수함.
  * **TAA:** 전 프레임을 활용해 부드럽게 처리. 반짝거림 제어에 탁월. (최신 게임 방식)
  * **MSAA:** 하드웨어 부하가 높지만 가장 깔끔한 외곽선 처리.
* **이방성 텍스쳐:** 원거리 바닥/벽면의 텍스처 뭉개짐 방지.
* **텍스쳐 품질:** 텍스처 해상도 조절 (VRAM 사용량에 영향).
* **다이나믹 해상도:** 프레임 저하 시 자동으로 해상도를 낮춰 성능을 유지합니다.
* **렌더링 품질:** 조명과 그림자 계산 방식 (`버텍스릿` < `포워드` < `디퍼드`).
* **아이콘 페이드:** 메인화면 아이콘의 투명도 효과 설정.

***

#### 4.3 서버 설정 (Server)

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2FE955UJ4C5zuYM1fqh8VW%2Fimage.png?alt=media&amp;token=cd424539-21bb-4710-ab6e-a97be9088f57" alt=""><figcaption></figcaption></figure>

**🌐 연결 상태 및 설정**

* **서버/SQL 상태:** 현재 연결 상태를 실시간으로 확인하며, 필요시 클라이언트에서 **원격 재부팅** 명령을 내릴 수 있습니다.
* **서버 그래픽카드:** 서버 PC의 GPU 정보 및 VRAM 사용량을 모니터링합니다.

**🔗 연결 정보 입력**

> **Tip:** 서버가 현재 컴퓨터와 같다면 `LocalHost` 혹은 `MY IP` 버튼을 사용하세요.

* **Server Port:** 기본값 `3545`
* **SQL Port:** 기본값 `3306`
* **SQL 접속 정보:** DB 이름, ID, 비밀번호를 입력하고 `SQL 설정 적용`을 눌러 저장합니다.

***

#### 4.4 음성인식 설정 (Voice)

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2FC8AgXJD3991FP0jdE9fs%2Fimage.png?alt=media&amp;token=1fdf5feb-b963-47c2-8c53-3201e73ffed4" alt=""><figcaption></figcaption></figure>

**🎤 STT (Whisper) 모델 가이드**

시스템 사양에 맞는 적절한 Whisper 모델을 선택하세요. VRAM이 부족할 경우 경고가 표시됩니다.

| 모델명                | 특징 및 용도                          | 오리지널(FP16) | Q8 (추천)  | Q5 (저사양) |
| ------------------ | -------------------------------- | ---------- | -------- | -------- |
| **Tiny**           | 극소형. 테스트용. 한국어 인식률 낮음.           | 약 500MB    | 약 300MB  | -        |
| **Base**           | 소형. 간단한 명령어 인식용.                 | 약 700MB    | 약 400MB  | -        |
| **Small**          | 중소형. 적당한 속도와 성능.                 | 약 1.5 GB   | 약 1.0 GB | 약 0.8 GB |
| **Medium**         | **표준형**. 한국어 인식률 준수. 속도/품질 타협점.  | 약 3.0 GB   | 약 1.8 GB | 약 1.2 GB |
| **Large-v3-Turbo** | **⭐ 강추**. Large급 성능에 Medium급 용량. | 약 3.2 GB   | 약 2.0 GB | 약 1.5 GB |
| **Large-v3**       | 최고 성능. 가장 정확하나 매우 무거움.           | 약 5.0 GB   | 약 3.0 GB | 약 2.2 GB |

* **VAD/Keyword 모델:** 파일이 없을 경우 다운로드 안내 메뉴가 자동으로 활성화됩니다.
* **감지 언어:** Korean 모드 사용을 권장합니다. (자동 감지 시 오인식 가능성 있음)
* **호출 기능 활성화:** 특정 단어가 있을때 음성을 인식하도록 합니다. 호출 이름을 설정 할 수 있습니다.
* **인식률:** 화자 인식 음성 데이터가있을경우 강도를 조절 할 수 있습니다. (기본값 0.7)

#### 🔊 화자 감지 시스템 가이드 (Speaker Detection System)

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2FujA6tBv3AMiGNtw1TZag%2Fimage.png?alt=media&amp;token=2f8217ac-113a-42b4-a379-7fbcfbf3a758" alt=""><figcaption></figcaption></figure>

화자 감지 시스템을 활성화하기 위해 이미지의에+  버튼을 클릭하여오디오 파일을 추가해 주세요.

#### 파일 역할

* &#x20;**화자 음정 감지:** 화자 본인의 목소리를 넣습니다. 시스템이 이 음성을 참고하여 화자를 \*\*판단(Accept)\*\*합니다.
* **화자 음정 차단:** 필터링하고자 하는 타인의 목소리나 소음을 넣습니다. 시스템이 이 음성을 참고하여 \*\*배제(Reject)\*\*합니다.

***

#### 🎙️ Positive(화자 등록) 녹음 가이드

각 문장은 화자의 **음색(Timbre), 발음 습관, 피치(Pitch) 변화**를 골고루 수집할 수 있도록 설계되었습니다. 정확한 인식을 위해 아래 5가지 대사를 녹음하여 `StreamingAssets` 폴더에 넣어주세요.

#### 1. 안정적인 톤 (기본 발성)

> "안녕하세요. 지금부터 화자 인식을 위해 제 목소리 등록을 진행하겠습니다."

* **목적:** 가장 편안하고 안정적인 기본 목소리 톤을 수집합니다.

#### 2. 의문문과 억양 변화 (높은 피치)

> "혹시 지금 시스템이 제대로 작동하고 있나요? 내 목소리가 잘 들리는지 확인해 줘."

* **목적:** 말끝이 올라가는 의문문 패턴과 평소보다 살짝 높은 톤을 학습합니다.

#### 3. 복합적인 발음과 문장 (음소 다양성)

> "인공지능 모델이 다양한 환경에서도 나를 정확하게 구별할 수 있으면 좋겠어."

* **목적:** 'ㅇ', 'ㅈ', 'ㅎ' 등 다양한 자음과 모음이 섞인 문장으로 발음 특성을 잡습니다.

#### 4. 자연스러운 명령조 (빠른 속도)

> "잠깐만, 방금 그 노래 제목이 뭐였지? 볼륨을 조금만 더 키워줄래?"

* **목적:** 평소 비서(AI)에게 말을 걸 때 나오는 자연스럽고 살짝 빠른 속도의 말투를 반영합니다.

#### 5. 차분하고 낮은 톤 (저음 공명)

> "주변 소음이 없는 조용한 곳에서 차분하게 이야기하고 있습니다. 울림을 잘 잡아주세요."

* **목적:** 저음의 공명과 울림을 학습하여 차분한 상태의 목소리를 인지합니다.

***

#### 4.5 기타 설정 (Etc)

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2Fl2eTCLah4gIZxH6u4dY6%2Fimage.png?alt=media&amp;token=835a221f-0d98-42a2-948e-47539f2478c7" alt=""><figcaption></figcaption></figure>

* **디버그 모드:** 좌표, 프레임, 로그 등을 화면에 표시합니다.
* **알림 감지:** 윈도우 알림을 감지하거나 카톡 알림을 감지해서 대화로 알려줍니다. (주의! 카톡 알림은 환경에따라서 동작하지 않을 수 있습니다!)
* **사용자 감정 인식:**
  * 사용자의 대화를 감정분석을 통하여 현재 감정상태를 같이  전송합니다.
* **실시간 대화 설정**
  * 화면을 실시간으로 체크하여 현재 사용자가 뭐하고있는지 주고받습니다.
  * 해상도(Low/Medium/High), 민감도, 화면 떨림 보정 등을 조절하여 서버 전송 부하를 관리할 수 있습니다.

#### 4.6 상단 시스템 메뉴

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2FiuwEjMBxtFNv0fYZqsBE%2Fimage.png?alt=media&amp;token=ed9d7d93-91c5-4720-b09f-b2cb2f3c7027" alt=""><figcaption></figcaption></figure>

* **🔒 잠금:** 즉시 잠금 활성화, 비밀번호 변경, 부팅 시 잠금 여부 설정.
* **ℹ️ 정보:** 온라인 설명서 이동 및 라이선스 확인.
* **⚙️ 시스템:** 설정 초기화, 프로그램 종료 및 재시작.

***

### 5. 대화 기록 화면 (History)

<figure><img src="https://882833674-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbfd9myCQiasi2EIfG7O0%2Fuploads%2FGvCWttR0fgTZvBhj1R13%2Fimage.png?alt=media&amp;token=dd958320-a57e-4fe1-9b8b-6d63f7ac613f" alt=""><figcaption></figcaption></figure>

카카오톡과 같은 메신저 형식으로 이전 대화 기록을 열람할 수 있습니다.

> **💡 기능 팁**
>
> 대화 내용을 **우클릭**하면 추가 메뉴가 나타납니다.
>
> * **삭제:** 해당 대화를 기록에서 지웁니다.
> * **피드백:** 해당 답변에 대한 피드백을 남길 수 있으며, 이는 추후 모델 재학습 데이터로 활용됩니다.

***

### 📥 수동 다운로드 (Manual Download)

프로그램 내에서 자동 다운로드가 실패할 경우, 아래 링크를 통해 직접 파일을 다운로드할 수 있습니다. 다운로드한 파일은 프로그램이 실행되는 경로(또는 설정된 모델 폴더)에 \*\*파일명(Filename)\*\*과 동일한 이름으로 저장해 주세요.

#### 1. Whisper Models (Standard)

|   모델명 (Model)  | 파일명 (Filename)            |                                          다운로드 (Link)                                          | SHA1 Checksum                              |
| :------------: | ------------------------- | :-------------------------------------------------------------------------------------------: | ------------------------------------------ |
|      Tiny      | `ggml-tiny.bin`           |      [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-tiny.bin)      | `bd577a113a864445d4c299885e0cb97d4ba92b5f` |
|      Small     | `ggml-small.bin`          |      [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.bin)     | `55356645c2b361a969dfd0ef2c5a50d530afd8d5` |
|      Base      | `ggml-base.bin`           |      [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin)      | `465707469ff3a37a2b9b8d8f89f2f99de7299dac` |
|     Medium     | `ggml-medium.bin`         |     [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-medium.bin)     | `fd9727b6e1217c2f614f9b698455c4ffd82463b4` |
|    Large V3    | `ggml-large-v3.bin`       |    [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3.bin)    | `ad82bf6a9043ceed055076d0fd39f5f186ff8062` |
| Large V3 Turbo | `ggml-large-v3-turbo.bin` | [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin) | `4af2b29d7ec73d781377bfd1758ca957a807e941` |

#### 2. Whisper Models (Quantized Q8)

> **Note:** Q8 모델은 성능과 속도의 균형이 잡힌 모델입니다.

|    모델명 (Model)    | 파일명 (Filename)               |                                             다운로드 (Link)                                            | SHA1 Checksum                              |
| :---------------: | ---------------------------- | :------------------------------------------------------------------------------------------------: | ------------------------------------------ |
|      Tiny Q8      | `ggml-tiny-q8.bin`           |      [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-tiny-q8_0.bin)      | `19e8118f6652a650569f5a949d962154e01571d9` |
|      Small Q8     | `ggml-small-q8.bin`          |      [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small-q8_0.bin)     | `bcad8a2083f4e53d648d586b7dbc0cd673d8afad` |
|      Base Q8      | `ggml-base-q8.bin`           |      [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base-q8_0.bin)      | `7bb89bb49ed6955013b166f1b6a6c04584a20fbe` |
|     Medium Q8     | `ggml-medium-q8.bin`         |     [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-medium-q8_0.bin)     | `e66645948aff4bebbec71b3485c576f3d63af5d6` |
|    Large V3 Q8    | `ggml-large-v3-q8.bin`       |    [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v2-q8_0.bin)    | `da97d6ca8f8ffbeeb5fd147f79010eeea194ba38` |
| Large V3 Turbo Q8 | `ggml-large-v3-turbo-q8.bin` | [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q8_0.bin) | `01bf15bedffe9f39d65c1b6ff9b687ea91f59e0e` |

#### 3. Whisper Models (Quantized Q5)

> **Note:** Q5 모델은 메모리 사용량이 적고 속도가 빠릅니다.

|    모델명 (Model)    | 파일명 (Filename)               |                                             다운로드 (Link)                                            | SHA1 Checksum                              |
| :---------------: | ---------------------------- | :------------------------------------------------------------------------------------------------: | ------------------------------------------ |
|      Tiny Q5      | `ggml-tiny-q5.bin`           |      [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-tiny-q5_1.bin)      | `2827a03e495b1ed3048ef28a6a4620537db4ee51` |
|      Small Q5     | `ggml-small-q5.bin`          |      [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small-q5_1.bin)     | `6fe57ddcfdd1c6b07cdcc73aaf620810ce5fc771` |
|      Base Q5      | `ggml-base-q5.bin`           |      [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base-q5_1.bin)      | `a3733eda680ef76256db5fc5dd9de8629e62c5e7` |
|     Medium Q5     | `ggml-medium-q5.bin`         |     [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-medium-q5_0.bin)     | `7718d4c1ec62ca96998f058114db98236937490e` |
|    Large V3 Q5    | `ggml-large-v3-q5.bin`       |    [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-q5_0.bin)    | `e6e2ed78495d403bef4b7cff42ef4aaadcfea8de` |
| Large V3 Turbo Q5 | `ggml-large-v3-turbo-q5.bin` | [Download](https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q5_0.bin) | `e050f7970618a659205450ad97eb95a18d69c9ee` |

#### 4. Auxiliary Models (VAD, Speaker, Keyword)

| 구분 (Type)            | 파일명 (Filename)           |                                                               다운로드 (Link)                                                              | SHA1 / Hash Checksum                                               |
| -------------------- | ------------------------ | :------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------ |
| **VAD** (Silero)     | `silero_vad.onnx`        |                         [Download](https://huggingface.co/deepghs/silero-vad-onnx/resolve/main/silero_vad.onnx)                        | `e1e78d47ed5f5577c6d6b64b392a53936c2ca93e`                         |
| **Speaker Recog**    | `voxceleb.onnx`          |                    [Download](https://huggingface.co/MelissaJ/spkrec-ecapa-voxceleb-onnx/resolve/main/voxceleb.onnx)                   | `0cc44ed48e5dcd74516554d78962e8f6fd75af4d`                         |
| **Keyword Spotting** | `model_quint8_avx2.onnx` | [Download](https://huggingface.co/sentence-transformers/distiluse-base-multilingual-cased-v2/resolve/main/onnx/model_quint8_avx2.onnx) | `4aee880a7e1bfeafb6efedf7e3fe2a9a67dd5a8a`                         |
| **Vocabulary**       | `vocab.txt`              |          [Download](https://huggingface.co/sentence-transformers/distiluse-base-multilingual-cased-v2/resolve/main/vocab.txt)          | `fe0fda7c425b48c516fc8f160d594c8022a0808447475c1a7c6d6479763f310c` |

***

> **Copyright**
>
> 본 가이드북 및 소프트웨어는 원작자의 동의 없이 임의로 수정하거나 배포할 수 없습니다. © MelissaJ. All rights reserved.