GoodMem
ReferenceCLI

Reranker Create

Reranker Create CLI command reference

goodmem reranker create

Create a new reranker

Synopsis

Create a new reranker in the GoodMem service with the specified configuration.

goodmem reranker create [flags]

Examples

  # Create a Cohere reranker with a client-provided ID (defaults api-path to /v2/rerank)
  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 Voyage AI reranker with inline credentials
  goodmem reranker create --display-name "Voyage Reranker" --provider-type VOYAGE --endpoint-url "https://api.voyageai.com" --api-path "/v1/rerank" --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

Options

      --api-path string              API path (defaults to provider-specific path when not specified)
      --cred-api-key string          Inline API key stored by GoodMem (sends Authorization: Bearer <key>)
      --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)
      --description string           Description of the reranker
      --display-name string          Display name for the reranker (required)
      --endpoint-url string          API endpoint URL (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)
      --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, VOYAGE, COHERE, JINA) (required)
      --version string               Version information

Options inherited from parent commands

      --api-key string   API key for authentication (can also be set via GOODMEM_API_KEY environment variable)
      --server string    GoodMem server address (gRPC API) (default "https://localhost:9090")

SEE ALSO