maracaai 0.1.0

AI voice chatbot using Hack Club AI

Maraca AI

A voice-based assistant powered by Hack Club's AI, SpeechRecognition,openrouterand pyttsx3 built in python.

This project was originally called 'Tamborine AI' and was submitted to Hack Club's Summer of Making.

[!NOTE] This is being sumbitted to Hack Club's Flavortown

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

You can install using pip install maracaai

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

Copyright (c) 2026 Freddie