Atomic Chat

Hull supports Atomic Chat as a local provider. Atomic Chat runs models on your machine and exposes an OpenAI-compatible API (default http://127.0.0.1:1337/v1).

Website: https://atomic.chat/
Repository: https://github.com/AtomicBot-ai/Atomic-Chat

PrerequisitesCopy Anchor Link

1. Install Atomic Chat (macOS or Windows).
2. Download and load a model in the app.
3. Enable the local API server (default port 1337).
4. Confirm the API responds:

curl http://127.0.0.1:1337/v1/models

Connect Atomic ChatCopy Anchor Link

Hull ships the @hullcode/plugin-atomic-chat plugin by default. It does not call localhost unless you opt in (see below). When enabled, it discovers models from GET /v1/models and can warn if the selected model is not loaded.

Localhost HTTP runs only when one of these is true:

• You configure provider.atomic-chat in hull.jsonc
• You set "model": "atomic-chat/..." (or per-agent model uses atomic-chat)
• You enable optional auto-detect: "atomicChat": { "autoDetect": true } (probes ports 1337 and 1338)

Otherwise no requests are made to Atomic Chat (suitable for restricted environments).

Custom or unlisted modelsCopy Anchor Link

If a loaded model does not appear in the picker, register it under provider.atomic-chat.models:

{
  "model": "atomic-chat/my-local-model",
  "provider": {
    "atomic-chat": {
      "models": {
        "my-local-model": {
          "id": "exact-id-from-v1-models",
          "name": "My Local Model",
        },
      },
    },
  },
}

See Custom Models for all model fields.

TipsCopy Anchor Link

• Prefer capable models with large context windows; agent workflows use long prompts.
• Keep only the models you need loaded in Atomic Chat to save memory.
• For embeddings via Atomic Chat, use the openai-compatible indexing provider with the same base URL.

RelatedCopy Anchor Link

• LM Studio
• Ollama
• Local models overview