serving-openmed-rest-api

npx skills add maziyarpanahi/openmed --skill serving-openmed-rest-api --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Serving OpenMed over REST `openmed.service` is a hardened **FastAPI** app exposing OpenMed's NER, PII extraction, and de-identification over HTTP. It is built to be **self-hosted**: models run on-device, there's no telemetry, and the request schemas reject raw PHI from spilling into errors. Use it when callers need request/response inference; use `batch-processing-clinical-text` for corpora. ## When to use this skill To put OpenMed behind an HTTP endpoint your own apps call — an internal de-id microservice, an NER backend, a containerized inference tier. For agent/tool integration prefer the MCP server (`deploying-openmed-mcp`); for offline bulk work use batch processing. ## Quick start ```bash pip install "openmed[service]" # FastAPI + uvicorn + pydantic # Launch the ASGI app (factory create_app, or the module-level `app`) uvicorn openmed.service.app:app --host 127.0.0.1 --port 8000 ``` ```python # Or build it in-process (e.g. to mount under a parent app / add middleware): from openmed.service import create_app app = create_app() ``` ```bash curl -s localhost:8000/health # {"status":"ok","service":"openmed-rest","version":"...","profile":"prod"} curl -s localhost:8000/analyze -H

pip install "openmed[service]"          # FastAPI + uvicorn + pydantic
Launch the ASGI app (factory create_app, or the module-level `app`)
uvicorn openmed.service.app:app --host 127.0.0.1 --port 8000
curl -s localhost:8000/health
curl -s localhost:8000/analyze -H 'content-type: application/json' -d '{
curl -s localhost:8000/pii/deidentify -H 'content-type: application/json' -d '{
uvicorn openmed.service.app:app --host 0.0.0.0 --port 8000