Reranker Create

goodmem reranker create [flags]

  # Create a Cohere reranker with a client-provided ID
  goodmem reranker create \
    --id "123e4567-e89b-12d3-a456-426614174000" \
    --display-name "Cohere Reranker" \
    --provider-type COHERE \
    --endpoint-url "https://api.cohere.com" \
    --model-identifier "rerank-english-v3.0" \
    --cred-api-key "YOUR_COHERE_API_KEY"

  # Create a Cohere reranker (server-generated ID)
  goodmem reranker create \
    --display-name "Cohere Reranker" \
    --provider-type COHERE \
    --endpoint-url "https://api.cohere.com" \
    --model-identifier "rerank-english-v3.0" \
    --cred-api-key "YOUR_COHERE_API_KEY"

  # Create a Jina reranker with inline credentials
  goodmem reranker create \
    --display-name "Jina Reranker" \
    --provider-type JINA \
    --endpoint-url "https://api.jina.ai" \
    --model-identifier "jina-reranker-v3" \
    --cred-api-key "YOUR_JINA_API_KEY"

  # Create a Voyage AI reranker with inline credentials
  goodmem reranker create \
    --display-name "Voyage Reranker" \
    --provider-type VOYAGE \
    --endpoint-url "https://api.voyageai.com/v1" \
    --model-identifier "rerank-2.5" \
    --cred-api-key "YOUR_VOYAGE_API_KEY"

  # Create a local vLLM reranker (self-hosted, no credentials needed)
  goodmem reranker create \
    --display-name "Local vLLM" \
    --provider-type VLLM \
    --endpoint-url "http://localhost:8000" \
    --model-identifier "BAAI/bge-reranker-v2-m3" \
    --label environment=dev

  # Create a TEI reranker (HuggingFace Text Embeddings Inference)
  goodmem reranker create \
    --display-name "TEI Local" \
    --provider-type TEI \
    --endpoint-url "http://localhost:8081" \
    --model-identifier "cross-encoder/ms-marco-MiniLM-L-6-v2"

  # Create a reranker for another user (requires admin permissions)
  goodmem reranker create \
    --display-name "Team Cohere Reranker" \
    --provider-type COHERE \
    --endpoint-url "https://api.cohere.com" \
    --model-identifier "rerank-english-v3.0" \
    --cred-api-key "TEAM_API_KEY" \
    --owner 123e4567-e89b-12d3-a456-426614174000

  # Create a DashScope text reranker in Singapore using the native API
  goodmem reranker create \
    --display-name "DashScope qwen3-rerank" \
    --provider-type DASHSCOPE \
    --endpoint-url "https://dashscope-intl.aliyuncs.com" \
    --model-identifier "qwen3-rerank" \
    --modalities TEXT \
    --dashscope-api-dialect RERANK_NATIVE_NESTED \
    --cred-api-key-prompt

  # Verify a DashScope endpoint and dialect before creating the reranker
  goodmem doctor reranker "https://dashscope-intl.aliyuncs.com" \
    --model "qwen3-rerank" \
    --probe-dialect \
    --cred-api-key-prompt

      --api-path string                Optional API operation path; omitted values use a provider- and dialect-specific default
      --cred-api-key string            API key for provider endpoint (use "-" to read from piped stdin)
      --cred-api-key-file string       Read API key from file (file should be mode 0600)
      --cred-api-key-prompt            Prompt for API key interactively (requires TTY, input hidden)
      --cred-gcp                       Use Google Application Default Credentials
      --cred-gcp-quota string          Quota project for Google ADC requests
      --cred-gcp-scope strings         Additional Google ADC OAuth scope (can be specified multiple times)
      --dashscope-api-dialect string   DashScope API dialect for DashScope resources only (RERANK_NATIVE_NESTED or RERANK_COMPATIBLE_FLAT)
      --description string             Description of the reranker
      --display-name string            Display name for the reranker (required)
      --endpoint-url string            Provider endpoint base URL without the operation path (required)
  -h, --help                           help for create
      --id string                      Optional: Client-provided UUID for the reranker (16 bytes). Server generates if omitted.
      --label strings                  Labels in key=value format (can be specified multiple times)
      --modalities strings             Supported modalities (TEXT, IMAGE, AUDIO, VIDEO); defaults to TEXT
      --model-identifier string        Model identifier (required)
      --monitoring-endpoint string     Monitoring endpoint URL
      --owner string                   Owner ID (for admin use, requires CREATE_RERANKER_ANY permission)
      --provider-type string           Provider type (VLLM, TEI, LLAMA_CPP, VOYAGE, COHERE, JINA, DASHSCOPE) (required)
      --version string                 Version information

      --api-key string   API key for authentication (can also be set via GOODMEM_API_KEY environment variable)
      --server string    GoodMem server address (gRPC API)