Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jdonaldson/mutter
Speak to an AI
https://github.com/jdonaldson/mutter
Last synced: about 1 month ago
JSON representation
Speak to an AI
- Host: GitHub
- URL: https://github.com/jdonaldson/mutter
- Owner: jdonaldson
- Created: 2024-09-11T22:47:02.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-09-11T22:49:05.000Z (4 months ago)
- Last Synced: 2024-09-12T08:56:26.391Z (4 months ago)
- Language: Python
- Size: 2.93 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Mutter
Mutter is a macOS application that combines speech-to-text technology with AI-powered conversation. It lives in your menu bar, ready to listen and respond whenever you need it.
## Features
- Speech recognition using Whisper
- AI-powered responses using Llama 3.1 via Ollama
- macOS menu bar integration for easy access
- Conversation saving functionality
- Desktop notifications for new messages
## Requirements
- macOS (tested on 10.15+)
- Python 3.8 or higher
- Ollama installed and running with Llama 3.1 model
## Installation
1. Clone this repository:
```
git clone https://github.com/your-username/mutter.git
cd mutter
```
2. Install the required dependencies:
```
pip install -r requirements.txt
```
3. Ensure you have Ollama installed and the Llama 3.1 model pulled:
```
ollama pull llama3.1
```
## Usage
1. Run the Mutter application:
```
python mutter/main.py
```
2. The Mutter icon will appear in your macOS menu bar.
3. Click on the icon to access the following options:
- Start Listening: Begins the speech recognition process
- Stop Listening: Stops the speech recognition process
- Save Conversation: Saves the current conversation to a text file
4. When "Start Listening" is activated, speak clearly into your microphone. Mutter will transcribe your speech and send it to Llama 2 for a response.
5. You'll receive desktop notifications for new AI responses.
## Configuration
Currently, Mutter uses default settings for Whisper (base model) and Ollama (default URL). To change these, modify the initialization parameters in `mutter/main.py`.
## Contributing
Contributions to Mutter are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Acknowledgments
- OpenAI for the Whisper model
- Meta AI for the Llama 3.1 model
- Ollama for easy local AI model deployment
- The creators and maintainers of the Python libraries used in this project