Skip to content

Latest commit

 

History

History
87 lines (62 loc) · 3.38 KB

README.md

File metadata and controls

87 lines (62 loc) · 3.38 KB

🌌 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, take an interpret screenshots, 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

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:

    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:

    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:

python src/main.py

Using Ava:

  1. Wake Command: Say “Ava” to initiate a command. (optional no wake command mode)
  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) (Voice features not demonstrated in the video)

📜 License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

Ava - Elevate your productivity with AI-driven automation and intuitive, hands-free control over your digital world.