Skip to main content
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

​
Installation

1

Pull the Agent Zero Docker image

2

Run the container with port mapping

3

Open the web UI

Once the container is running, open the Agent Zero web interface in your browser:

​
Configuration

1

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).
Agent Zero home dashboard with Settings tile
2

Configure the Main Model

In the Plugin Settings panel, under Main Model:
Agent Zero Plugin Settings panel
  1. Provider: select SambaNova.
  2. Model name: enter a SambaCloud model ID (e.g., MiniMax-M2.7; see the SambaCloud models page for all options).
  3. API key: paste your SambaCloud API key.
  4. Click Save.
3

Verify the connection

Start a new chat and ask who are you to confirm Agent Zero is running on a SambaCloud model.
Agent Zero chat confirming SambaNova model

​
Troubleshooting

  • 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
  • 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