From 85b872b6122fa6ac1f1d2307fc8954183400cfc1 Mon Sep 17 00:00:00 2001 From: Nadya Rodionova <273119990+sosidudku1@users.noreply.github.com> Date: Thu, 6 Aug 2026 00:56:12 +0300 Subject: [PATCH] Restyle Atomic Agent guide with stepper components Converts the setup flow to the numbered stepper format used on the Claude Code integration page: install, provider panel, API key, model pick, first task. Manual configuration, model notes, use cases, and troubleshooting stay as regular sections. Removes the oversized logo figure and its now-unused asset. No factual changes. Co-Authored-By: Claude Fable 5 --- docs/.gitbook/assets/atomic-agent-logo.png | Bin 19766 -> 0 bytes docs/integrations/atomic-agent.md | 98 +++++++++++---------- 2 files changed, 52 insertions(+), 46 deletions(-) delete mode 100644 docs/.gitbook/assets/atomic-agent-logo.png diff --git a/docs/.gitbook/assets/atomic-agent-logo.png b/docs/.gitbook/assets/atomic-agent-logo.png deleted file mode 100644 index 18ff3a7ce2738aabbfa52c3dc44aaeaadc6ae32a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19766 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 Z{y#bL>gvjz5~%
Atomic Agent logo
- ## About Atomic Agent is an open-source, local-first AI agent that runs on your computer. It plans multi-step tasks and executes them with real tools: shell, files, browser automation, skills, and MCP servers. All agent state, memory, and configuration live on your machine in `~/.atomic-agent`. @@ -24,43 +22,75 @@ Atomic Agent is MIT-licensed and available for macOS, Linux, and Windows. * Telegram connector and an OpenAI-compatible local HTTP server * MIT license, installs without an account +## Prerequisites + +* An AIMLAPI key obtained from your [account dashboard](https://aimlapi.com/app/keys) + *** -## Quick Install +{% stepper %} +{% step %} +### Step 1 — Install Atomic Agent -One command, no account or key required: +One command, no account or key required. -```sh -# macOS / Linux +macOS / Linux: + +```bash curl -fsSL https://atomicagent.io/install | sh ``` +Windows: + ```powershell -# Windows irm https://atomicagent.io/install.ps1 | iex ``` +{% endstep %} -*** +{% step %} +### Step 2 — Open the Provider Panel + +Launch the TUI and open the LLM Local/Cloud panel: + +```bash +atomic-agent tui +``` + +Then type: + +``` +/model +``` +{% endstep %} -## Configuration +{% step %} +### Step 3 — Connect AI/ML API -You will need an AIMLAPI key from your [account dashboard](https://aimlapi.com/app/keys). +Select **AI/ML API (aimlapi.com — 500+ models, OpenAI-compatible)** from the provider list and paste your API key when prompted. -### Option 1: Built-in provider wizard (recommended) +The wizard stores the key as `AIMLAPI_API_KEY` in `~/.atomic-agent/.env` and writes the provider entry to `~/.atomic-agent/config.json`. The base URL is built into the provider, so there is nothing else to configure. +{% endstep %} -Atomic Agent ships with a native AI/ML API provider, so there is nothing to configure by hand. +{% step %} +### Step 4 — Pick a Model -1. Run `atomic-agent tui`. -2. Type `/model` to open the LLM Local/Cloud panel. -3. Select **AI/ML API (aimlapi.com — 500+ models, OpenAI-compatible)**. -4. Paste your API key when prompted. -5. Pick a chat model. The list is fetched live from the AI/ML API, so new models appear as soon as they are released. +Choose a chat model from the list. Atomic Agent fetches the current model catalog live from the AI/ML API, so new models appear as soon as they are released. + +The default chat model is `openai/gpt-5.5-2026-04-23`. Any model ID from the [AI/ML API catalog](https://aimlapi.com/models) works, for example `anthropic/claude-sonnet-4-5` or `alibaba/qwen3.8-max-preview` — the configured ID is sent to the API as-is. +{% endstep %} + +{% step %} +### Step 5 — Run Your First Task + +Ask for something that requires a tool call, for example: "list the files in this folder and summarize them". If the model responds and tools execute, the integration is working. -The wizard stores the key as `AIMLAPI_API_KEY` in `~/.atomic-agent/.env` and writes the provider entry to `~/.atomic-agent/config.json`. +You can return to `/model` at any time to switch the provider or the model. No restart is required. +{% endstep %} +{% endstepper %} -### Option 2: Manual configuration +## Manual Configuration -Add the provider to the `llm` block of `~/.atomic-agent/config.json`: +If you prefer editing files over the wizard, add the provider to the `llm` block of `~/.atomic-agent/config.json`: ```json { @@ -81,39 +111,19 @@ Add the provider to the `llm` block of `~/.atomic-agent/config.json`: Then put your key in `~/.atomic-agent/.env`: -```sh +```bash AIMLAPI_API_KEY=your_key_here ``` -The base URL (`https://api.aimlapi.com`) is built into the provider; you do not need to set it. - {% hint style="info" %} If you prefer the generic `"kind": "openai-compatible"` provider instead, set `"baseUrl": "https://api.aimlapi.com"` **without** the `/v1` suffix. Atomic Agent appends `/v1/chat/completions` itself, and a doubled path returns 404. That provider kind reads its key from `OPENAI_COMPAT_API_KEY`. {% endhint %} -*** - -## Model Selection +## Model Notes -* Default chat model for the AI/ML API provider: `openai/gpt-5.5-2026-04-23`. -* Any model ID from the [AI/ML API catalog](https://aimlapi.com/models) works, for example `anthropic/claude-sonnet-4-5` or `alibaba/qwen3.8-max-preview`. The configured model ID is sent to the API as-is, so you are not limited to the bundled list. * Embedding models from the AI/ML API catalog can be selected too, or embeddings can stay on the local llama-server daemon. * For cloud models, Atomic Agent uses native function calling, so tool use works out of the box. -*** - -## Verification - -Start a session: - -```sh -atomic-agent tui -``` - -Ask for something that requires a tool call, for example: "list the files in this folder and summarize them". If the model responds and tools execute, the integration is working. - -*** - ## Use Cases * **Frontier models inside a local agent.** Keep the agent runtime, tools, and files on your machine while using top cloud models for reasoning. @@ -121,8 +131,6 @@ Ask for something that requires a tool call, for example: "list the files in thi * **One key, many models.** Switch between model families without separate accounts and billing per provider. * **Mixed setups.** Run embeddings locally and chat in the cloud, or the other way around. -*** - ## Troubleshooting
@@ -157,8 +165,6 @@ Open `/model` in the TUI at any time to change the provider or the chat model. N
-*** - ## Links * Website: [atomicagent.io](https://atomicagent.io)