> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Zero integration guide

[Agent Zero](https://github.com/agent0ai/agent-zero) is an open-source autonomous AI assistant framework that performs complex tasks through intelligent planning and execution. The framework supports:

* Dynamic information gathering and analysis
* Code and command execution
* Multi-agent coordination
* Autonomous objective completion

By integrating SambaCloud, you can leverage enterprise-grade language models with optimized inference performance for Agent Zero's agentic workflows.

## Prerequisites

* A [SambaCloud](https://cloud.sambanova.ai?utm_source=agentzero\&utm_medium=external\&utm_campaign=cloud_signup) account with an API key
* [Docker](https://docs.docker.com/get-docker/) installed and running

## Installation

<Steps>
  <Step title="Pull the Agent Zero Docker image">
    ```bash theme={}
    docker pull agent0ai/agent-zero
    ```
  </Step>

  <Step title="Run the container with port mapping">
    ```bash theme={}
    docker run -p 50001:80 agent0ai/agent-zero
    ```
  </Step>

  <Step title="Open the web UI">
    Once the container is running, open the Agent Zero web interface in your browser:

    ```text theme={}
    http://localhost:50001
    ```
  </Step>
</Steps>

## Configuration

<Steps>
  <Step title="Open Settings from the home dashboard">
    From the Agent Zero home dashboard, click the **Settings** tile (or the gear icon in the top-left toolbar).

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/JEadNlsj1W-5Pvbf/images/docs/integrations/agentzero/agentzero1-1.png?fit=max&auto=format&n=JEadNlsj1W-5Pvbf&q=85&s=624ce57fcb1e94aa970181329df2dfce" alt="Agent Zero home dashboard with Settings tile" width="2424" height="1126" data-path="images/docs/integrations/agentzero/agentzero1-1.png" />
    </Frame>
  </Step>

  <Step title="Configure the Main Model">
    In the **Plugin Settings** panel, under **Main Model**:

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/JEadNlsj1W-5Pvbf/images/docs/integrations/agentzero/agentzero2-1.png?fit=max&auto=format&n=JEadNlsj1W-5Pvbf&q=85&s=347d0e68263d88d95877b7d3f85eef9b" alt="Agent Zero Plugin Settings panel" width="1956" height="1508" data-path="images/docs/integrations/agentzero/agentzero2-1.png" />
    </Frame>

    1. **Provider**: select **SambaNova**.
    2. **Model name**: enter a SambaCloud model ID (e.g., `MiniMax-M3`; see the [SambaCloud models page](/docs/en/models/sambacloud-models) for all options).
    3. **API key**: paste your SambaCloud API key.
    4. Click **Save**.
  </Step>

  <Step title="Verify the connection">
    Start a new chat and ask `who are you` to confirm Agent Zero is running on a SambaCloud model.

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/JEadNlsj1W-5Pvbf/images/docs/integrations/agentzero/agentzero3-1.png?fit=max&auto=format&n=JEadNlsj1W-5Pvbf&q=85&s=7ae407a22b75d971ddb01827bff215c9" alt="Agent Zero chat confirming SambaNova model" width="3006" height="1600" data-path="images/docs/integrations/agentzero/agentzero3-1.png" />
    </Frame>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Docker container fails to start">
    * Ensure Docker is running on your machine
    * Check port 50001 is not already in use: `lsof -i :50001`
    * Try pulling the image again: `docker pull agent0ai/agent-zero`
  </Accordion>

  <Accordion title="Cannot access web UI at localhost:50001">
    * Confirm the container is running: `docker ps`
    * Verify port mapping shows `0.0.0.0:50001->80/tcp` in `docker ps` output
    * Try restarting the container
  </Accordion>

  <Accordion title="Authentication errors or model not found">
    * Verify your API key is correct and active in the [SambaCloud portal](https://cloud.sambanova.ai/apis?utm_source=agentzero\&utm_medium=external\&utm_campaign=cloud_signup)
    * Confirm the model ID matches an available model on the [SambaCloud models page](/docs/en/models/sambacloud-models)
    * Re-enter your API key and click **Save** again
  </Accordion>
</AccordionGroup>