{"id":28373731,"url":"https://github.com/mautops/clearvoice","last_synced_at":"2025-06-25T15:33:11.916Z","repository":{"id":287580298,"uuid":"965177112","full_name":"mautops/clearvoice","owner":"mautops","description":"clearvoice on websocket","archived":false,"fork":false,"pushed_at":"2025-04-13T01:23:59.000Z","size":223,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-29T20:24:49.217Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mautops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-12T15:28:15.000Z","updated_at":"2025-05-15T08:57:55.000Z","dependencies_parsed_at":"2025-04-12T16:52:56.195Z","dependency_job_id":null,"html_url":"https://github.com/mautops/clearvoice","commit_stats":null,"previous_names":["mautops/clearvoice"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mautops/clearvoice","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mautops%2Fclearvoice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mautops%2Fclearvoice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mautops%2Fclearvoice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mautops%2Fclearvoice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mautops","download_url":"https://codeload.github.com/mautops/clearvoice/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mautops%2Fclearvoice/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261901353,"owners_count":23227581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-29T20:13:00.117Z","updated_at":"2025-06-25T15:33:11.897Z","avatar_url":"https://github.com/mautops.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ClearVoice - 语音增强系统\n\nClearVoice 是一个基于 WebSocket 的实时语音增强系统，可以对带有噪声的语音进行处理和增强。系统包含服务端和客户端两个组件，使用 Python Socket.IO 实现实时通信。\n\n## 功能特点\n\n- 实时语音处理和增强\n- WebSocket 双向通信\n- 支持房间机制，可处理多个客户端\n- 自动音频播放功能\n\n## 环境要求\n\n- Python 3.10+\n- Docker（可选，用于容器化部署）\n\n## 安装说明\n\n### 方法一：使用 uv 安装（推荐）\n\n1. 安装依赖：\n```bash\nuv pip install -r requirements.txt\n```\n\n2. 安装额外依赖 PyAudio（用于客户端音频播放）：\n```bash\nuv pip install pyaudio\n```\n\n### 方法二：使用 Docker（仅服务端）\n\n1. 构建 Docker 镜像：\n```bash\ndocker build -t clearvoice .\n```\n\n2. 运行容器：\n```bash\ndocker run -d -p 5000:5000 clearvoice\n```\n\n## 使用说明\n\n### 启动服务端\n\n1. 直接运行：\n```bash\npython server.py\n```\n\n服务端将在 `0.0.0.0:5000` 启动，并监听 WebSocket 连接。\n\n### 运行客户端\n\n1. 确保服务端已经启动\n2. 准备音频文件：将需要处理的音频文件命名为 `speech_with_noise.wav` 并放在项目根目录\n3. 运行客户端：\n```bash\npython client.py\n```\n\n客户端将：\n1. 连接到服务端\n2. 自动加入以音频文件名为 ID 的房间\n3. 发送音频数据进行处理\n4. 接收处理后的音频并自动播放\n5. 完成后自动断开连接\n\n## 配置说明\n\n- 服务端端口：默认为 5000，可在 `server.py` 中修改\n- 客户端连接地址：默认为 `ws://0.0.0.0:5001`，可在 `client.py` 中修改\n- 音频文件：默认读取 `speech_with_noise.wav`，可在 `client.py` 中修改\n\n## 注意事项\n\n1. 确保运行客户端前已安装 PyAudio\n2. 使用 Docker 时只包含服务端功能\n3. 客户端需要在本地运行以支持音频播放\n4. 默认支持的音频格式为 16bit、单声道、16kHz 的 WAV 文件\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmautops%2Fclearvoice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmautops%2Fclearvoice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmautops%2Fclearvoice/lists"}