diff --git a/README.md b/README.md
index e69de29bb2..88d6624d07 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,51 @@
+# OrcaSlicer-KX
+
+**OrcaSlicer builds with extra Anycubic Kobra X patches**
+
+Pre-built [OrcaSlicer](https://github.com/SoftFever/OrcaSlicer) binaries that bundle in-progress PRs improving Kobra X support — recommended for use with [KX-Bridge](https://gitea.it-drui.de/viewit/KX-Bridge-Release).
+
+[![Download](https://img.shields.io/badge/Download-Releases-2EA043?style=for-the-badge&logo=gitea&logoColor=white)](https://gitea.it-drui.de/viewit/OrcaSlicer-KX/releases)
+
+---
+
+## Custom Filament Presets & KX-Bridge
+
+📄 [How to create, verify and import custom filament presets](https://gitea.it-drui.de/viewit/KX-Bridge-Release/src/branch/master/docs/filament-preset-bridge-guide.md)
+
+---
+
+## Included patches
+
+- **[PR #13372](https://github.com/SoftFever/OrcaSlicer/pull/13372)** — Moonraker / Happy-Hare AMS sync fix
+- **[PR #13529](https://github.com/SoftFever/OrcaSlicer/pull/13529)** — Anycubic Kobra X printer profiles
+- **[PR #13677](https://github.com/SoftFever/OrcaSlicer/pull/13677)** — Kobra X G-code fix
+- **[PR #13719](https://github.com/SoftFever/OrcaSlicer/pull/13719)** — Vendor + name matching for Moonraker filament sync
+- KX-specific filament-hint patches (unique `filament_id` for user presets, 3-pass matching, sub-brands)
+
+---
+
+## Download
+
+Get the latest binaries from the [Releases page](https://gitea.it-drui.de/viewit/OrcaSlicer-KX/releases):
+
+- **Linux:** `OrcaSlicer_Linux_V*.AppImage` — `chmod +x` and run
+- **Windows:** `OrcaSlicer-Windows-x64.zip` — extract and run `orca-slicer.exe`
+
+Checksums in `SHA256SUMS.txt`. macOS is not provided here — build from upstream.
+
+> ⚠ This is an **alpha build** (OrcaSlicer 2.4.0-alpha). Use at your own risk.
+
+---
+
+## Why a separate repo?
+
+KX-Bridge itself is hosted at [viewit/KX-Bridge-Release](https://gitea.it-drui.de/viewit/KX-Bridge-Release).
+OrcaSlicer is a different project under a different license (AGPL-3.0) — kept separate so licenses, source provenance and update cycles do not get tangled.
+
+---
+
+## License & source
+
+These builds are derivatives of [OrcaSlicer](https://github.com/SoftFever/OrcaSlicer), licensed under **GNU AGPL-3.0**.
+The KX-specific patches live on branch [`build-alpha-pr-kx-filament-hint`](https://gitea.it-drui.de/viewit/OrcaSlicer-KX/src/branch/build-alpha-pr-kx-filament-hint) of this repository.
+