BlahST 项目启动与配置教程

1. 项目的目录结构及介绍

BlahST 项目是一个基于 whisper.cpp 的开源语音识别工具，它允许用户在 Linux 系统中通过麦克风输入语音并实时转换为文本。以下是项目的目录结构及文件介绍：

• README.md：项目的说明文件，包含了项目的简介、功能介绍、使用方法等信息。
• LICENSE：项目的许可证文件，本项目采用 BSD-3-Clause 许可证。
• API_TRANSCRIBE.md：API 文档，可能包含与项目交互的接口说明。
• install-wsi：安装脚本，用于安装 whisper.cpp 以及其他必要的依赖。
• wsi： Whisper Speech Input 的主脚本，用于语音输入。
• wsiml：支持多语言语音输入的脚本。
• wsiAI：集成了 AI 功能的语音输入脚本，可以与本地的大型语言模型进行交互。
• blooper：实验性的连续语音输入工具，支持自动粘贴和停止。
• blahstbot：用于与本地大型语言模型进行低延迟语音聊天的工具。
• blahstbotml.mp4：演示视频文件，展示多语言聊天功能。
• blooper-Demo.mp4：演示视频文件，展示 blooper 工具的使用。
• BlahST-AI-Demo.mp4：演示视频文件，展示 AI 功能的演示。

2. 项目的启动文件介绍

项目的启动主要通过以下脚本进行：

• wsi：这是项目的主要启动脚本，用户可以通过热键触发该脚本，从而启动语音输入功能。
• wsiml：对于多语言用户，可以使用这个脚本来启动语音输入功能，它支持多种语言的语音识别。
• wsiAI：如果用户希望与本地的大型语言模型进行交互，可以使用这个脚本来启动语音输入，并集成 AI 功能。
• blooper：如果用户需要进行连续的语音输入，可以使用这个脚本，它会在检测到长暂停时自动停止。

3. 项目的配置文件介绍

项目的配置主要通过以下文件进行：

• blahst.cfg：这是项目的主要配置文件，用户可以在这个文件中设置热键、选择语音输入语言、配置 whisper.cpp 或 llama.cpp 的路径等。

配置文件示例：

[hotkeys]
start = Ctrl+Shift+S
stop = Ctrl+Shift+P

[whisper]
path = /path/to/whisper.cpp
model = base

[llama]
path = /path/to/llama.cpp
model = gemma3

[options]
language = en

在配置文件中，用户可以根据自己的需求调整热键设置、whisper.cpp 和 llama.cpp 的路径以及默认的语音输入语言等。确保配置正确后，项目的功能将按照用户的设置运行。