Praison AI

Get Started

Deploy with praisonai deploy helm

One command to helm upgrade –install either PraisonAI chart

Install or upgrade either PraisonAI Helm chart with one command that injects the right auth secrets for you.

Diagram

deploy helm

💻 –chart name

🔀 Resolve chart dir

🔐 Inject –set secrets

🚀 helm upgrade –install

Quick Start

  1. Create the auth Secret

    Pre-create the token Secret out-of-band (GitOps-friendly).

    bash
    kubectl create secret generic praisonai-api-auth \
  --from-literal=PRAISONAI_API_TOKEN="$(openssl rand -hex 16)"
  2. Install the chart

    The wrapper runs helm upgrade --install and wires the Secret automatically.

    bash
    praisonai deploy helm --chart agents-api

How It Works

The wrapper resolves the chart directory by alias, injects default --set secret references when you don’t, then shells out to Helm.

Diagram
Helmdeploy helmUserHelmdeploy helmUser–chart agents-apiResolve chart dir (CHART_ALIASES)Add –set auth.existingSecret=… (if none given)helm upgrade –install praisonai <dir> -n defaultRelease upgraded

Command Options

FlagDefaultDescription
--chart(required)Chart name: gateway or agents-api.
--release / -rpraisonaiHelm release name.
--namespace / -ndefaultKubernetes namespace.
--chart-dir(resolved)Override the chart directory.
--install / --no-install--installToggle helm upgrade --install vs. plain upgrade.
--jsonFalseMachine-readable output.

The chart tree can be overridden with PRAISONAI_HELM_ROOT.

Auto-Injected Secrets

When you don’t supply the matching --set flags, the wrapper adds them for you.

--chartInjected --set flags
gatewayauth.existingSecret=praisonai-gateway-auth
agents-apiauth.existingSecret=praisonai-api-auth and postgres.auth.existingSecret=praisonai-postgres-auth

Worked Examples

Create the Secret first, then let the wrapper install the chart.

Gateway

bash
kubectl create secret generic praisonai-gateway-auth \
  --from-literal=GATEWAY_AUTH_TOKEN="$(openssl rand -hex 16)"

praisonai deploy helm --chart gateway

Agents API

bash
kubectl create secret generic praisonai-api-auth \
  --from-literal=PRAISONAI_API_TOKEN="$(openssl rand -hex 16)"
kubectl create secret generic praisonai-postgres-auth \
  --from-literal=password="$(openssl rand -hex 16)"

praisonai deploy helm --chart agents-api

Best Practices

Pre-create Secrets, don't inline tokens

The wrapper references existingSecret names by default. Create those Secrets out-of-band so tokens never land in Git.

Use –no-install to guard existing releases

Pass --no-install to run a plain helm upgrade that fails if the release doesn’t already exist — useful in pipelines that shouldn’t create new releases.

Override the chart dir for local edits

Point --chart-dir at a working copy of the chart to test template changes before publishing.

Related

Helm Chart — Agents API

Every value for the agents-api chart.

 Helm Chart — Gateway

Every value for the gateway chart.