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.
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.mdand 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
Copyright (c) 2026 Freddie
Metadata
Release files for maracaai 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| maracaai-0.1.2.tar.gz | 4.4 kB | Without provenance | Details for maracaai-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| maracaai-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for maracaai-0.1.2-py3-none-any.whl |
Total release size: 9.3 kB
Release files / maracaai-0.1.2.tar.gz
| Download URL | maracaai-0.1.2.tar.gz |
|---|---|
| Size | 4.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ab9a4b4bd05245134f05917aa3b8236ca413fa488d266171a7baa792ae9bb2dc
|
|
BLAKE2b-256 checksum How to use checksums |
6a4bc2d5fb596568a4e7fdcb39908dab5f9a6aff4c2931ff0e748614b0bb0dfa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.1
|
Release files / maracaai-0.1.2-py3-none-any.whl
| Download URL | maracaai-0.1.2-py3-none-any.whl |
|---|---|
| Size | 4.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ee6fa9c5300fe9dbf3987fa18de4a72fe3735990e6be4f41477e9a6014f58b1e
|
|
BLAKE2b-256 checksum How to use checksums |
9a858ffb875204cbe1c34a1c0993ac06192f914a089260314b0aada2db97e23f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.1
|
Security for maracaai 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.