diff --git a/README.md b/README.md index ebfce25..ebb0fff 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,7 @@ this is a fun work in progress. if you want to use it and or develop for it be m > > 1. this will work with openai or ollama models. you will need to set up the .env for that as well as spotify > 2. this is designed to pull a custom voice from the [alltalk project](https://github.com/erew123/alltalk_tts), that is how I am cloning max headroom's voice. You can alter or simply not use this, it will currently fallback to pyttsx3 aka a robot voice -> 3. speech-to-text can use google, or faster-whisper. faster-whisper is currently the default and optimal method. +> 3. speech-to-text can use google, or faster-whisper. google is currently the default because it requires less set up, but faster-whisper is the better solution. # INSTALLATION @@ -43,7 +43,12 @@ so basically the steps are pretty simple > > Instructions are [Here](docs/cuda.md) > -> If this seems too complicated you can change Max to use google for speech-to-text instead in the .env +> If this seems too complicated you can just leave it at its default, which will use google for speech-to-text + +# Configuration + +All of the easy configuration is done in the .env file. This section will explain what the values do, although you will also find it in the [example_env.txt](example_env.txt) + # TOOLS @@ -89,6 +94,10 @@ the default timer will have a "clippy" popup, with potentially custom text Max Headroom is the default prompt. If you want to make a custom prompt look in modules/prompts.py and add it there. then set the name in .env +When you create a prompt in the prompts.py file the name of the prompt (the variable name) is what you put in the .env file, and it will be the wake word that its listening for. + +> Example: you create a new prompt and name it Ted, the new wake phrase is "Hey Ted" + ## Alert Phrase/Wake Word Max is set up for "Hey Max" as the wake word. I didnt love "hey max" as opposed to just "max" but the number of times he got invoked randomly became rediculous. diff --git a/example_env.txt b/example_env.txt index 5911788..4d92f55 100644 --- a/example_env.txt +++ b/example_env.txt @@ -1,16 +1,26 @@ #LLM_TYPE will take openai, local. Local will use Ollama LLM_TYPE = 'openai' + +#-----OpenAI variables OPENAI_API_KEY = '' OPENAI_MODEL = 'gpt-4o-mini' + +#-----Ollama variables #OLLAMA_MODEL will take any model you can load in ollama OLLAMA_MODEL = 'gemma2' OLLAMA_URL = 'http://localhost:11434' + +#-----Customization Variables #CHARACTER will take any character prompt you have in the modules/prompts.py file. 'max' or 'none' are the default options CHARACTER = 'max' -#LISTEN_MODEL will take whisper or google, whisper is the default option and best for most cases -LISTEN_MODEL='whisper' + +#LISTEN_MODEL will take whisper or google, whisper is the best option but requires additional setup with Nvidia drivers +LISTEN_MODEL='google' + #STREAM SPEAK URL is using the default url for Alltalk. If you dont have all talk you can ignore this, if you want to use a different service, simply replace the url STREAM_SPEAK_URL = 'http://127.0.0.1:7851/api/tts-generate' + +#-----Spotify, if you want Max to be able to control spotify this is where you will put your credentials SPOTIFY_CLIENT_ID = '' SPOTIFY_CLIENT_SECRET = '' SPOTIFY_REDIRECT_URI = 'http://localhost:8888/callback'