diff --git a/README.md b/README.md
new file mode 100644
index 0000000..40f64ce
--- /dev/null
+++ b/README.md
@@ -0,0 +1,54 @@
+# RustyLinks
+
+Create a LinkTree page for free from a yaml template.
+
+
+## Acknowledgements
+
+ - 100% inspired by [Ho0ber's Links](https://github.com/ho0ber/links) while helping him make it in Python.
+## Installation
+
+Install my-project with cargo
+
+```bash
+  cargo install
+```
+    
+## Run Locally
+
+Clone the project
+
+```bash
+  git clone https://gitea.tyrel.dev/tyrel/rustylinks
+```
+
+Go to the project directory
+
+```bash
+  cd rustylinks
+```
+
+Install dependencies
+
+```bash
+  cargo build
+```
+
+Run
+```
+  cargo run
+```
+
+Optionally install to get `rustylinks` on path.
+```
+   cargo install --path ./
+   rustylinks
+```
+
+
+## Roadmap
+
+- Add command line options for directories
+- Add tests
+- Add Github Action support
+- Add SSH copying support