# Run an AI coding agent with a local model > Atlas runs against a local model from Ollama or LM Studio; atlas models --local detects the server and registers its models as a first-class provider. Atlas is model-agnostic and runs against a local model as easily as a hosted one. Point it at any local OpenAI-compatible server, Ollama or LM Studio, and run atlas models --local: in 2026 Atlas detects the running server, lists its chat models, and registers them as a provider you pick like any other. A local model runs on your machine with no per-token API cost, and pairs with offline mode to run fully air-gapped. ## Key takeaways - Atlas works with any local OpenAI-compatible server: Ollama or LM Studio. - atlas models --local detects the server and registers its chat models automatically. - A local model has no per-token API cost; you bring the model, Atlas is the agent. - Pair a local model with offline mode (atlas --offline) to run fully air-gapped. ## Why run a local model There are 3 reasons developers point an AI coding agent at a local model in 2026: keeping code on their own machine, avoiding per-token API bills, and not depending on a hosted provider's uptime or pricing. A local model turns the cost of heavy agent use from a metered API bill into the fixed cost of your own hardware, which matters when an agent makes many calls per task. It also keeps the model side of the loop on your machine, so paired with a local code index there is no third-party in the path at all. Atlas stays model-agnostic either way: you can run local, bring your own hosted keys, or mix them per task. ## Ollama and LM Studio Run atlas models --local. Atlas probes the 2 common local servers, Ollama on port 11434 and LM Studio on port 1234, finds whichever is running, and lists its installed chat models. It then registers those models as a provider in your config, so they appear in the model picker and in atlas models exactly like a hosted provider. There is no config file to hand-edit and no schema to reverse-engineer. If your server runs on a non-default port, set ATLAS_LOCAL_MODEL_URL and Atlas probes that instead. Embedding-only models are filtered out, so the picker shows only models you can actually chat with. ## Model-agnostic by design Atlas resolves the model per message, so you are never locked to 1 provider. Switch between a local model and a hosted one from the picker, or use different models for different work. That means a local model is not an all-or-nothing commitment: run a small local model for routine edits and switch to a hosted frontier model for the hard problems, without changing tools. Bring your own keys for the hosted providers you already pay for, and Atlas routes to whichever you pick. The agent, the planning, the diffs, and the permission gating stay the same regardless of which model is behind them. ## Local model plus offline mode A local model is what makes air-gapped work possible. With a local model selected and offline mode on (atlas --offline), the only network Atlas touches is your local model server on your own machine. This is the combination for developers who cannot send code to a cloud at all: the model is local, the code index can use local embeddings, and offline mode blocks every other outbound call. See the offline mode guide for how the network boundary is enforced. You bring the model; Atlas keeps the rest of the loop on hardware you control. ## FAQ ### Can Atlas use a local model? Yes. Atlas works with any local OpenAI-compatible server, including Ollama and LM Studio. Run atlas models --local to detect it and register its models. ### How do I connect Ollama to Atlas? Run atlas models --local. Atlas detects Ollama on port 11434, lists your installed chat models, and registers them as a provider you can pick. ### Does Atlas work with LM Studio? Yes. LM Studio on port 1234 is auto-detected too. For a non-default port, set ATLAS_LOCAL_MODEL_URL and Atlas probes that endpoint. ### Do I need an API key for a local model? No. A local model runs on your machine with no per-token cost. You can still bring API keys for hosted models and switch between them. ### Can I run fully offline with a local model? Yes. Pair a local model with offline mode (atlas --offline) so the only network Atlas touches is your local model server. --- Canonical HTML: https://runatlas.sh/resources/features/run-atlas-with-a-local-model Source of truth: aeo_pages row `/resources/features/run-atlas-with-a-local-model` (segment: Platform) (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.