Metadata-Version: 2.4
Name: maracaai
Version: 0.1.1
Summary: AI voice chatbot using Hack Club AI
License: MIT
Project-URL: Repository, https://github.com/hippogriff101/MaracaAI
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openrouter
Requires-Dist: SpeechRecognition
Requires-Dist: pyttsx3
Requires-Dist: python-dotenv
Dynamic: license-file

# Maraca AI

A voice-based assistant powered by Hack Club's [AI](https://ai.hackclub.com), `SpeechRecognition`,`openrouter`and ```pyttsx3``` built in python.

_This project was originally called 'Tamborine AI' and was submitted to Hack Club's [Summer of Making](summer.hackclub.com)._

> [!NOTE]
> This is being sumbitted to Hack Club's [Flavortown](flavortown.hackclub.com) 


## Features

- Speech-to-text input using your microphone

- Openrouter AI conversation with session memory

- Continuous conversation loop

- Voice commands

---

## Requirements

- Microphone

- Windows 10 _or higher_

- Wi-Fi connection 

- Hack Club AI API Key

---

## Installation Instructions

### [PyPi](https://pypi.org/)

You can install using `pip install maracaai`

Then just run `maraca` in the terminal and it will start the program

### Source

**Clone the repository**
```
git clone https://github.com/hippogriff101/MaracaAI.git
cd MaracaAI
```

**Install dependencies**
```
pip install -r requirements.txt
```

**Run the script**
```
python maracaai/main.py
```

---

## 🛜 AI Transparency

This project obviously uses AI but I want to keep the use of AI in the development of projects transparent.

### Ai Usage

- Polishing and debuging code
- Testing code (API calls)

---
## ⚠️ Disclamer

All content is created using `qwen/qwen3-32b`

`MaracaAI/` folder is created in `C:\Users\{user}\AppData\Local`

---

## 💼 License

[_MIT License_](https://github.com/hippogriff101//blob/main/LICENSE)

_Copyright (c) 2026 Freddie_
