Skip to content

AbyssSkb/Athena

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎤 Athena

A Chinese voice assistant powered by OpenAI's GPT, featuring wake word detection and web search capabilities.

✨ Features

  • 🔊 Wake word detection ("Hey Siri")
  • 🗣️ Chinese voice command recognition (Google/Azure)
  • 🔍 DuckDuckGo web search integration
  • 🔊 Multiple TTS engines (pyttsx3, GPT-SoVITS)
  • ⏲️ Auto-standby mode

🛠️ Prerequisites

📦 Setup

  1. Clone and install:

    git clone https://github.com/AbyssSkb/Athena
    cd Athena
    uv sync
  2. Configure environment:

    cp .env.example .env

    Update .env with your credentials:

    OPENAI_API_KEY="YOUR_OPENAI_API_KEY"
    PICOVOICE_ACCESS_KEY="YOUR_PICOVOICE_ACCESS_KEY"
  3. Configure pyttsx3 for Linux users:

    sudo apt update && sudo apt install espeak-ng libespeak1

🚀 Usage

  1. Start: uv run main.py
  2. Say "Hey Siri" to activate the assistant
  3. Speak your command or question in Chinese
  4. Say "再见", "退出" or "结束" to end the conversation

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

Releases

No releases published

Packages

 
 
 

Contributors

Languages