Machine Learning/LiftWing/OpenAPI-specs

Lift Wing OpenAPI Server is a lightweight Apache httpd service that serves the Lift Wing OpenAPI specification files as static content. Unlike the other model servers in the inference-services repository, this is not a KServe model server — it does not use PyTorch, model volumes, or the KServe framework.

• Serves the aggregated docs/openapi.yaml and all per-model OpenAPI spec files
• Adds CORS headers so browser-based tools (Swagger UI, MediaWiki RestSandbox) can fetch the specs cross-origin
• The openapi.yaml file uses $ref references to sibling files (e.g. ./langid.yaml), so the entire docs/ directory is served

Based on the statictendril/miscweb pattern. No custom Python code — just Apache httpd with config files.

/srv/app/
├── apache2.conf ← copied from httpd.conf
│ ├── Loads mod_headers, mod_mime, mod_rewrite, ...
│ └── IncludeOptional liftwingspec.conf
├── liftwingspec.conf ← VirtualHost with DocumentRoot, CORS, ServerAlias
├── docs/ ← the OpenAPI YAML files (openapi.yaml + per-model specs)
│ ├── openapi.yaml
│ ├── langid.yaml
│ ├── edit-check.yaml
│ └── ...
├── entrypoint.sh

• src/models/liftwing_openapi_server/
• Blubber pipeline config
• Aggregated OpenAPI spec

Build and start the server:

docker compose build liftwing-openapi-server
docker compose up -d liftwing-openapi-server

Test it:

# Main aggregated spec
curl http://localhost:8081/openapi.yaml

With MediaWiki running at http://127.0.0.1:8080, add this to LocalSettings.php:

$wgRestSandboxSpecs['lw-openapi'] = [
 'url' => 'http://localhost:8081/openapi.yaml',
 'name' => 'Lift Wing',
 'group' => 'Lift Wing',
];

Then visit http://127.0.0.1:8080/w/index.php/Special:RestSandbox.

The image is built via Jenkins and published as inference-services-liftwing-openapi-server:stable. Since this is not a KServe InferenceService, it is deployed as a plain Kubernetes Deployment using the liftwing-openapi-server chart and follows the standard deployment procedure documented at Machine Learning/LiftWing/Deploy.

The public URL is https://api.wikimedia.org/service/lw/specs/openapi.yaml, configured in the wgRestSandboxSpecs setting in mediawiki-config.

• Machine Learning/LiftWing/Inference Services
• Machine Learning/LiftWing/API
• Machine Learning/LiftWing/Deploy
• task T427902