# Atlas error: Model not found: / > Run `atlas models`, copy the exact provider/model id from the list, and fix the `model` value in atlas.json to use the provider/model format. Atlas exits with "Model not found: /" because Provider.getModel raises ProviderModelNotFoundError when the providerID/modelID pair is not in the resolved catalog, and both the CLI and the TUI format that tagged error into a multi-line hint. Fix it by running `atlas models` to list available models, copying the exact provider/model id from that list, and correcting the `model` value in atlas.json or through the /models picker. ## Symptom Atlas exits with: Model not found: /, optionally followed by Did you mean: ..., then Try: `atlas models` to list available models and Or check your config (atlas.json) provider/model names. ## Cause Provider.getModel raises ProviderModelNotFoundError when the providerID/modelID pair is not in the resolved catalog. The CLI and TUI both format that tagged error into the multi-line hint above, including fuzzy suggestions when present. ## Fix 1. Run `atlas models` and copy the exact provider/model id from the list. 2. Fix the `model` value in atlas.json (or the /models picker) to use the provider/model format. 3. If the provider is right but the model is missing, confirm your account actually has access to that model id. 4. Re-run; ProviderModelNotFoundError carries `suggestions`, so read the Did you mean line before guessing. ## Why does Atlas say Model not found Atlas says "Model not found: /" because Provider.getModel raises ProviderModelNotFoundError when the pair you asked for is absent from the resolved catalog, and both of its 2 halves, providerID and modelID, must match. The Atlas CLI and the TUI format that tagged error into the multi-line hint you see on exit. Two halves of the identifier can be wrong, and Atlas names both in the error. A wrong providerID means Atlas has no such provider in its resolved catalog at all. A wrong modelID means the provider exists but does not carry that model id. The multi-line hint points at the same two places every time: Try: `atlas models` to list available models, and Or check your config (atlas.json) provider/model names. Atlas lets you switch the active model and provider on the fly with favorites and recents, so a stale favorite pointing at a retired model id is a common way to arrive here. ## How to fix Model not found in Atlas Fix the Atlas "Model not found" error in 4 steps: run `atlas models` and copy the exact provider/model id from the list, fix the `model` value in atlas.json or through the /models picker, confirm your account has access to the model id, then re-run and read the Did you mean line before guessing. `atlas models` is the authoritative list, because it prints the resolved catalog that Provider.getModel checks against. Copy the id from there rather than from documentation, a blog post, or memory. The `model` value must use the provider/model format, both halves present and separated by a slash. If you prefer not to hand-edit atlas.json, the /models picker in the Atlas TUI writes the same value for you and cannot produce an id that is not in the catalog, which removes the typo failure mode entirely. ## What the Did you mean suggestions in Atlas tell you ProviderModelNotFoundError in Atlas carries a `suggestions` field, which is why the error sometimes prints a Did you mean line. Step 4 of the documented fix is to read that line before guessing, because the suggestions are fuzzy matches drawn from the resolved catalog and the correct id is usually very close to what you typed. Read the Did you mean line before guessing at another id, because it usually contains the exact answer. A suggestion appearing at all means the catalog holds something close to your input, which almost always indicates a typo, an outdated model id, or a version suffix that has moved. When no Did you mean line prints, the opposite is true: Atlas found nothing resembling your input, which points at a wrong providerID rather than a mistyped model. Run `atlas models` in that case and read the provider names first. ## Fixing the model value in atlas.json Fixing the `model` value in atlas.json is step 2 of the documented fix for Model not found in Atlas. The value must use the provider/model format, and both halves have to match ids in the resolved catalog, which is what the "Or check your config (atlas.json) provider/model names" hint is pointing at. Edit atlas.json with the id copied verbatim from `atlas models`. Slashes, hyphens, and version suffixes are all load bearing and none of them are forgiving. A config that was correct months ago can break when a provider retires a model id, and the error will point at atlas.json even though nothing in your file changed. Atlas snapshots file changes as git patches, so if Atlas edits config on your behalf you can diff and roll back the change. The /models picker is the alternative to hand-editing, and it cannot write an id outside the catalog. ## When the provider is right but the model is missing in Atlas Step 3 of the documented fix applies when `atlas models` lists the provider but not your model id: confirm your account actually has access to that model. Provider.getModel raises ProviderModelNotFoundError for any providerID/modelID pair missing from the resolved catalog, and access-gated models do not appear there for accounts without entitlement. This is the case where the Atlas config is not the problem. The provider resolved, the id is plausible, and the model is simply not available to you. No edit to atlas.json can add a model to the resolved catalog, and re-running Atlas will keep raising ProviderModelNotFoundError. The honest fix lives with the provider: gain access to the model id, or pick a different one from `atlas models` and set that in atlas.json instead. Atlas lets you switch the active model and provider on the fly with favorites and recents, so trying an available model costs very little. ## FAQ ### How do I fix "Model not found" in Atlas? Run `atlas models` and copy the exact provider/model id from the list, then fix the `model` value in atlas.json or through the /models picker. Provider.getModel raises ProviderModelNotFoundError for any pair not in the resolved catalog. ### How do I list available models in Atlas? Run `atlas models`. It prints the resolved catalog that Provider.getModel checks against, which is the authoritative source for valid provider/model ids. ### What format does the model value in atlas.json use? The provider/model format, both halves present and separated by a slash. Atlas prints "Or check your config (atlas.json) provider/model names" when the pair is not found in the resolved catalog. ### What does the Did you mean line mean in an Atlas model error? ProviderModelNotFoundError carries a `suggestions` field, so a Did you mean line means Atlas found a close fuzzy match in the resolved catalog. Read it before guessing, since it usually holds the correct id. ### Atlas shows my provider but not my model, why? The model id is not in the resolved catalog for your account. Confirm your account actually has access to that model id, or pick a different one from `atlas models`. No atlas.json edit can add a model to the catalog. ### Can I change the Atlas model without editing atlas.json? Yes. Use the /models picker in the Atlas TUI. It writes the same value and cannot produce an id outside the resolved catalog, which removes the typo failure mode. Atlas also lets you switch model and provider on the fly with favorites and recents. ### Why did Atlas start failing with Model not found when nothing changed? A provider can retire a model id, which removes it from the resolved catalog even though atlas.json never changed. Run `atlas models`, copy a current provider/model id, and update the `model` value. --- Canonical HTML: https://runatlas.sh/resources/troubleshooting/model-not-found Source of truth: aeo_pages row `/resources/troubleshooting/model-not-found` (segment: Troubleshooting) (this file is generated from it, never hand-edited). Licence: Atlas is proprietary with a free core. It is not open source and there is no public source repository.