diff --git a/README.md b/README.md
index e69de29..a97d99d 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,10 @@
+# Python based Advent of Code 
+
+This project is for me to mess around with Python packaging concepts/repo format as well as try to store my Advent of Code solutions somewhat efficiently. 
+
+[This](https://github.com/wilhelmagren/advent-of-code) is the more elegant inspiration for this project.
+
+# Directory Structure
+  * adventofcode/ contains the supporting libraries to make my solutions go 
+  * solutions/ contains the solutions to problems, sorted by year/day 
+  * data/ contains the personalized input data I was given from the website to solve