HELM AI Kernel Examples Matrix

This page is for developers choosing the shortest source-backed example for a language, framework, receipt, MCP, OpenTelemetry, or policy workflow. The outcome is a runnable example path, the server mode it expects, and the validation command that proves the public docs claim.

Audience

This page is for developers who need to pick a runnable source-backed example for HELM AI Kernel rather than infer support from a language name or integration slogan.

Outcome

After this page you should know which example to run, which HELM server mode it expects, what output proves success, and which command validates the claim.

Source Truth

Example source lives under examples. SDK package docs live under sdk. Deployment examples are separated into deploy and the Kubernetes chart at deploy/helm-chart.

Example Flow

flowchart TD
    subgraph Ingestion["1. Ingestion & Context Plane"]
        Reader["developer"]
        Pick["choose example"]
        Server["start helm-ai-kernel serve or helm-ai-kernel proxy"]
    end

    subgraph Evaluation["2. Evaluation & Policy Plane"]
        Gate["docs and example validation"]
    end

    subgraph Execution["3. Execution & Verdict Plane"]
        Run["run language/framework code"]
    end

    subgraph Ledger["4. Tamper-Evident Ledger Plane"]
        Receipt["capture receipt or decision"]
        Verify["verify receipt/EvidencePack"]
    end

    %% Operational Flow Edges
    Reader --> Pick
    Pick --> Server
    Server --> Run
    Run --> Receipt
    Receipt --> Verify
    Verify --> Gate

    %% Premium Styling Rules
    style Run fill:#3182ce,stroke:#2b6cb0,stroke-width:2px,color:#fff
    style Receipt fill:#2f855a,stroke:#276749,stroke-width:2px,color:#fff
    style Verify fill:#2f855a,stroke:#276749,stroke-width:2px,color:#fff
    style Gate fill:#2d3748,stroke:#4a5568,stroke-width:2px,color:#fff

flowchart TD
    subgraph Ingestion["1. Ingestion & Context Plane"]
        Reader["developer"]
        Pick["choose example"]
        Server["start helm-ai-kernel serve or helm-ai-kernel proxy"]
    end

    subgraph Evaluation["2. Evaluation & Policy Plane"]
        Gate["docs and example validation"]
    end

    subgraph Execution["3. Execution & Verdict Plane"]
        Run["run language/framework code"]
    end

    subgraph Ledger["4. Tamper-Evident Ledger Plane"]
        Receipt["capture receipt or decision"]
        Verify["verify receipt/EvidencePack"]
    end

    %% Operational Flow Edges
    Reader --> Pick
    Pick --> Server
    Server --> Run
    Run --> Receipt
    Receipt --> Verify
    Verify --> Gate

    %% Premium Styling Rules
    style Run fill:#3182ce,stroke:#2b6cb0,stroke-width:2px,color:#fff
    style Receipt fill:#2f855a,stroke:#276749,stroke-width:2px,color:#fff
    style Verify fill:#2f855a,stroke:#276749,stroke-width:2px,color:#fff
    style Gate fill:#2d3748,stroke:#4a5568,stroke-width:2px,color:#fff

Runnable Matrix

Common Environment

export HELM_URL=http://127.0.0.1:7714
export HELM_PROXY_BASE_URL=http://127.0.0.1:9090/v1
export OPENAI_API_KEY="${OPENAI_API_KEY:?set upstream key when proxying}"

Examples may also use framework-native baseURL or base_url options. Prefer the variable names used inside the example README or code; do not invent a new variable in public docs without adding it to the example.

Expected Output

Every runnable example should produce at least one of these observable outputs:

• an HTTP response from HELM instead of the upstream provider;
• a receipt header or receipt file under the configured receipts directory;
• a deny decision and denial receipt for the blocked-path test;
• a verifier or conformance command that exits zero.

Troubleshooting

Not Covered

This page does not claim support for languages or frameworks that lack source, an example, or an SDK README. Planned examples must remain out of public support tables until code and validation exist.