Metadata-Version: 2.4
Name: qwen3-tts
Version: 0.1.0
Summary: Qwen3 CustomVoice 命令行工具
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: huggingface-hub>=1.9.0
Requires-Dist: mlx>=0.31.1
Requires-Dist: mlx-audio[tts]>=0.4.2
Requires-Dist: mlx-lm>=0.31.1
Requires-Dist: numpy>=2.4.4
Requires-Dist: scipy>=1.17.1
Requires-Dist: sentencepiece>=0.2.1
Requires-Dist: tiktoken>=0.12.0

# shell

自用脚本、Shell 配置和本地工具仓库。

## 目录概览

- `shell-configs/`: Bash / Zsh / Fish / PowerShell 配置与安装脚本
- `press-to-talk/`: 语音转文字后的意图分类、工具调用与 TTS 播报链路
- `qwen3_tts_cli/`: Qwen3 TTS 命令行工具
- `config/`: 运维相关配置
- `memory/`: 临时记录和排障笔记

## Shell Configs

- 总览：[`shell-configs/README.md`](shell-configs/README.md)
- Fish on WSL: [`shell-configs/fish/installfish.sh`](shell-configs/fish/installfish.sh)
- macOS Zsh: [`shell-configs/zsh/macos/README.md`](shell-configs/zsh/macos/README.md)
- Debian/Ubuntu Bash + Vim: [`shell-configs/bash-vim-bootstrap/README.md`](shell-configs/bash-vim-bootstrap/README.md)

## Qwen3 TTS CLI

`qwen3_tts_cli/` 提供了一个可全局安装的命令行工具。现在已经发布到私有 simple 索引：

```bash
https://wp2.ursoftware.com/simple/
```

如果你想在任何机器上直接执行 `uvx qwen3-tts`，不需要运行本项目自己的安装脚本，但需要先在该机器上给 `uv` 配一次索引。最直接的方法是执行仓库里的脚本：

```bash
./scripts/configure-uv-for-qwen3-tts
uvx qwen3-tts --help
```

配置完成后，就可以直接用：

```bash
uvx qwen3-tts --help
uvx qwen3-tts speak --text "你好，大王"
```

仓库内也保留了本地安装脚本，方便你把命令挂到系统 PATH：

```bash
./scripts/install-qwen3-tts
```

默认会把 `qwen3-tts` 和 `qwen3-tts-cli` 挂到 `/usr/local/bin`。如果你想安装到别的目录：

```bash
uv run --directory . qwen3-tts-cli install --install-dir "$HOME/.local/bin"
```

安装后可以在任何位置直接使用：

```bash
qwen3-tts speak --text "你好，大王"
qwen3-tts-cli doctor --check-model
```
