diff --git a/README.md b/README.md
new file mode 100644
index 0000000..05b4f08
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# balls and bins
+
+## dependencies
+`pkg-config`, `font-config`, a [rust toolchain](https://www.rust-lang.org/tools/install)
+
+## running
+`cargo run` will draw all the graphs, this time it's multithreaded so I can't really tell you how fast it'll finish on your machine, but on mine (Ryzen 9 5980HX) it takes about 15 seconds
+
+`./graphs/1` has the graphs for B_n, U_n, C_n, D_n and C_n - D_n
+
+`./graphs/2` has graphs that check the growth of the functions above
+
+the odt and pdf contain a description and conclusions of the results in Polish