chore: add project scaffolding

.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+.DS_Store
+.pytest_cache/
+.venv/
+build/
+dist/
+outputs/
+*.egg-info/
+*.pyc
+

README.md

@@ -0,0 +1,27 @@
+# 0x960
+
+0x960 is an OpenEnv-oriented environment where a model improves a minimal Chess960 engine by editing a bounded evaluation file and getting rewarded by match outcomes.
+
+## repo layout
+
+- `docs/`: concept, architecture, and scope docs
+- `src/zero960/`: shared engine and episode runtime logic
+- `src/zero960_env/`: OpenEnv-facing models, server, and client
+- `train/`: minimal TRL/Colab-oriented training entrypoints
+
+## current status
+
+This repo currently contains a thin but functional skeleton:
+
+- minimal Chess960 engine core
+- workspace-based bounded file editing runtime
+- OpenEnv wrapper scaffold
+- minimal TRL rollout stub
+
+## next steps
+
+1. tighten the engine and reward harness
+2. validate the OpenEnv app structure against `0.2.1`
+3. add a small Colab notebook around the training stub
+4. deploy the server to HF Spaces
+

pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling>=1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "zero960"
+version = "0.1.0"
+description = "OpenEnv-oriented Chess960 self-improvement environment"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+  "chess>=1.11.2",
+  "fastapi>=0.115.0",
+  "httpx>=0.28.0",
+  "pydantic>=2.11.0",
+  "uvicorn>=0.34.0",
+]
+
+[project.optional-dependencies]
+train = [
+  "torch>=2.6.0",
+  "transformers>=4.52.0",
+  "trl>=0.19.0",
+]
+openenv = [
+  "openenv>=0.2.1",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/zero960", "src/zero960_env"]
+

src/zero960/__init__.py

@@ -0,0 +1,2 @@
+"""Core runtime and engine logic for 0x960."""
+

src/zero960/engine/__init__.py

@@ -0,0 +1,2 @@
+"""Chess960 engine primitives."""
+

src/zero960/runtime/__init__.py

@@ -0,0 +1,2 @@
+"""Episode runtime helpers."""
+

src/zero960/workspace_template/__init__.py

@@ -0,0 +1,2 @@
+"""Template workspace files copied into each episode."""
+

src/zero960_env/__init__.py

@@ -0,0 +1,2 @@
+"""OpenEnv-facing package for 0x960."""
+

src/zero960_env/server/__init__.py

@@ -0,0 +1,2 @@
+"""Server entrypoints for the OpenEnv deployment."""
+

train/__init__.py

@@ -0,0 +1 @@
+"""Training entrypoints for local and Colab demos."""