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