Skip to main content
Use this page when cascadeflow needs to run inside enterprise networking constraints like proxies, custom CA bundles, or corporate PKI.

Zero-Config First

cascadeflow automatically detects common enterprise environment variables:
VariablePurpose
HTTPS_PROXY, HTTP_PROXYProxy configuration
SSL_CERT_FILECustom CA certificate bundle
REQUESTS_CA_BUNDLE, CURL_CA_BUNDLEAlternate CA bundle paths
NO_PROXYBypass rules

Explicit HTTP Configuration

For explicit control, use HttpConfig in Python or httpConfig in TypeScript.

Python

from cascadeflow import CascadeAgent, ModelConfig, HttpConfig

agent = CascadeAgent(
    models=[
        ModelConfig(
            name="gpt-4o",
            provider="openai",
            cost=0.00625,
            http_config=HttpConfig(
                proxy="http://proxy.corp.example.com:8080",
                ca_cert_path="/path/to/corporate-ca.pem",
                verify_ssl=True,
                timeout=60.0,
            ),
        ),
    ],
)

TypeScript

import { CascadeAgent } from '@cascadeflow/core';

const agent = new CascadeAgent({
  models: [
    {
      name: 'gpt-4o',
      provider: 'openai',
      cost: 0.00625,
      httpConfig: {
        proxy: 'http://proxy.corp.example.com:8080',
        caCertPath: '/path/to/corporate-ca.pem',
        verifySsl: true,
        timeout: 60000,
      },
    },
  ],
});

Enterprise Guidance

  • Prefer CA bundles over disabling SSL verification.
  • Keep proxy credentials out of source code.
  • Treat network configuration as deployment config, not app logic.

Deep Guide