Gemini 英語口語助手

這是一個基于 Google Gemini AI 的英語口語練習助手，它能實時識別你的英語發(fā)音，提供即時反饋和糾正建議。

Make by Box

功能特點

• ?? 實時語音識別
• ?? AI 驅(qū)動的發(fā)音評估
• ?? 語法糾正
• ?? 情景對話練習
• ?? 針對性發(fā)音指導
• ?? 智能場景切換

系統(tǒng)要求

• Python 3.11+ (必須)
• 麥克風設備
• 網(wǎng)絡連接

前置依賴

需要一個 Gemini的API Key，這個API Key每天免費四百萬次，足夠使用了。

到這個頁面 https://aistudio.google.com/app/apikey 生成即可。

安裝

1. 克隆倉庫：

git clone https://github.com/nishuzumi/gemini-teacher.git
cd gemini-teacher

2. 創(chuàng)建并激活虛擬環(huán)境（推薦）：

python -m venv .venv
source .venv/bin/activate  # Unix/macOS
# 或
.venv\Scripts\activate  # Windows

3. 安裝依賴：

在安裝 Python 依賴前，請先安裝以下系統(tǒng)依賴：

• Windows: 無需額外安裝
• macOS: brew install portaudio
• Ubuntu/Debian: sudo apt-get install portaudio19-dev python3-pyaudio

pip install -r requirements.txt

使用方法

1. 設定環(huán)境 新建一份 .env 文件，將.env.example 內(nèi)容復制過去，然后修改。

如果你需要設定代理，請?zhí)顚?HTTP_PROXY，例如 HTTP_PROXY=http://127.0.0.1:7890

GOOGLE_API_KEY 填寫谷歌Gemini的API Key

開啟語音功能

這個功能按需開啟，ELEVENLABS_API_KEY 是語音功能的API KEY。

獲取方式：

• 打開網(wǎng)站 https://elevenlabs.io/
• 點擊右上角的Try for free，進行注冊，有免費的1000個額度
• 到個人設置中，生成API Key填入即可

python starter.py

2. 按照提示說出英語句子
3. 等待 AI 助手的反饋
4. 根據(jù)反饋改進發(fā)音

交互說明

• ?? : 正在錄音
• ?? : 正在處理
• ?? : AI 反饋

許可證

MIT

貢獻

歡迎提交 Issue 和 Pull Request！