SEAMLESS.INTELLIGENT.SECURE - Your Virtual Assistant

Secured All India Top 10 in SmashHack '24
Secured All India Top 10 in Code Sangram '25

This repository is dedicated to the software development of Luna, a virtual assistant. The project aims to deliver a seamless and responsive user experience.

• Python 3.x (Tested with Python 3.11 using pyenv)
• Required Python libraries (listed in requirements.txt)

Crank uses a .env file to load sensitive keys and config values. Make sure to create a .env file in the root directory containing your API keys, for example:

GEMINI_API_KEY=your_api_key_here

Crank uses Vosk for offline speech recognition. To set it up:

1. Download an English model from the official Vosk models page.
2. Recommended model: vosk-model-small-en-us-0.15 (~50MB)
3. Extract the model:

unzip vosk-model-small-en-us-0.15.zip

4. Rename the extracted folder to vosk-model:

mv vosk-model-small-en-us-0.15 vosk-model

5. Move it to the project root so your directory structure looks like:

crank/
├── main.py
├── requirements.txt
├── .env
├── vosk-model/
│   ├── conf
│   ├── ... etc
├── other_files_or_dirs/

1. Clone the repository

git clone https://github.com/ecnivs/Luna.git
cd Blossom

2. Set up Python with pyenv

pyenv install 3.11
pyenv local 3.11

4. Install dependencies

pip install -r requirements.txt

5. Run the Software

python main.py