diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2ed8443
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# IronGOLEM
+librairy for [Golem Programming Language](https://golem.re)
+
+## How to use in your projet
+You can simply add the [latest release](https://git.chauvet.pro/starnakin/IronGOLEM/releases) to your golem projet and merge IronGolem.asm with your own .asm
+
+## Requirements
+- [orga](https://kdx.re/cgit/orga/)
+- [golem](https://kdx.re/cgit/golem/)
+
+## Build
+``` bash
+./run.sh
+```
+
+## Fonctions list
+- [aton](https://git.chauvet.pro/starnakin/IronGOLEM/wiki/aton)
+- [aton_s](https://git.chauvet.pro/starnakin/IronGOLEM/wiki/aton_s)
+- [bzero](https://git.chauvet.pro/starnakin/IronGOLEM/wiki/bzero)
+- [aton_s](https://git.chauvet.pro/starnakin/IronGOLEM/wiki/aton_s)
+- [galloc](https://git.chauvet.pro/starnakin/IronGOLEM/wiki/galloc)
+- [free](https://git.chauvet.pro/starnakin/IronGOLEM/wiki/free)
+- [ntoa](https://git.chauvet.pro/starnakin/IronGOLEM/wiki/ntoa)
+- [ntoa_s](https://git.chauvet.pro/starnakin/IronGOLEM/wiki/ntoa_s)
\ No newline at end of file