diff --git a/docs/.gitbook/assets/atomic-agent-logo.png b/docs/.gitbook/assets/atomic-agent-logo.png
deleted file mode 100644
index 18ff3a7ce..000000000
Binary files a/docs/.gitbook/assets/atomic-agent-logo.png and /dev/null differ
diff --git a/docs/integrations/atomic-agent.md b/docs/integrations/atomic-agent.md
index c193b073e..6de42f1fb 100644
--- a/docs/integrations/atomic-agent.md
+++ b/docs/integrations/atomic-agent.md
@@ -1,7 +1,5 @@
# ⚛️ Atomic Agent
-
-
## 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)
