The inferwall CLI provides commands to run the HTTP API server, scan single inputs for testing, download and manage ML models, and generate API keys for authentication. Every command accepts --help for inline usage information.
inferwall serve
Starts the InferenceWall HTTP API server on port 8000 by default. The server exposes the /v1/scan/input, /v1/scan/output, and /v1/health endpoints.
Configure server behavior entirely through environment variables — see the Environment Variables reference for the full list.
Example
You can also start the server directly with uvicorn: uvicorn inferwall.api.app:app --host 0.0.0.0 --port 8000
inferwall test
Scans a single text input through the detection pipeline and prints the result to stdout. Use this to verify your installation, test specific payloads, or quickly validate signature behavior without standing up the full API server.
Flags
Examples
inferwall admin setup
Generates a scan API key (IW_API_KEY) and an admin API key (IW_ADMIN_KEY), then writes both to .env.local in the current directory. Run this once after installation before starting the server in production.
Example
Never commit .env.local or any file containing your API keys to source control.
inferwall models install
Installs the required Python dependencies and downloads the ML models for the specified profile in a single step. This is the recommended one-command setup for Standard and Full profiles.
Flags
Models are downloaded from HuggingFace and cached in ~/.cache/inferwall/models/.
Examples
inferwall models download
Downloads ML model weights only, without installing Python dependencies. Use this when you have already installed the package extras (inferwall[standard] or inferwall[full]) and only need to fetch the model files.
Flags
Examples
inferwall models list
Lists all ML model files that are currently downloaded and present in the local model cache (~/.cache/inferwall/models/).
Example
inferwall models status
Shows the download status of all models across every profile — indicating which models are present and which are missing. Use this to confirm your installation is complete before starting the server.
Example
Run inferwall models status after inferwall models install to confirm all expected models downloaded successfully.
