maracaai 0.1.2

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

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)#
• AI was used in the orignial Tamberine AI README.md and i forgot to change title formatting (content is new) - sorry for confussion shipwrights!

---

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