Skip to content

A voice-based assistant powered by OpenAI's GPT-4 (openai) and SpeechRecognition built in python.

License

Notifications You must be signed in to change notification settings

hippogriff101/Tambarine-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

a72419cΒ Β·Β Β· Sep 20, 2025

History

17 Commits
Sep 17, 2025
Sep 20, 2025
Sep 17, 2025
Jul 7, 2025
Sep 20, 2025
Sep 20, 2025
Sep 20, 2025

Repository files navigation

Tambarine AI

A voice-based assistant powered by OpenAI's GPT-4o-mini (openai), SpeechRecognition,playsoundand GTTS built in python.

the 'quirky' spelling of 'Tamborine' was intensional


⭐ Features

  • Speech-to-text input using your microphone

  • GPT-4 conversation with memory

  • Continuous conversation loop

  • Voice commands

  • Handles errors gracfully


Examples

πŸ”¨ Requirements

  • Microphone

  • Python dependencys in requirements.txt:

openai
speech_recognition
gtts
dotenv
playsoundound
  • Windows 10 or higher

  • Wi-Fi connection


πŸ“ƒ Installation Instructions

❌ Exacutable

  • Open versions tab
  • Locate v2.0.0
  • Download and run tambarine.exe

πŸ‘¨β€πŸ’» Source

Clone the repository

git clone https://github.com/hippogriff101/Tambarine-AI.git
cd Tambarine-AI

Install dependencies

pip install -r requirements.txt


⛑️ Open AI Key Setup

When running the python script locally you will need to provide your own open ai key via a .env!

You can get your key from https://platform.openai.com/account/api-keys If you need a free key head to this repo by @dan1471


πŸ› οΈ How to use

Run:

python main.py

or

tambarine.exe

What you need to do:

  • Speak clearly into your microphone
  • The assistant will transcribe what you say and reply using GPT-4o-mini
  • Say "stop" to end the session

πŸ›œ AI Transparency

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

Ai Usage

  • Cleaning up mistakes in this README.md
  • Polishing and debuging code
  • Creating logo and bannar image
  • Testing code (APi calls)

πŸ“ƒ To Do

  • Make a GUI version
  • Option to use different ai models

⚠️ Disclamer

All content is created using GPT-4o-mini Program exacutable has only been tested on windows Tambarine folder is created inin


πŸ’Ό License

MIT License

Copyright (c) 2025 Freddie

About

A voice-based assistant powered by OpenAI's GPT-4 (openai) and SpeechRecognition built in python.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages