https://github.com/corzed/ava
A.v.a. is a open source Advanced Virtual Assistant designed to use your computer to assist you with complex tasks.
https://github.com/corzed/ava
ai assistant ava claude desktop gpt gui openai stt tts voice
Last synced: 6 months ago
JSON representation
A.v.a. is a open source Advanced Virtual Assistant designed to use your computer to assist you with complex tasks.
- Host: GitHub
- URL: https://github.com/corzed/ava
- Owner: Corzed
- License: gpl-3.0
- Created: 2024-11-13T00:11:58.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2024-12-03T21:03:39.000Z (6 months ago)
- Last Synced: 2024-12-03T22:18:56.445Z (6 months ago)
- Topics: ai, assistant, ava, claude, desktop, gpt, gui, openai, stt, tts, voice
- Language: Python
- Homepage:
- Size: 84 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌌 A.v.a. - Advanced Virtual Assistant 🌌
> **An AI-powered digital assistant that doesn’t just respond – it takes action. From coding entire applications to creating data visualizations, Ava brings the power of automation directly to your desktop.**
Designed to handle complex computer operations, Ava can code, control your system, visualize data, and much more—all triggered by simple commands. Just **talk to Ava**, say what you need, and watch it take action.
---
## 🚀 Features
- **🎙️ Natural Voice Control**: Interact hands-free! Speak naturally to Ava using commands like, “Ava, generate a report” or “Ava, make a website for me.” You can simply say "Ava" to initiate a command.
- **💡 Real-Time Automation**: Ava can transform simple voice commands, such as "create me a website," into actionable code, generating an app or site instantly without human intervention.
- **📊 Data Visualization**: Need a quick chart or graph? Ava can instantly create and customize visualizations based on your data, turning insights into visuals with ease.
- **🖥️ System Control**: Automate your workflows with Ava’s ability to manage files, execute terminal commands, and perform other system-level tasks directly on your computer.
---
## 📁 Project Structure
```plaintext
Ava/
├── config/
│ ├── .env # Environment variables (API keys, Google credentials)
│ └── credentials.json # Google Cloud credentials (service account JSON)
├── src/
│ ├── modules/
│ │ ├── speech_recognizer.py # Speech recognition functions
│ │ └── text_to_speech.py # Text-to-speech functions
│ ├── ai.py # AI functionality and response generation
│ ├── gui.py # GUI setup and display
│ └── main.py # Main script to start Ava
├── requirements.txt # Python dependencies
└── README.md # Project documentation
```
---
## 🛠️ Installation
1. **Clone the Repository**:
```bash
git clone https://github.com/corzed/ava.git
cd ava
```
2. **Install Requirements**:
Ava’s dependencies are managed via `requirements.txt`. Install them by running:
```bash
pip install -r requirements.txt
```
3. **Set Up Configuration**:
- **Environment Variables**: Create a `.env` file in the `config/` folder to securely store API keys and other sensitive information.
- **Google Credentials**: Place `credentials.json` (Google Cloud credentials) in the `config/` folder.
---
## 🏃♂️ Usage
Start Ava by running the main script:
```bash
python src/main.py
```
### Using Ava:
1. **Wake Command**: Say “Ava” to initiate a command.
2. **Voice Commands**: Give commands like:
- **"Ava, generate a bar chart of my sales data"**
- **"Ava, code me a simple calculator app"**
- **"Ava, move all files from Downloads to Documents"**
---
### 🎥 Demo
([Link to Demo Video Here](https://youtu.be/LLYlXACX97A))
*(Voice features not demonstrated in the video)*
---
## 📜 License
This project is licensed under the **GNU General Public License v3.0**. See the [LICENSE](LICENSE) file for details.
---
**Ava** - Elevate your productivity with AI-driven automation and intuitive, hands-free control over your digital world.