GITBOOK-498: Kilo Code

Author: Dmitry Tumanov

docs/.gitbook/assets/01-welcome.png

@@ -448,6 +448,7 @@
 * [Cursor](integrations/cursor.md)
 * [ElizaOS](integrations/elizaos.md)
 * [GPT Researcher (gptr)](integrations/gpt-researcher-gptr.md)
+* [Kilo Code](integrations/kilo-code.md)
 * [Langflow](integrations/langflow.md)
 * [LiteLLM](integrations/litellm.md)
 * [Make](integrations/make.md)

docs/.gitbook/assets/02-provider-dropdown.png

@@ -0,0 +1,148 @@
+# Kilo Code
+
+## About
+
+[Kilo Code](https://kilocode.ai/) is an open-source AI coding assistant and VS Code extension that enables natural-language code generation, debugging, and refactoring through customizable modes (Architect, Code, Debug, etc.). It supports multiple model providers, integrates with the Model Context Protocol (MCP), and allows developers to extend functionality with custom tools and workflows.
+
+This guide shows how to connect **AI/ML API** as a **custom provider** in **Kilo Code** for VS Code, using the **OpenAI-compatible** path.\
+Follow the steps and screenshots below.
+
+***
+
+## Summary
+
+* **Provider:** OpenAI Compatible (inside Kilo Code)
+* **Base URL:** `https://api.aimlapi.com/v1`
+* **API Key:** from your AI/ML API dashboard
+* **Recommended Model IDs:** [openai/gpt-5-chat-latest](../api-references/text-models-llm/openai/gpt-5-chat.md), [openai/o4-mini](../api-references/text-models-llm/openai/o4-mini.md), [openai/gpt-4.1](../api-references/text-models-llm/openai/gpt-4.1.md) ( or any other supported model)
+
+***
+
+## 0) Install Kilo Code Extension
+
+If you haven’t installed Kilo Code yet:
+
+1. Open VS Code.
+2. Go to Extensions (Ctrl+Shift+X or Cmd+Shift+X).
+3. Search for “Kilo Code”.
+4. Install the extension by Kilo Code.
+5. Reload VS Code if prompted.
+
+After installation, you’ll see the Kilo Code icon in the sidebar.
+
+Or you can install it from the official site: [**kilocode.ai**](https://kilocode.ai/)
+
+***
+
+## 1) Open Kilo Code → “Use your own API key”
+
+From the Kilo Code welcome screen, click **Use your own API key**.
+
+<div align="left" data-with-frame="true"><figure><img src="../.gitbook/assets/01-welcome.png" alt=""><figcaption></figcaption></figure></div>
+
+***
+
+## 2) Choose Provider: **OpenAI Compatible**
+
+Open the provider dropdown and select **OpenAI Compatible**.
+
+<div align="left" data-with-frame="true"><figure><img src="../.gitbook/assets/02-provider-dropdown.png" alt=""><figcaption></figcaption></figure></div>
+
+{% hint style="info" %}
+Tip: Kilo Code also lists many other providers. For AI/ML API use the **OpenAI Compatible** option.
+{% endhint %}
+
+***
+
+## 3) Configure AI/ML API Settings
+
+Fill the form as follows:
+
+*   **Base URL**
+
+    ```
+    https://api.aimlapi.com/v1
+    ```
+* **API Key**\
+  Paste your key from [**https://aimlapi.com/app/keys**](https://aimlapi.com/app/keys)
+* **Model** (examples)
+  * [openai/gpt-5-chat-latest](../api-references/text-models-llm/openai/gpt-5-chat.md) ← recommended universal chat
+  * [openai/gpt-5-2025-08-07](../api-references/text-models-llm/openai/gpt-5.md) ← pinned dated release
+  * [openai/o4-mini](../api-references/text-models-llm/openai/o4-mini.md) ← fast, low-cost
+  * [openai/gpt-4.1](../api-references/text-models-llm/openai/gpt-4.1.md) ← stable classic
+  * _any other supported model by your account_
+* **Use Azure**: `OFF`
+* **Set Azure API version**: leave disabled
+* **Image Support**: `ON` if you plan to send images (e.g., 4o / o4-mini)
+* **Max Output Tokens**: `-1` (let server decide)
+* **Context Window Size**: up to `128000` (adjust as needed)
+
+<div align="left" data-with-frame="true"><figure><img src="../.gitbook/assets/03-openai-compatible-config.png" alt=""><figcaption></figcaption></figure></div>
+
+{% hint style="info" %}
+**Note**: If you have custom headers (e.g., for proxies), add them in the **Custom Headers** field.
+{% endhint %}
+
+***
+
+## 4) Run Your First Task
+
+Open the Kilo Code panel, start a task (Ask/Code/Debug), and send a short test message, for example:
+
+```
+Hi from AI/ML API!
+```
+
+<div align="left" data-with-frame="true"><figure><img src="../.gitbook/assets/04-first-task-success.png" alt=""><figcaption></figcaption></figure></div>
+
+You should see a successful response with tokens/usage bars as in the screenshot.
+
+***
+
+## 🔬 Quick API Sanity Check (optional)
+
+You can also sanity-check your key via `curl`:
+
+{% code overflow="wrap" %}
+```bash
+curl -X POST https://api.aimlapi.com/v1/chat/completions   -H "Authorization: Bearer $AIMLAPI_KEY"   -H "Content-Type: application/json"   -d '{
+    "model": "openai/gpt-5-chat-latest",
+    "messages": [
+      {"role":"system","content":"You are a concise assistant."},
+      {"role":"user","content":"Say hello in one sentence."}
+    ]
+  }'
+```
+{% endcode %}
+
+If the request succeeds, you’re ready to use the same model inside Kilo Code.
+
+***
+
+## 💡 Tips
+
+* **Profiles**: Create multiple _API Configuration Profiles_ (e.g., default = `openai/gpt-5-chat-latest`, heavy = `openai/gpt-5-2025-08-07`, budget = `openai/o4-mini`). Switch per task.
+* **Images**: For vision tasks, keep **Image Support** enabled and use a vision-capable model.
+* **Token Limits**: Large responses may require raising _Max Output Tokens_ or splitting the task.
+* **Headers**: If you need custom headers, add them in **Custom Headers**.
+
+***
+
+## 🧰 Troubleshooting
+
+* **401 / Unauthorized**: Re-check your API key and that it’s pasted without spaces. Regenerate if needed.
+* **404 / Model not found**: Verify the **exact Model ID** you selected is available to your account.
+* **No response / Network issues**: Corporate VPN/Proxy may block `api.aimlapi.com`. Whitelist the domain.
+* **Azure mode confusion**: Leave **Use Azure** toggled **off** unless you specifically need Azure routes.
+
+***
+
+## 📚 Helpful Links
+
+* **AI/ML API Keys**: [https://aimlapi.com/app/keys](https://aimlapi.com/app/keys)
+* **AI/ML API Dashboard**: [https://aimlapi.com/app](https://aimlapi.com/app)
+* **Kilo Code Docs**: [https://kilocode.ai/docs](https://kilocode.ai/docs)
+
+***
+
+Enjoy coding with **Kilo Code + AI/ML API**! 🚀

docs/.gitbook/assets/03-openai-compatible-config.png

@@ -6,4 +6,4 @@ description: About third-party integrations
 
 Our API endpoint can be integrated with popular AI workflow platforms and tools, allowing their users to access our models through these environments.
 
-<table><thead><tr><th width="124">Service</th><th>Description</th></tr></thead><tbody><tr><td><a href="agno.md">Agno</a></td><td>A lightweight library for building agents — AI programs that operate autonomously, use tools, and have memory, knowledge, storage, and reasoning capabilities.</td></tr><tr><td><a href="aider.md">Aider</a></td><td>A command-line pair programming tool that connects to OpenAI-compatible APIs. It lets you chat with models to edit your codebase, auto-commit changes, and build software collaboratively from the terminal.</td></tr><tr><td><a href="autogpt.md">AutoGPT</a></td><td>An open-source platform designed to help you build, test, and run AI agents using a no-code visual interface. It allows users to link LLMs with tools, memory, planning modules, and action chains.</td></tr><tr><td><a href="cline.md">Cline</a></td><td>An open-source AI coding assistant with two working modes (Plan/Act), terminal command execution, and support for the Model Context Protocol (MCP) in VS Code.</td></tr><tr><td><a href="continue.dev.md">continue.dev</a></td><td>An open-source IDE extension and hub for rules, tools, and models that let you create, share, and use custom AI code assistants.</td></tr><tr><td><a href="cursor.md">Cursor</a></td><td>An advanced AI-powered IDE that combines intelligent code completion, inline explanations, and automatic code editing directly inside the editor.</td></tr><tr><td><a href="elizaos.md">ElizaOS</a></td><td>A powerful multi-agent simulation framework designed to create, deploy, and manage autonomous AI agents. Built with TypeScript, it provides a flexible and extensible platform for developing intelligent agents that can interact across multiple platforms while maintaining consistent personalities and knowledge.</td></tr><tr><td><a href="gpt-researcher-gptr.md">GPT Researcher</a></td><td>An autonomous agent that takes care of the tedious task of research for you, by scraping, filtering and aggregating over 20+ web sources per a single research task.</td></tr><tr><td><a href="langflow.md">Langflow</a></td><td>A new visual framework for building multi-agent and RAG applications. It is open-source, Python-powered, fully customizable, and LLM and vector store agnostic. Its intuitive interface allows for easy manipulation of AI building blocks, enabling developers to quickly prototype and turn their ideas into powerful, real-world solutions.</td></tr><tr><td><a href="litellm.md">LiteLLM</a></td><td>An open-source Python library that provides a unified API for interacting with multiple large language model providers. It allows developers to switch between different models with minimal code changes, optimizing cost and performance. LiteLLM simplifies integration by offering a single interface for various LLM endpoints, enabling seamless experimentation and deployment across different AI providers.</td></tr><tr><td><a href="make.md">Make</a></td><td>A powerful, enterprise-scale automation platform. It offers flow control, data manipulation, HTTP/webhooks, AI agents and tools, notes, an MCP server, and many other features at your service.</td></tr><tr><td><a href="n8n.md">n8n</a></td><td>An open-source workflow automation tool that lets you connect various services and automate tasks without writing full integrations manually.</td></tr><tr><td><a href="roo-code.md">Roo Code</a></td><td>An autonomous AI programming agent that works right inside your editor, such as VS Code. It helps you code faster and smarter — whether you're starting a new project, maintaining existing code, or exploring new technologies.</td></tr><tr><td><a href="sillytavern.md">SillyTavern</a></td><td>A locally installed user interface that allows you to interact with text generation LLMs, image generation engines, and TTS voice models. Integration with the AI/ML API currently applies only to LLMs.</td></tr><tr><td><a href="toolhouse.md">Toolhouse</a></td><td>A Backend-as-a-Service (BaaS) to build, run, and manage AI agents. Toolhouse simplifies the process of building agents in a local environment and running them in production.</td></tr></tbody></table>
+<table><thead><tr><th width="124">Service</th><th>Description</th></tr></thead><tbody><tr><td><a href="agno.md">Agno</a></td><td>A lightweight library for building agents — AI programs that operate autonomously, use tools, and have memory, knowledge, storage, and reasoning capabilities.</td></tr><tr><td><a href="aider.md">Aider</a></td><td>A command-line pair programming tool that connects to OpenAI-compatible APIs. It lets you chat with models to edit your codebase, auto-commit changes, and build software collaboratively from the terminal.</td></tr><tr><td><a href="autogpt.md">AutoGPT</a></td><td>An open-source platform designed to help you build, test, and run AI agents using a no-code visual interface. It allows users to link LLMs with tools, memory, planning modules, and action chains.</td></tr><tr><td><a href="cline.md">Cline</a></td><td>An open-source AI coding assistant with two working modes (Plan/Act), terminal command execution, and support for the Model Context Protocol (MCP) in VS Code.</td></tr><tr><td><a href="continue.dev.md">continue.dev</a></td><td>An open-source IDE extension and hub for rules, tools, and models that let you create, share, and use custom AI code assistants.</td></tr><tr><td><a href="cursor.md">Cursor</a></td><td>An advanced AI-powered IDE that combines intelligent code completion, inline explanations, and automatic code editing directly inside the editor.</td></tr><tr><td><a href="elizaos.md">ElizaOS</a></td><td>A powerful multi-agent simulation framework designed to create, deploy, and manage autonomous AI agents. Built with TypeScript, it provides a flexible and extensible platform for developing intelligent agents that can interact across multiple platforms while maintaining consistent personalities and knowledge.</td></tr><tr><td><a href="gpt-researcher-gptr.md">GPT Researcher</a></td><td>An autonomous agent that takes care of the tedious task of research for you, by scraping, filtering and aggregating over 20+ web sources per a single research task.</td></tr><tr><td><a href="https://kilocode.ai/">Kilo Code</a></td><td>An open-source AI coding assistant and VS Code extension that enables natural-language code generation, debugging, and refactoring through customizable modes (Architect, Code, Debug, etc.). It supports multiple model providers, integrates with the Model Context Protocol (MCP), and allows developers to extend functionality with custom tools and workflows.</td></tr><tr><td><a href="langflow.md">Langflow</a></td><td>A new visual framework for building multi-agent and RAG applications. It is open-source, Python-powered, fully customizable, and LLM and vector store agnostic. Its intuitive interface allows for easy manipulation of AI building blocks, enabling developers to quickly prototype and turn their ideas into powerful, real-world solutions.</td></tr><tr><td><a href="litellm.md">LiteLLM</a></td><td>An open-source Python library that provides a unified API for interacting with multiple large language model providers. It allows developers to switch between different models with minimal code changes, optimizing cost and performance. LiteLLM simplifies integration by offering a single interface for various LLM endpoints, enabling seamless experimentation and deployment across different AI providers.</td></tr><tr><td><a href="make.md">Make</a></td><td>A powerful, enterprise-scale automation platform. It offers flow control, data manipulation, HTTP/webhooks, AI agents and tools, notes, an MCP server, and many other features at your service.</td></tr><tr><td><a href="n8n.md">n8n</a></td><td>An open-source workflow automation tool that lets you connect various services and automate tasks without writing full integrations manually.</td></tr><tr><td><a href="roo-code.md">Roo Code</a></td><td>An autonomous AI programming agent that works right inside your editor, such as VS Code. It helps you code faster and smarter — whether you're starting a new project, maintaining existing code, or exploring new technologies.</td></tr><tr><td><a href="sillytavern.md">SillyTavern</a></td><td>A locally installed user interface that allows you to interact with text generation LLMs, image generation engines, and TTS voice models. Integration with the AI/ML API currently applies only to LLMs.</td></tr><tr><td><a href="toolhouse.md">Toolhouse</a></td><td>A Backend-as-a-Service (BaaS) to build, run, and manage AI agents. Toolhouse simplifies the process of building agents in a local environment and running them in production.</td></tr></tbody></table>