Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ollama.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Install

Install the Droid CLI: 
curl -fsSL https://app.factory.ai/cli | sh
Droid requires a larger context window. It is recommended to use a context window of at least 64k tokens. See Context length for more information.

​
Usage with Ollama

​
Quick setup

ollama launch droid
To configure without launching: 
ollama launch droid --config

​
Manual setup

Add a local configuration block to ~/.factory/config.json: 
{
  "custom_models": [
    {
      "model_display_name": "qwen3-coder [Ollama]",
      "model": "qwen3-coder",
      "base_url": "http://localhost:11434/v1/",
      "api_key": "not-needed",
      "provider": "generic-chat-completion-api",
      "max_tokens": 32000 
    }
  ]
}

​
Cloud Models

qwen3-coder:480b-cloud is the recommended model for use with Droid. Add the cloud configuration block to ~/.factory/config.json: 
{
  "custom_models": [
    {
      "model_display_name": "qwen3-coder [Ollama Cloud]",
      "model": "qwen3-coder:480b-cloud",
      "base_url": "http://localhost:11434/v1/",
      "api_key": "not-needed",
      "provider": "generic-chat-completion-api",
      "max_tokens": 128000
    }
  ]
}

​
Connecting to ollama.com

  1. Create an API key from ollama.com and export it as OLLAMA_API_KEY.
  2. Add the cloud configuration block to ~/.factory/config.json: 
    {
  "custom_models": [
    {
      "model_display_name": "qwen3-coder [Ollama Cloud]",
      "model": "qwen3-coder:480b",
      "base_url": "https://ollama.com/v1/",
      "api_key": "OLLAMA_API_KEY",
      "provider": "generic-chat-completion-api",
      "max_tokens": 128000
    }
  ]
}
Run droid in a new terminal to load the new settings.