Quickstart

Already have an OpenShift cluster and an LLM endpoint? Three steps and you’re running. No cluster yet? See local CRC setup.

Install the operator

Operators → OperatorHub, search “OpenStack Lightspeed (Community)”, click Install. Currently published for OpenShift 4.16 and 4.18 — on other versions, or if it’s not showing up, see Installation Guide for the source-based alternative.

Create the secret and CR

Save as secret.yaml, with your own LLM API key:

apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: openstack-lightspeed-apitoken
  namespace: openstack-lightspeed
stringData:
  apitoken: <your-llm-api-key>

Save as cr.yaml, with your own endpoint, model, and provider type (see supported providers for valid values):

apiVersion: lightspeed.openstack.org/v1beta1
kind: OpenStackLightspeed
metadata:
  name: openstack-lightspeed
  namespace: openstack-lightspeed
spec:
  defaultModel: my-model
  models:
    - name: my-model
      llmEndpoint: https://<llm-provider-host>:<port>/v1
      llmEndpointType: <provider-type>
      llmCredentials: openstack-lightspeed-apitoken
      modelName: <model-name>

Then apply both:

oc apply -f secret.yaml
oc apply -f cr.yaml

Self-hosted endpoint with a self-signed certificate? See Installation Guide and Configuration for the full field reference. For selecting non-default models in API requests, see Multi-model request routing.

Use the assistant

Goose CLI is the primary supported interface for RHOSO 19 Beta. Wait for OpenStackLightspeed to become Ready before using the assistant. See Usage for available features.