Initial commit: Voice recorder app

DEPLOY.md

@@ -0,0 +1,113 @@
+# 部署到 Hugging Face Spaces
+
+## 方法一：使用 Git 推送
+
+### 1. 創建新的 Space
+
+1. 前往 https://huggingface.co/spaces
+2. 點擊 "Create new Space"
+3. 填寫以下資訊：
+   - **Space name**: `voice-recorder`（或你喜歡的名字）
+   - **License**: MIT
+   - **SDK**: Gradio
+   - **Visibility**: Public 或 Private
+
+### 2. 克隆 Space 倉庫
+
+```bash
+# 替換為你的 username 和 space name
+git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
+cd YOUR_SPACE_NAME
+```
+
+### 3. 複製文件
+
+```bash
+# 將本地文件複製到 space 目錄
+cp /home/picard/voicerecord/app.py .
+cp /home/picard/voicerecord/requirements.txt .
+cp /home/picard/voicerecord/README.md .
+```
+
+### 4. 推送代碼
+
+```bash
+git add .
+git commit -m "Initial commit: Voice recorder app"
+git push
+```
+
+### 5. 等待部署
+
+Hugging Face 會自動部署你的應用，通常需要 1-2 分鐘。
+部署完成後，你可以在 Space 頁面看到應用程式。
+
+---
+
+## 方法二：直接上傳文件
+
+1. 前往你的 Space 頁面
+2. 點擊 "Files" 標籤
+3. 點擊 "Add file" → "Upload files"
+4. 上傳以下文件：
+   - `app.py`
+   - `requirements.txt`
+   - `README.md`
+5. 點擊 "Commit changes to main"
+
+---
+
+## 本地測試
+
+在部署之前，建議先在本地測試：
+
+```bash
+cd /home/picard/voicerecord
+bash run_local.sh
+```
+
+然後在瀏覽器中開啟：http://localhost:7860
+
+---
+
+## 使用說明
+
+### 在 Hugging Face Spaces 上
+
+1. 開啟你的 Space 頁面
+2. 點擊 "🔴 開始錄音" 按鈕
+3. 允許瀏覽器使用麥克風
+4. 對著麥克風說話
+5. 點擊 "⏹️ 停止錄音" 按鈕
+6. 點擊 "💾 保存錄音" 按鈕
+7. 錄音將保存為 16kHz WAV 文件
+8. 點擊音頻播放器右側的下載按鈕可下載文件
+
+### 注意事項
+
+- **麥克風權限**：首次使用時需要授權麥克風權限
+- **瀏覽器相容性**：建议使用 Chrome、Firefox 或 Edge
+- **錄音長度**：建議每段錄音不超過 60 秒
+- **文件格式**：所有錄音都保存為 16kHz 單聲道 WAV 格式
+
+---
+
+## 疑難排解
+
+### 麥克風無法使用
+
+1. 檢查瀏覽器是否已授權麥克風權限
+2. 檢查系統麥克風設定
+3. 嘗試使用 HTTPS（Hugging Face Spaces 預設使用 HTTPS）
+
+### 應用無法載入
+
+1. 檢查 `requirements.txt` 是否包含所有依賴
+2. 查看 Space 的 "Logs" 標籤查看錯誤訊息
+3. 確保 `app.py` 沒有語法錯誤
+
+### 音頻質量問題
+
+- 確保錄音環境安靜
+- 麥克風距離嘴巴約 10-20 公分
+- 避免對著麥克風吹氣

README.md

@@ -1,13 +1,40 @@
 ---
-title: Voicerecord
-emoji: ⚡
+title: 語音錄音器
+emoji: 🎤
 colorFrom: blue
-colorTo: indigo
+colorTo: purple
 sdk: gradio
-sdk_version: 6.9.0
+sdk_version: 4.44.0
 app_file: app.py
 pinned: false
 license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 語音錄音器
+
+從麥克風錄音並保存為 16kHz WAV 文件的 Gradio 應用程式。
+
+## 使用方式
+
+1. 點擊 **🔴 開始錄音** 按鈕
+2. 對著麥克風說話
+3. 點擊 **⏹️ 停止錄音** 按鈕
+4. 點擊 **💾 保存錄音** 按鈕保存文件
+
+## 設定
+
+- 採樣率：16000 Hz
+- 格式：WAV
+- 聲道：單聲道
+- 位元深度：16-bit
+
+## 本地運行
+
+```bash
+pip install -r requirements.txt
+python app.py
+```
+
+## 授權
+
+MIT License

app.py

@@ -0,0 +1,202 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+語音錄音應用程式
+部署在 Hugging Face Spaces 上，從麥克風錄音並保存為 16kHz WAV 文件
+
+Usage:
+    python app.py
+"""
+
+import gradio as gr
+import numpy as np
+import wave
+import os
+from datetime import datetime
+from pathlib import Path
+
+# 設定
+SAMPLE_RATE = 16000  # 16kHz
+OUTPUT_DIR = "recordings"  # 錄音保存目錄
+
+# 確保輸出目錄存在
+os.makedirs(OUTPUT_DIR, exist_ok=True)
+
+
+def save_audio(audio_data: np.ndarray, sr: int) -> str:
+    """
+    將音頻數據保存為 WAV 文件
+    
+    Args:
+        audio_data: 音頻數據 (numpy array)
+        sr: 採樣率
+        
+    Returns:
+        保存的文件路徑
+    """
+    # 生成文件名
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    filename = f"recording_{timestamp}.wav"
+    filepath = os.path.join(OUTPUT_DIR, filename)
+    
+    # 確保是單聲道
+    if len(audio_data.shape) > 1:
+        audio_data = audio_data.mean(axis=1)
+    
+    # 歸一化到 16-bit 範圍
+    audio_int16 = (audio_data * 32767).astype(np.int16)
+    
+    # 保存為 WAV
+    with wave.open(filepath, 'w') as wav_file:
+        wav_file.setnchannels(1)  # 單聲道
+        wav_file.setsampwidth(2)  # 2 bytes (16-bit)
+        wav_file.setframerate(sr)
+        wav_file.writeframes(audio_int16.tobytes())
+    
+    return filepath
+
+
+def process_recording(audio_tuple):
+    """
+    處理錄音並保存
+    
+    Args:
+        audio_tuple: (sampling_rate, audio_data) 元組
+        
+    Returns:
+        保存的文件路徑和狀態訊息
+    """
+    if audio_tuple is None:
+        return None, "❌ 沒有錄音數據"
+    
+    sr, audio_data = audio_tuple
+    
+    # 如果採樣率不是 16kHz，需要重採樣
+    if sr != SAMPLE_RATE:
+        # 使用 librosa 重採樣
+        try:
+            import librosa
+            audio_data = librosa.resample(audio_data, orig_sr=sr, target_sr=SAMPLE_RATE)
+            sr = SAMPLE_RATE
+        except ImportError:
+            # 如果沒有 librosa，使用簡單的降採樣
+            ratio = SAMPLE_RATE / sr
+            new_length = int(len(audio_data) * ratio)
+            audio_data = np.interp(
+                np.linspace(0, len(audio_data), new_length),
+                np.arange(len(audio_data)),
+                audio_data
+            )
+            sr = SAMPLE_RATE
+    
+    # 保存文件
+    filepath = save_audio(audio_data, sr)
+    
+    # 計算錄音長度
+    duration = len(audio_data) / sr
+    
+    return filepath, f"✅ 已保存：{filepath}\n📊 長度：{duration:.2f}秒 | 採樣率：{sr}Hz"
+
+
+def create_demo():
+    """創建 Gradio 介面"""
+    
+    with gr.Blocks(title="語音錄音器") as demo:
+        gr.Markdown("""
+        # 🎤 語音錄音器
+        
+        按下「開始錄音」按鈕開始錄音，再次按下「停止錄音」按鈕停止並保存。
+        錄音將保存為 16kHz 採樣率的 WAV 文件。
+        """)
+        
+        with gr.Row():
+            with gr.Column(scale=1):
+                gr.Markdown("### 📝 錄音說明")
+                gr.Markdown("""
+                1. 點擊 **🔴 開始錄音** 按鈕
+                2. 對著麥克風說話
+                3. 點擊 **⏹️ 停止錄音** 按鈕
+                4. 錄音將自動保存為 WAV 文件
+                """)
+                
+                gr.Markdown("### ⚙️ 設定")
+                gr.Markdown(f"""
+                - 採樣率：**{SAMPLE_RATE} Hz**
+                - 格式：**WAV**
+                - 聲道：**單聲道**
+                - 位元深度：**16-bit**
+                """)
+            
+            with gr.Column(scale=2):
+                # 錄音組件
+                audio_input = gr.Audio(
+                    label="🎤 錄音",
+                    sources=["microphone"],
+                    type="numpy",
+                    waveform_options=gr.WaveformOptions(
+                        sample_rate=SAMPLE_RATE,
+                    ),
+                )
+                
+                # 狀態顯示
+                status_text = gr.Textbox(
+                    label="📋 狀態",
+                    placeholder="等待錄音...",
+                    interactive=False,
+                )
+                
+                # 保存的文件顯示
+                audio_output = gr.Audio(
+                    label="📁 已保存的錄音",
+                    type="filepath",
+                    interactive=False,
+                )
+                
+                # 按鈕
+                with gr.Row():
+                    save_btn = gr.Button(
+                        "💾 保存錄音",
+                        variant="primary",
+                        size="lg",
+                    )
+                    clear_btn = gr.Button(
+                        "🗑️ 清除",
+                        variant="secondary",
+                        size="lg",
+                    )
+        
+        # 錄音說明
+        gr.Markdown("""
+        ---
+        ### 💡 使用提示
+        
+        - **錄音時**：請確保瀏覽器已授權麥克風權限
+        - **停止錄音**：錄音完成後點擊「保存錄音」按鈕
+        - **文件位置**：錄音保存在 `recordings/` 目錄下
+        - **下載**：點擊音頻播放器右側的下載按鈕可下載文件
+        """)
+        
+        # 事件處理
+        save_btn.click(
+            fn=process_recording,
+            inputs=[audio_input],
+            outputs=[audio_output, status_text],
+        )
+        
+        clear_btn.click(
+            fn=lambda: (None, "🗑️ 已清除"),
+            inputs=[],
+            outputs=[audio_input, status_text],
+        )
+    
+    return demo
+
+
+if __name__ == "__main__":
+    # 創建並啟動應用
+    demo = create_demo()
+    demo.launch(
+        server_name="0.0.0.0",
+        server_port=7860,
+        share=False,  # 設為 True 可創建公開分享連結
+    )

requirements.txt

@@ -0,0 +1,3 @@
+gradio>=4.0.0
+numpy>=1.24.0
+librosa>=0.10.0

run_local.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# =============================================================
+# 語音錄音器 - 本地測試腳本
+# =============================================================
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+echo "=========================================="
+echo "語音錄音器 - 本地測試"
+echo "=========================================="
+echo ""
+
+# 檢查虛擬環境
+PYTHON="/home/picard/venv/bin/python"
+
+if [ ! -f "$PYTHON" ]; then
+    echo "錯誤：虛擬環境未找到：$PYTHON"
+    exit 1
+fi
+
+# 安裝依賴
+echo "安裝依賴..."
+$PYTHON -m pip install -q -r requirements.txt
+
+echo ""
+echo "=========================================="
+echo "啟動應用..."
+echo "=========================================="
+echo ""
+echo "瀏覽器開啟：http://localhost:7860"
+echo ""
+echo "按 Ctrl+C 停止服務"
+echo ""
+
+# 啟動應用
+exec $PYTHON app.py