Component

core/datastore/weaviate

A Weaviate vector database. Stores objects together with their embedding vectors and answers nearest-neighbour and hybrid queries over them, so an application that retrieves reference material by similarity is wired to this component rather than to a general-purpose store. Collections are created through Weaviate's own API at runtime; the component declares the server, not its contents. Where the application supplies its own vectors the vectorizer module is left unset, which is the default; naming a module makes the server compute vectors for incoming objects. Provider-agnostic: the same component is implemented by a Helm Recipe (Workload synthesis to native Kubernetes resources, running the official upstream image with no external chart) and a Compose Recipe (local development). Exports its host, its HTTP port and its gRPC port to consumers via the uses topology. With `values.metrics_enabled` true each Recipe turns on Weaviate's metrics, served at /metrics on port 2112, and publishes that address as `metrics_endpoint`; false, that key is empty. The port checks no caller, even where an API key is attached, and also answers /tenant-activity, listing each collection's tenants with their last read and write.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:2d46718249df239e03e4022566b6f58f0eab559af8435a1e86dbb12cfd7eb742
Published
2026-11-10T10:11:28Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:6845dc60fc7103028058efbd71bdb9ac4af73620ae823721582758f440afae2c

Reference at this version

oci://hub.aggrega.ai/component/core/datastore/weaviate:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

NameTypeDefaultRequiredDescription
vectorizer_modulestring—noName of the server-side module that computes vectors for incoming objects (for example text2vec-openai). Omit where the application supplies its own vectors, which is the default.
enable_modulesstring—noComma-separated list of server modules to load. Omit for a server with no modules loaded. A named vectorizer_module must appear in this list for the server to load it.
query_defaults_limitinteger (min 1)—noDefault number of results a query returns when it names no limit of its own. Omit to use the server default (100).
api_key_userstringweaviate-adminnoIdentity the attached API key authenticates as. Read only when a credential is attached to the api_key slot; with none attached it is never read.
metrics_enabledbooleanfalsenoTurns on Weaviate's own metrics, in the Prometheus format, on a port of their own, 2112, and publishes their address as `metrics_endpoint`; while false that key is empty. The port checks no caller, even with an API key attached, and also answers /tenant-activity with each collection's tenant names and when each was last read and written.

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
portinteger (min 1024, max 65535)8080noHTTP (REST and GraphQL) listen port. Most operators should omit this and let the Recipe assign the default (8080).
grpc_portinteger (min 1024, max 65535)50051nogRPC listen port, published alongside the HTTP port for clients that prefer it. Most operators should omit this and let the Recipe assign the default (50051).
engine_versionstring1.39.2noWeaviate container image tag.
computeobject—no—
storageobject—no—
overridesobject (open)—noProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
hoststring—yesIn-cluster DNS name of the Service fronting the vector database. A consumer dials this name together with whichever of the two published ports its client speaks.
portinteger—yesTCP port the REST and GraphQL APIs are served on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default.
grpc_portinteger—noTCP port the gRPC API is served on, published beside the HTTP port for a client that prefers it. It is a second listener on the same server, not an alternative address.
protocolstring—noHow the published address is spoken to on `port` — `http`, so a consumer reaching the REST or GraphQL API composes its address on that scheme.
metrics_endpointstring—noThe full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:2112/metrics`, the host being the store's Service name. Empty while values.metrics_enabled is false.

Uses sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

No uses sockets declared.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

SlotSelectorRequiredInjectSensitiveDescription
api_keyfeature.aggrega.ai/kind=secretnoenvyesOptional API-key credential. When attached, anonymous access is turned off and every request must present this key, which is bound to the user named by values.api_key_user; unattached, the server accepts anonymous requests.

Self-inject allowlist

env

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

This entity uses nothing in the catalog.

Used by

Component concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy