diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7d7efe6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+this is a personal project to create a voice directed digital assistant based on the max headroom character.
+
+written in python, using langchain, langgraph, etc.
+
+it currently will respond as an LLM like usual, but can also control spotify
+
+this is a fun work in progress. if you want to use it and or develop for it be my guest. would love to have more tools designed.
+
+Note: this will work with openai or ollama models. you will need to set up the .env for that as well as spotify