Docs

Operator and integrator documentation for humaniser.eu. The site is open-source for transparency; everything here is reproducible on your own machine.

Run it locally

• RUNBOOK-LOCAL.md — single-command setup (./run-local.sh). See the source on GitHub.
• ./run-local.sh --check tests prerequisites without installing anything.
• Logs live in /tmp/humaniser-api.log and /tmp/humaniser-web.log.

API reference

The FastAPI backend self-documents at /docs on the API port (default 8000).

• http://127.0.0.1:8000/docs — Swagger UI (local)
• http://127.0.0.1:8000/redoc — ReDoc (local)
• openapi.json — machine-readable spec

Endpoints: POST /v1/detect, POST /v1/paraphrase, POST /v1/postprocess, POST /v1/humanise, POST /v1/benchmark, GET /v1/healthz.

Research

• /research/methods — humanizer method ratings and benchmark matrix
• /research/calibration — detector calibration cards (AUROC@FPR5)
• /technology — engine overview, the nine features, three artefacts

Legal & compliance

• /legal/dpa — Data Processing Agreement
• /legal/eu-ai-act — EU AI Act conformity statement
• /legal/explainability — explainability disclosure

Tests

Playwright suite under apps/web/tests/. Run with:

cd apps/web
pnpm test                       # all suites
pnpm test tests/user-stories.spec.ts  # the full user-story matrix
pnpm test:ui                    # interactive UI mode

The Playwright config auto-starts the Astro dev server but assumes the FastAPI backend is already up on :8000. Run ./run-local.sh api in another shell first.