diff --git a/package.json b/package.json
new file mode 100644
index 0000000..e69de29
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..36758f6
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,12 @@
+# Python raycaster
+
+###### by Sem van der Hoeven
+
+This is a raycaster I made in python. it uses the `pygame` library for the graphics.
+
+## Installation
+Clone the repository by entering `git clone https://github.com/SemvdH/python-raycaster.git` into your command prompt. Then navigate to the folder using `cd python-raycaster`.
+
+If you don't have pygame installed yet, you can install it using `pip install pygame`.
+
+Now you can run the raycaster by entering `python raycaster.py`