diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b731c3a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# neko//system
+neko//system is a Fedora Atomic image that I use to make my main OS setup universally updated and functional across all my devices.
+
+## installation
+there is certainly no reason you should install and use this yourself over any other option, but in case you want to:
+- Install Fedora Silverblue from official installer
+- ```rpm-ostree rebase ostree-unverified-registry:gitea.nekonetwork.io/cybrneko/neko-system:latest``` or use `neko-system:testing` for the testing branch
+- reboot
+
+## features
+- GNOME desktop
+- wireplumber, qpwgraph installed out of the box for audio work
+- Steam also installed out of the box