diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1c324e3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,44 @@
+# AsterOS Core
+
+První a zároveň poslední veřejná verze (`v0.1`) kernelu pro můj vlastní operační systém **AsterOS**.
+
+Projekt vznikl jako pokus napsat vlastní operační systém od nuly. Podařilo se vytvořit základ kernelu a připravit strukturu projektu, ale vývoj jsem nakonec zastavil. Je dost nepravděpodobné, že se k němu ještě někdy vrátím.
+
+## Co obsahuje
+
+* 64bit x86_64 kernel
+* Základ bootování
+* VGA textový výstup
+* Připravenou strukturu projektu
+* Základy pro další vývoj
+
+## Struktura projektu
+
+```text
+apps/           Budoucí aplikace
+arch/x86_64/    Kód specifický pro architekturu
+boot/           Bootovací kód
+drivers/        Ovladače
+include/        Hlavičkové soubory
+kernel/         Zdrojový kód kernelu
+```
+
+## Sestavení
+
+Projekt se sestaví a spustí pomocí připraveného skriptu:
+
+```bash
+./setup.sh
+```
+
+Skript provede:
+
+* vyčištění předchozího buildu (`make clean`)
+* sestavení kernelu (`make`)
+* spuštění v QEMU (`make run`)
+
+Pokud používáš vlastní cross-compiler, můžeš nastavit proměnnou `CROSS`:
+
+```bash
+CROSS=x86_64-elf- ./setup.sh
+```