Plain-language guide

Bring your own AI, explained

Waldo doesn't come with an AI built in — you connect the one you want, and that's a feature, not a hassle. If your experience with AI so far is a chat window in a browser, this page is for you.

Chat apps vs. API keys — the two doors to the same AI

When you use ChatGPT or Claude on the web, you're using a chat app: you log in, you type, the AI answers. Behind that app sits the actual AI model — and the companies that run those models also offer a second door to them, built for software: the API (don't worry about the acronym; think "direct line").

An API key is a long password-like code that opens that direct line. You create it once on the AI company's website, paste it into Waldo's settings, and from then on Waldo can talk to the same class of models your chat app uses — right from inside ArcGIS Pro, about your project.

An analogy: the chat app is a taxi — flat monthly fare, the company drives. An API key is your own set of car keys — you pay only for the miles you actually drive, and any software you trust can do the driving. Waldo is that software.

Why does Waldo work this way? Three reasons: you're never locked to one AI vendor (pick Claude, OpenAI, or others, and switch anytime); we never mark up or meter your usage (you pay the AI company directly, at their prices); and your data goes only where you decide — straight from your machine to your chosen provider, with no Waldo server in the middle.

Three ways to connect one

All three take under fifteen minutes. Waldo's settings has a field for each — paste, pick a model from the list, done.

Option 1

Claude (Anthropic) API key

A frontier model with strong reasoning — a great default for GIS work.

  1. Go to the Claude Console at platform.claude.com and create an account (separate from a claude.ai chat account, even if you have one).
  2. Add a small amount of prepaid credit — $5–10 is plenty to start.
  3. Open API Keys, create a key, and copy it. It's shown once, so copy it right away.
  4. In Waldo's settings, choose Anthropic, paste the key, and pick a model — the list fills in from your account automatically.

Set a monthly spending limit in the console if you want a hard ceiling. You can revoke the key there anytime.

Option 2

OpenAI API key

Same idea, different vendor — GPT-class models.

  1. Go to platform.openai.com and create an account (again, separate from a ChatGPT subscription).
  2. Add prepaid credit under Billing — $5–10 to start.
  3. Create a key under API keys and copy it.
  4. In Waldo's settings, choose OpenAI, paste the key, pick a model.

This same settings slot accepts any OpenAI-compatible service — aggregators like OpenRouter (one key, many vendors' models) work by pasting their web address as the endpoint.

Option 3

A local model — no account at all

The AI runs on your own computer. Nothing leaves your machine, ever.

  1. Install Ollama or LM Studio (free desktop apps) on your PC.
  2. Download a model through the app — it will suggest sizes that fit your hardware.
  3. In Waldo's settings, choose the OpenAI-compatible option and point it at the app's local address (both apps show it — for Ollama it's typically http://localhost:11434).

Honest caveat: local models trail the frontier models in capability, and bigger ones want a modern GPU. But for shops that can't send data to any cloud, this is the option that makes Waldo possible at all — and it costs nothing per use.

Prefer the official instructions?

Our steps above are the short version. These are the providers' own guides — authoritative and kept current by them.

What does it actually cost?

With an API key you pay the AI company per use — metered like a utility, not a subscription. Prices vary by model and session length, but for perspective: a typical Waldo working session costs cents to a few tens of cents with a mainstream model. A $10 credit lasts most analysts a long time.

  • No subscription required. Credit sits there until you use it.
  • You can cap it. Both major consoles let you set spending limits and alerts.
  • Waldo adds nothing. We never meter, mark up, or even see your AI usage. Waldo itself is a one-time purchase — pricing here.
  • Local models are $0 per use. Your electricity is the only bill.

For organizations & businesses

Bring-your-own-model is exactly the shape IT departments want AI adoption to take: the AI relationship, billing, and data-governance terms are yours, not a plugin vendor's.

Use your existing AI agreement

If your organization already has an Anthropic or OpenAI account — or an enterprise agreement with negotiated data-handling terms — IT can issue each analyst an API key under it. Waldo inherits whatever terms your organization already negotiated, because the connection is yours.

Point everyone at your gateway

Many orgs route AI traffic through an internal OpenAI-compatible gateway or proxy for logging, budgets, and model control. Waldo's endpoint field accepts any such address — analysts paste the internal URL and IT keeps central control of models and spend.

Regulated or air-gapped? Go local

Government, utility, and defense GIS shops that can't use cloud AI can run models on their own hardware — a workstation GPU or an internal inference server — and Waldo works the same way, with no data leaving the network.

Keys stay on the machine

Waldo stores keys locally, encrypted with Windows' built-in protection (DPAPI), on each analyst's machine. Keys are never transmitted to Waldo GIS — revoke or rotate them from your provider's console at any time.

Common questions

I already pay for ChatGPT Plus or Claude Pro/Max. Doesn't that cover it?

Claude subscriptions: no. As of early 2026, Anthropic's consumer terms restrict Pro/Max sign-in to Anthropic's own apps (claude.ai and Claude Code) — third-party software like Waldo is required to use API keys. That's Anthropic's policy, not ours, and it applies to every third-party tool equally. The consolation: an API key is pay-as-you-go and cheap for Waldo-sized sessions, with no second subscription to carry.

ChatGPT subscriptions: a qualified maybe. OpenAI has been notably friendlier to third-party tools working with ChatGPT plans, but hasn't put formal terms around it. Waldo includes a ChatGPT sign-in option that we plan to offer as a beta feature; where providers' policies settle, we'll follow them. If in doubt, an API key is the fully supported path for both vendors.

Which model should I pick?

Waldo ships with recommended defaults and shows your account's available models in a dropdown — you don't need to research model names. As a rule of thumb: pick a current mainstream model from your provider rather than the cheapest one; GIS work rewards the stronger reasoning.

Is pasting a key into Waldo safe?

The key is stored on your machine, encrypted with Windows' built-in data protection, and used only to talk to your provider. It never touches a Waldo server. If a key is ever exposed, you can revoke it in your provider's console in seconds — that's a real advantage keys have over passwords.

What if my organization blocks AI tools?

That's usually a data-governance concern, and it's exactly what the local-model option answers: the model runs inside your network and nothing leaves. Show IT this page and the privacy policy — the architecture (no vendor cloud, your keys, your endpoints) tends to be an easier conversation than a typical SaaS AI tool.

Still unsure? Just ask.

Tell us your situation — solo analyst, university lab, government shop — and we'll point you at the simplest setup.

Email hello@waldogis.com