Use OpenProvider models from the Copilot Chat model picker.
Route openprovider/auto-free through direct free-route catalogs and select exact working models from OpenProvider.
Track token usage and estimate costs in real-time.
Supports streaming, tool calls, image-capable models, and reasoning output when the selected model exposes those capabilities.
Requirements
VS Code 1.120.0 or newer.
GitHub Copilot Chat enabled, because VS Code language model providers surface through the Copilot Chat model picker.
Development
npm install
npm run compile
npm run esbuild
Request settings
openprovider.outputTokenBudget controls the normal max_tokens request budget. The extension clamps it to the selected model limit.
openprovider.retryOutputTokenBudget controls compact retry requests after upstream rejections or empty streams.
openprovider.forwardSamplingParameters is disabled by default so routed providers that reject temperature or top_p keep working. Enable it only when the selected provider supports those parameters.
openprovider.freeRouteCatalogUrls is optional; when empty, openprovider/auto-free uses the bundled anonymous LLM7 and Pollinations catalogs. OPENPROVIDER_FREE_ROUTE_CATALOG_URLS from .env, global user env files, or process env overrides that list.
openprovider.freeRouteBaseUrls is optional; when empty, openprovider/auto-free uses the bundled anonymous LLM7 and Pollinations route URLs. OPENPROVIDER_FREE_ROUTE_BASE_URLS from .env, global user env files, or process env overrides that list.
openprovider.freeRouteGatewayUrl is optional; when empty, openprovider/auto-free reads OPENPROVIDERGATEWAY_URL from .env, global user env files, or process env.
Global user env files are checked at ~/.openprovider.env, ~/.openprovider/.env, and ~/.config/openprovider-vscode/.env, so Auto Free can work in every VS Code workspace without copying .env into each project.
openprovider/auto-free does not send stored OpenProvider credentials to direct free-route URLs. Catalog providers that declare required API-key environment variables are skipped, and auth-required route responses are retried against the next anonymous candidate.
openprovider/auto-free advertises VS Code chat, streaming, tools, thinking, and image input. The direct router selects only anonymous candidates that match required tool or vision requests.
