Component
core/ai-agent/librechat
A self-hosted LibreChat installation — the browser platform a person holds conversations in, and the tier that turns a bare model endpoint into a working assistant surface. It reaches its model through the `model` uses-socket and adds agents an author assembles without writing code, tool invocation over the tool servers an administrator registers, a code interpreter, and retrieval over files a user uploads. Every agent run, a delegated child run included, is entered from a conversation a person started: the platform runs no background loop of its own. Its accounts, conversations, agents and stored per-user credentials live in a document store wired through the `backend` socket, the system of record; only uploaded files sit on a volume of its own. A store that requires a sign-in, as FerretDB does by default, takes the user and password from the credential attached on that connection. The two token-signing secrets and the credential-encryption pair decide what its sign-ins and stored credentials are worth, and each has a slot of its own. None of the four has a default, and the build halts until each slot is filled. On Kubernetes, reach for `librechat-chart`, rendering the project's own chart, where a chart repository is reachable at build time, and for `librechat`, the workload synthesis, where the build must fetch nothing. With `values.metrics_enabled` true each Recipe turns on the platform's Prometheus metrics, at /metrics on its port and answered only to a bearer token equal to the secret attached to metrics_secret, and publishes the address as `metrics_endpoint`; a scrape presents that secret on its connection's `credential` slot.
Nguồn gốc
- Digest nội dung
- sha256:592d4a83b2f5fe0574aaf9a1b2b37e6ad350ef54112d34906bd5444e7224c385
- Đã xuất bản
- 2026-11-12T20:47:23Z
- Danh tính ký
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/dev
Chữ ký
- Chính thứcapplication/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/dev
sha256:fbd85cd707a558aca4a1dc988647ccda749aea924c175cceda57be4559aa7c45
Tham chiếu ở phiên bản này
oci://hub.aggrega.ai/component/core/ai-agent/librechat:1.1.0Tham số của nhà phát triển
Các giá trị mà nhà phát triển đặt trong Aggregate.
Mở rộng BaseComponents#/schemas/BaseAgentParameter
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| app_title | string | LibreChat | không | Name the platform presents in the browser title and the interface header. Two installations reachable by the same people tell themselves apart by carrying different titles. |
| database_name | string | LibreChat | không | Name of the logical database the platform uses inside the wired document store. Two installations sharing one store keep their data apart by carrying different names. |
| allow_registration | boolean | false | không | Whether a visitor who is not yet a user may create an account from the sign-in page. Left off, accounts are created only by an administrator, which is the posture an installation reachable beyond its own team wants. |
| metrics_enabled | boolean | false | không | Turns on LibreChat's own metrics, in the Prometheus format, at /metrics on the platform's port, and publishes their address as `metrics_endpoint`; while false that key is empty. The platform answers them only to the secret attached to metrics_secret, presented as a bearer token, so the build halts when this is true and that slot is unfilled. They carry request counts and timings, never a user's or conversation's identifier or content. |
Định cỡ của người vận hành
Định cỡ hạ tầng mà người vận hành tinh chỉnh theo từng môi trường.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 3080 | không | Listen port the platform serves its interface and API on, and the port consumers connect to. Most operators should omit this and let the Recipe assign the default (3080). |
| engine_version | string | v0.8.7 | không | LibreChat container image tag. Selects the image tag of the platform container on both Recipes. |
| source_version | string | — | không | Version of the platform's own Helm chart the chart-backed Recipe pulls, defaulting to the version that Recipe was checked against. The workload-synthesis Recipe pulls no chart and reads nothing here. |
| storage | object | — | không | — |
| external_base_url | string | không | Externally reachable base URL of the installation, as a browser sees it — the address the ingress tier publishes. The platform composes the links it emits from it and accepts browser requests against it. Left empty, the Recipe supplies the installation's own in-cluster address instead, which suits an installation reached only in-cluster. | |
| compute | object | — | không | — |
| overrides | object (open) | — | không | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Hợp đồng đầu ra
Các giá trị mà thành phần này xuất bản cho bên tiêu thụ qua cấu trúc liên kết uses.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| host | string | — | có | In-cluster DNS name of the Service serving the chat interface and its API. The ingress tier points its upstream at this name. |
| port | integer | — | có | TCP port that Service serves the interface and API on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default. |
| protocol | string | — | không | URL scheme to reach `host` and `port` over, which a consumer composes its base URL on. |
| metrics_endpoint | string | — | không | The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<port>/metrics`, on the port the interface is served on. Empty while values.metrics_enabled is false. |
| metrics_credential_required | boolean | — | không | Whether a scrape of `metrics_endpoint` must present a credential: true while values.metrics_enabled is true, because the platform answers its metrics only to the secret attached to metrics_secret, which a scrape presents on its connection's `credential` slot; false while no address is published. |
Các socket uses
Các socket phụ thuộc mà thành phần này kết nối qua. Đích của mọi kết nối được nối qua một socket phải thỏa mãn bộ chọn nhãn của socket đó, và mỗi kết nối có thể mang theo phần đính kèm trong các slot mà socket khai báo. Một slot bắt buộc phải được đáp ứng bởi mỗi kết nối mà Aggregate hoặc Release nối qua socket.
model
- Bộ chọn
- component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
- Tiêm
- —
Các slot mà mỗi kết nối qua socket này có thể lấp đầy
| Slot | Bộ chọn | Bắt buộc | Tiêm | Nhạy cảm | Mô tả |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | không | env | có | Optional credential the platform presents to the model this connection reaches. Unattached, the Recipe leaves the platform in its per-user mode, where each person enters their own key in the interface and no key is rendered at all. |
backend
- Bộ chọn
- component.aggrega.ai/category=datastore
- Tiêm
- —
Các slot mà mỗi kết nối qua socket này có thể lấp đầy
| Slot | Bộ chọn | Bắt buộc | Tiêm | Nhạy cảm | Mô tả |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | không | env | có | Optional sign-in the platform presents to the document store this connection reaches, written as <user>:<password> with any reserved URL character in either part percent-encoded, since it becomes the user-information part of the connection string. Unattached, the connection string carries no user part. |
Slot đính kèm
Các điểm liên kết có tên mà tại đó một Feature được gắn vào thành phần này. Bộ chọn của một slot giới hạn Feature nào có thể lấp đầy nó, và danh sách tiêm của slot nêu cách nội dung của Feature có thể được chuyển giao. Một slot bắt buộc phải được liên kết trên mọi thể hiện, bằng một phần đính kèm trên thể hiện đó hoặc ở một phạm vi phía trên nó, và một slot nhạy cảm được khai báo để xử lý nội dung bí mật. Một Feature cũng có thể được gắn dưới một tên mà không slot nào khai báo.
| Slot | Bộ chọn | Bắt buộc | Tiêm | Nhạy cảm | Mô tả |
|---|---|---|---|---|---|
| session_secret | feature.aggrega.ai/kind=secret | có | env | có | Required secret the platform signs its access tokens with. There is no default: the build halts when nothing fills this slot. Blanking the variable instead, so the platform generates one for itself, is a bootstrap convenience rather than a credential-rotation system: the generated value does not survive a restart and a second replica generates a different one, and each change invalidates every session then active. |
| session_refresh_secret | feature.aggrega.ai/kind=secret | có | env | có | Required secret the platform signs its refresh tokens with — the tokens a browser presents to mint a new access token, so it carries the weight of the access-token secret. There is no default: the build halts when nothing fills this slot. Blanking the variable instead, so the platform generates one for itself, is a bootstrap convenience rather than a credential-rotation system: the generated value does not survive a restart and a second replica generates a different one, and each change makes every person sign in again. |
| credential_encryption_key | feature.aggrega.ai/kind=secret | có | env | có | Required key the platform encrypts the credentials it stores in the document store under, as 64 hexadecimal characters (a 32-byte key). It encrypts the credentials it supports whether or not the people using the installation ever save one of their own, so this slot is filled even where the model key is supplied centrally. There is no default: the build halts when nothing fills this slot. Blanking the variable instead, so the platform generates one for itself, is a bootstrap convenience rather than a credential-rotation system: the generated value does not survive a restart and a second replica generates a different one, and each change leaves everything already stored undecryptable. |
| credential_encryption_iv | feature.aggrega.ai/kind=secret | có | env | có | Required initialization vector the platform pairs with the credential-encryption key when it encrypts what it stores, as 32 hexadecimal characters (16 bytes). A vector is not secret by cryptographic design, but one every reader of this catalog held would be the same in every Release, so there is no default: the build halts when nothing fills this slot. Blanking the variable instead, so the platform generates one for itself, is a bootstrap convenience rather than a credential-rotation system: the generated value does not survive a restart and a second replica generates a different one, and each change leaves everything already stored undecryptable. |
| metrics_secret | feature.aggrega.ai/kind=secret | không | env | có | Optional secret the platform answers its Prometheus metrics to: a scrape presents it as a bearer token, on its connection's credential slot. It is delivered as METRICS_SECRET only while values.metrics_enabled is true, and is required then: the build halts when the value is true and nothing fills this slot. There is no default. While the value is false it is not delivered, and the platform answers its metrics route 401 to every caller. |
Danh sách cho phép tự tiêm
Chưa khai báo đường ống tự tiêm nào.
Quan hệ
Các cạnh có kiểu đi tới và đi từ các thực thể đã xuất bản khác. Một tham chiếu không có đích đã xuất bản được hiển thị là một cạnh bị đứt thay vì một liên kết.
Sử dụng
- sử dụngsử dụng socket «model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Slot đính kèm: credential
core/ai-model/ai21 v1.0.0 →core/ai-model/anthropic v1.0.0 →core/ai-model/azure-managed v1.0.0 →core/ai-model/azure-openai v1.0.0 →core/ai-model/azure-openai-embedding v1.0.0 →core/ai-model/bedrock v1.0.0 →core/ai-model/bedrock-embedding v1.0.0 →core/ai-model/cohere v1.0.0 →core/ai-model/databricks v1.0.0 →core/ai-model/docker-model-runner v1.0.0 →core/ai-model/gemini v1.0.0 →core/ai-model/huggingface v1.0.0 →core/ai-model/litellm v1.0.0 →core/ai-model/mistral v1.0.0 →core/ai-model/nvidia-api v1.0.0 →core/ai-model/nvidia-nim v1.0.0 →core/ai-model/ollama v1.0.0 →core/ai-model/openai v1.0.0 →core/ai-model/openai-compatible v1.0.0 →core/ai-model/openai-embedding v1.0.0 →core/ai-model/replicate v1.0.0 →core/ai-model/sagemaker v1.0.0 →core/ai-model/tei v1.0.0 →core/ai-model/tgi v1.0.0 →core/ai-model/vertex-ai v1.0.0 →core/ai-model/vertex-ai-embedding v1.0.0 →core/ai-model/vllm v1.0.0 →core/gateway/agentgateway v1.0.0 →core/gateway/apisix v1.0.0 →core/gateway/envoy-gateway v1.0.0 →core/gateway/higress v1.0.0 →core/gateway/kong v1.0.0 →core/gateway/kong-enterprise v1.0.0 →core/gateway/litellm v1.0.0 →core/gateway/traefik-hub v1.0.0 → - sử dụngsử dụng socket «backend»
component.aggrega.ai/category=datastore
Slot đính kèm: credential
core/datastore/chroma v1.0.0 →core/datastore/cognee v1.0.0 →core/datastore/documentdb v1.0.0 →core/datastore/elasticsearch v1.0.0 →core/datastore/etcd v1.0.0 →core/datastore/ferretdb v1.0.0 →core/datastore/mariadb v1.0.0 →core/datastore/mariadb-operator v1.0.0 →core/datastore/memcached v1.0.0 →core/datastore/milvus v1.0.0 →core/datastore/mysql v1.0.0 →core/datastore/mysql-innodb-cluster v1.0.0 →core/datastore/mysql-operator v1.0.0 →core/datastore/opensearch v1.0.0 →core/datastore/pgvector v1.0.0 →core/datastore/postgres v1.0.0 →core/datastore/qdrant v1.0.0 →core/datastore/redis v1.0.0 →core/datastore/timescaledb v1.0.0 →core/datastore/valkey v1.0.0 →core/datastore/weaviate v1.0.0 → - $refmở rộng lược đồ (values)
BaseComponents#/schemas/BaseAgentParameter
Được sử dụng bởi
sử dụng socket «runner»
sử dụng socket «api»
sử dụng socket «runner»
sử dụng socket «api»
sử dụng socket «services»
sử dụng socket «api»
sử dụng socket «services»
sử dụng socket «services»
sử dụng socket «sandbox»
sử dụng socket «plugin_daemon»
sử dụng socket «ssrf_proxy»
sử dụng socket «sandbox»
sử dụng socket «plugin_daemon»
sử dụng socket «ssrf_proxy»
sử dụng socket «api»
sử dụng socket «ssrf_proxy»
sử dụng socket «api»
sử dụng socket «api»
sử dụng socket «sandbox»
sử dụng socket «plugin_daemon»
sử dụng socket «ssrf_proxy»
sử dụng socket «sandbox»
sử dụng socket «plugin_daemon»
sử dụng socket «ssrf_proxy»
sử dụng socket «target_agent»
sử dụng socket «upstream»
sử dụng socket «forward_target»
sử dụng socket «scrape_target»
sử dụng socket «store»
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
triển khai
triển khai
triển khai