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-426614174000Options
--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 informationOptions 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
- goodmem reranker - Manage GoodMem rerankers