Initial commit: strata-docker Intel Arc runner for Strata

Thin wrapper over Strata's documented Docker route for the Intel Arc
(SYCL) engine: fetch a pinned upstream tag, build the strata-sycl-dev
image and the engine for bmg-g21, then run upstream setup for Gyro-M.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 54 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a86e491
--- /dev/null
+++ b/README.md
@@ -0,0 +1,54 @@
+# strata-docker
+
+Run [Strata](https://github.com/Niko1221/Strata) on an Intel Arc card under
+Slackware, without installing oneAPI on the host. It wraps upstream's
+documented Docker route: the SYCL engine is built and run inside the
+`strata-sycl-dev` image, the setup and server run on the host. Defaults to an
+Arc B580 and the Gyro-M model.
+
+Upstream's Intel engine is experimental. Expect rough edges.
+
+## Requirements
+
+- Intel Arc on the `xe` (or `i915`) kernel driver, `/dev/dri/renderD128`
+  usable by your user
+- Docker, your user in the `docker` group
+- Python 3.10+ with venv, git
+- Disk: about 13 GB for the image, about 92 GB for Gyro-M
+- Memory: Gyro-M needs about 35 GB of RAM and VRAM together
+
+## Usage
+
+```sh
+./strata-docker fetch     # clone Strata, check out the pinned tag (v0.2.2)
+./strata-docker image     # build the strata-sycl-dev image (~6 min, 13 GB)
+./strata-docker build     # build the engine for bmg-g21 (~3 min)
+./strata-docker setup     # download Gyro-M and start serving
+./strata-docker setup --check     # what fits, changes nothing
+```
+
+`setup` passes extra arguments to upstream's `setup.py` (e.g. `--port 8085`,
+`--no-start`, `--yes`). Later runs of `setup` start the model again without
+downloading.
+
+| Variable | Default | Meaning |
+|----------|---------|---------|
+| `STRATA_REF` | `v0.2.2` | upstream tag or commit to check out |
+| `STRATA_AOT` | `bmg-g21` | AOT target (`bmg-g31` for a Pro B70, empty for JIT on A-series) |
+
+The server listens on `http://127.0.0.1:8080` (OpenAI API at `/v1`).
+
+## License
+
+Copyright (C) 2026 Danilo M. <danix@danix.xyz>
+
+GPLv2 only. See [LICENSE](LICENSE) for the full text. Strata itself is MIT
+licensed, the models carry their own licenses.
+
+## Development Approach
+
+This project is developed using AI-assisted tools. Code is generated with the help of AI based on human-provided specifications, design decisions, and iterative feedback.
+
+All contributions are reviewed, tested, and curated by the maintainer before being included in the codebase. AI is used as a productivity and exploration tool, while human oversight remains central to all decisions.
+
+The goal is to combine the flexibility of AI-assisted development with standard open-source practices such as transparency, review, and accountability.