localpi 0.6.1 → 0.6.2

package/README.md

@@ -524,6 +524,7 @@ demowall record --session demowall-<timestamp> --out demo.mp4 --seconds 60
 - `--max-tokens <n>`: generated model max output tokens
 - `--continue-on-truncation <n>`: continue a reply cut off by the output limit, up to `n` times. Off by default, and `LOCALPI_CONTINUE_ON_TRUNCATION=<n>` sets the same limit
 - `--base-url <url>`: OpenAI-compatible endpoint for LM Studio or custom endpoints
+- `--api-key <value>`: Pi provider API key for this run. A literal value, an environment reference such as `${NAME}`, or a `!command`. Default: `local`. `LOCALPI_API_KEY` sets the same value
 - `--server-command <path>`: `llama-server` executable path
 - `--llama-server <path>`: alias for `--server-command`
 - `--host <host>`: managed `llama-server` host. Default: `127.0.0.1`
@@ -583,6 +584,7 @@ explicit `PI_OFFLINE=0` or `PI_OFFLINE=1` always wins.
 - `LOCALPI_MODEL`
 - `LOCALPI_PROVIDER`
 - `LOCALPI_BASE_URL`
+- `LOCALPI_API_KEY`
 - `LOCALPI_PROVIDERS_FILE`
 - `LOCALPI_MODEL_PROFILE`
 - `LOCALPI_MODEL_REASONING`

package/dist/src/localpi/options.js

@@ -19,6 +19,7 @@ export function defaultOptions() {
     return {
         runtime: parseRuntime(envString("LOCALPI_RUNTIME", "auto")),
         baseUrl: envOptionalBaseUrl("LOCALPI_BASE_URL"),
+        apiKey: envString("LOCALPI_API_KEY", "local"),
         model: process.env["LOCALPI_MODEL"],
         provider: process.env["LOCALPI_PROVIDER"],
         customProviderId: envString("LOCALPI_PROVIDER_ID", "local-openai"),
@@ -100,6 +101,8 @@ export function usage() {
         "  --provider <id>          catalog provider id to use",
         "  --model <alias|id|path>  model alias, backend id, or GGUF path",
         "  --base-url <url>         OpenAI-compatible endpoint",
+        "  --api-key <value>        Pi provider API key: a literal, ${NAME}, or !command",
+        "                          (LOCALPI_API_KEY=<value>, default: local)",
         "  --ctx <n>                model context window",
         "  --context-window <n>     alias for --ctx",
         "  --max-tokens <n>         generated model max output tokens",
@@ -189,6 +192,7 @@ const booleanFlagUpdaters = {
 const valueFlagUpdaters = {
     "--runtime": (options, value) => ({ ...options, runtime: parseRuntime(value) }),
     "--base-url": (options, value) => ({ ...options, baseUrl: normalizeBaseUrl(value) }),
+    "--api-key": (options, value) => ({ ...options, apiKey: value }),
     "--model": (options, value) => ({ ...options, model: value }),
     "--provider": (options, value) => ({ ...options, provider: value }),
     "--provider-id": (options, value) => ({ ...options, customProviderId: value }),

package/dist/src/pi/app.js

@@ -86,7 +86,7 @@ function providersForConnection(options, connection) {
         id: group.providerId,
         baseUrl: group.baseUrl,
         api: "openai-completions",
-        apiKey: "local",
+        apiKey: options.apiKey,
         compat: {
             supportsDeveloperRole: false,
             supportsReasoningEffort: false

package/docs/runtime-specification.md

@@ -110,6 +110,7 @@ Localpi:
 - can use `--provider <id>` to name the generated Pi provider
 - uses `/v1/models` for discovery
 - avoids assuming it can start, stop, or unload the backend
+- writes the `--api-key` value as the generated Pi provider key, exactly as given, so an environment reference such as `${HF_TOKEN}` or a `!command` keeps the secret out of the Pi config. The default is `local`, which local engines accept and ignore
 
 ### Configured Providers
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "localpi",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Swiss army knife for running Pi with local inference engines.",
   "type": "module",
   "license": "MIT",