Deploy word complexity API

Dockerfile

@@ -0,0 +1,33 @@
+# Hugging Face Space — clones GitHub repo at build time.
+# Push this file + README.md to: uzzam24/complexity-levels-api
+FROM python:3.11-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential git \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN useradd -m -u 1000 user
+
+WORKDIR /app
+
+RUN git clone --depth 1 https://github.com/muhammad245/complexityLevels.git /app/repo
+
+RUN pip install --no-cache-dir -r /app/repo/deploy/backend/requirements.txt huggingface_hub \
+    && python -m spacy download en_core_web_sm
+
+RUN chmod +x /app/repo/deploy/huggingface/entrypoint.sh \
+    && chown -R user:user /app
+
+ENV MODEL_PATH=/app/model
+ENV HF_MODEL_REPO=uzzam24/deberta-complexity-lcp
+ENV APP_ROOT=/app/repo
+ENV PYTHONPATH=/app/repo:/app/repo/deploy/backend
+ENV PORT=7860
+ENV CORS_ALLOW_ALL=1
+ENV EAGER_LOAD_MODEL=1
+ENV HF_HOME=/home/user/.cache/huggingface
+
+USER user
+EXPOSE 7860
+
+CMD ["/app/repo/deploy/huggingface/entrypoint.sh"]

README.md

@@ -1,10 +1,27 @@
 ---
-title: Complexity Levels Api
-emoji: 🌖
-colorFrom: yellow
-colorTo: blue
+title: Word Complexity API
+emoji: 📖
+colorFrom: blue
+colorTo: green
 sdk: docker
+app_port: 7860
 pinned: false
+license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Word Complexity API
+
+FastAPI backend for word complexity prediction (DeBERTa).
+
+- Model: `uzzam24/deberta-complexity-lcp`
+- GitHub: [muhammad245/complexityLevels](https://github.com/muhammad245/complexityLevels)
+
+## Endpoints
+
+- `GET /health`
+- `POST /api/predict`
+- `POST /api/intervene`
+- `POST /api/intervene/all`
+- `POST /api/efficiency`
+
+Docs: `/docs`