Catalog
Agent Docs

Return ranked artifact recommendations for a concrete use case.

Use this when a human or agent knows the task, such as RAG, local LLMs, coding, vision, datasets, commercial-safe work, global model labs, or hosted downloads.

Inputs. Path, query and header fields are listed below. No request body is required.

Outputs. See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

Errors. API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

Rate limits. Public read budgets apply by client IP and route group. This operation can have a smaller route-specific budget. Read Retry-After on 429 or retryable 503 responses.

get/api/recommender

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/recommender
  • Auth: none declared

Query parameters

useCasestring

Intent such as rag, local-llm, coding, vision, audio, agents, datasets-evals, commercial-safe, global-model-labs, hosted-downloads.

qstring

Optional custom terms appended to the profile search.

tool'ollama' | 'lm-studio' | 'comfyui' | 'transformers' | 'llama.cpp'
commercialboolean
hostedboolean
limitinteger
compat'containment'

Deprecated legacy response block opt-in for one release only.

Response

Use-case recommendations

schemaVersion'hugging-bay.use-case-recommender.v1' required
generatedAtstring required
baseUrlstring
inputstring
useCasestring required
profileobject required
searchobject required
rowsUseCaseRecommendationRow[] required(unresolved $ref)
suggestedUseCasesobject[]
guidancestring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.