Skip to main content

Choosing a provider

AI runs on a provider you connect. Cobblr ships several, from hosted APIs to a model on your own machine. You add one on the AI settings page, or under your account as a personal connection you grant to chosen workspaces. This page is what the options are and how they differ.

The providers Cobblr ships​

  • Anthropic (Claude). Your Anthropic API key. Strong on the chat and vision assists.
  • OpenAI. Your OpenAI API key.
  • OpenRouter (one key, any model). One key that reaches many models behind a single gateway; you name the model. Requests transit OpenRouter's infrastructure, which is the trade for the convenience, and it is stated on the key field rather than hidden.
  • Ollama (local). A model you run yourself with Ollama, reached at its URL. An optional bearer token covers a remote or proxied endpoint. When the URL is on your own machine or LAN, a How Cobblr reaches it option can route the call through your edge bridge instead of directly.
  • OpenAI-compatible (LM Studio, vLLM, and similar). Any server that speaks the OpenAI v1 API. You give the base URL; the key and model are optional depending on the server. It carries the same How Cobblr reaches it option for a URL on your own network.
  • Local AI (via edge bridge). Reaches a model on your own device through a live edge channel, for when Cobblr cannot reach the URL directly (the model runs on your laptop or LAN, not on the server). It carries no credential and stays inert until an edge agent connects. Set it up under personal connections.

Hosted or local​

The choice comes down to a few tradeoffs:

  • Quality and effort. A hosted API is the least setup and generally the strongest models. A local model is free to run and keeps data on your hardware, but you provide the machine and pick a model good enough for the job.
  • Where the data goes. A hosted provider receives the content each call needs (a photo, a description). A local model, direct or over the edge bridge, keeps that on your own network.
  • One key or many. A single provider is simplest. OpenRouter is one key across many models if you want to switch models without managing several keys, at the cost of routing through their gateway.

Per-capability models and budgets​

A provider covers several jobs (chat, image classification, text extraction, and so on), and you can pick which model handles each, so a cheap model does the routine work and a stronger one handles the harder calls. A provider can also carry a monthly budget, a ceiling on what it is allowed to spend.

Pinning a job needs a provider the workspace owns. When its AI comes only from a shared connection, there is nothing to pin to, and the page says so inline rather than opening an edit that cannot save. A job whose pinned provider is later removed falls back to automatic, with a clear-pin action when you open it.

Which providers let Cobb act​

Reading your records and proposing changes needs a provider that supports tool calling. Anthropic, OpenAI, OpenRouter, and any tool-capable OpenAI-compatible or local server all do, and Cobb runs its full loop with them. A provider without tool calling still chats; Cobb drops to a simpler one-move-at-a-time mode.

Some local backends are agents that run tools themselves and only hand back text. The Ollama, OpenAI-compatible, and Local-AI connections carry a How this AI runs tools choice for that case. Leave it on the standard setting for an ordinary model; set it to "runs tools itself" to give that backend read-only access to the workspace, so Cobb can read your data through it. That path is read-only. To let Cobb make changes, connect a tool-calling provider.

Personal connections​

Instead of putting a key on the workspace, you can hold it on your own account and grant it to the workspaces you choose. The workspace gets the capability and never sees the credential, and the grant comes back whenever you take it back. This is how a shared workspace runs AI on one member's key without handing that key around. See Personal connections.

Turning it off​

Owners and admins can turn AI off for a single workspace with the Use AI in this workspace switch on Configuration → AI; a member's own personal connection still works there. On a self-hosted install, the operator can also disable all built-in AI with one switch regardless of what keys are set. That hard floor, and the privacy detail of what each call sends, are on the AI settings page.