Smart AI model cascading for cost optimization

Cost Savings Benchmarks: 69% (MT-Bench), 93% (GSM8K), 52% (MMLU), 80% (TruthfulQA) savings, retaining 96% GPT-5 quality.

Python • TypeScript • LangChain • n8n • Vercel AI • OpenClaw • 📖 Docs • 💡 Examples

Stop Bleeding Money on AI Calls. Cut Costs 30-65% in 3 Lines of Code.

40-70% of text prompts and 20-60% of agent calls don't need expensive flagship models. You're overpaying every single day.

cascadeflow fixes this with intelligent model cascading, available in Python and TypeScript.

pip install cascadeflow

npm install @cascadeflow/core

Why cascadeflow?

cascadeflow is an intelligent AI model cascading library that dynamically selects the optimal model for each query or tool call through speculative execution. It's based on the research that 40-70% of queries don't require slow, expensive flagship models, and domain-specific smaller models often outperform large general-purpose models on specialized tasks. For the remaining queries that need advanced reasoning, cascadeflow automatically escalates to flagship models if needed.

Use Cases

Use cascadeflow for:

Cost Optimization. Reduce API costs by 40-85% through intelligent model cascading and speculative execution with automatic per-query cost tracking.
Cost Control and Transparency. Built-in telemetry for query, model, and provider-level cost tracking with configurable budget limits and programmable spending caps.
Low Latency & Speed Optimization. Sub-2ms framework overhead with fast provider routing (Groq sub-50ms). Cascade simple queries to fast models while reserving expensive models for complex reasoning, achieving 2-10x latency reduction overall. (use preset speed_optimized)
Multi-Provider Flexibility. Unified API across OpenAI, Anthropic, Groq, Ollama, vLLM, Together, and Hugging Face, plus 17+ providers via the Vercel AI SDK with automatic provider detection and zero vendor lock-in. Optional LiteLLM integration for 100+ additional providers, plus LangChain integration for LCEL chains and tools.
Edge & Local-Hosted AI Deployment. Use best of both worlds: handle most queries with local models (vLLM, Ollama), then automatically escalate complex queries to cloud providers only when needed.

ℹ️ Note: SLMs (under 10B parameters) are sufficiently powerful for 60-70% of agentic AI tasks. Research paper

How cascadeflow Works

cascadeflow uses speculative execution with quality validation:

Speculatively executes small, fast models first - optimistic execution ($0.15-0.30/1M tokens)
Validates quality of responses using configurable thresholds (completeness, confidence, correctness)
Dynamically escalates to larger models only when quality validation fails ($1.25-3.00/1M tokens)
Learns patterns to optimize future cascading decisions and domain specific routing

Zero configuration. Works with YOUR existing models (>17 providers currently supported).

In practice, 60-70% of queries are handled by small, efficient models (8-20x cost difference) without requiring escalation

Result: 40-85% cost reduction, 2-10x faster responses, zero quality loss.

┌─────────────────────────────────────────────────────────────┐
│                      cascadeflow Stack                      │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌───────────────────────────────────────────────────────┐  │
│  │  Cascade Agent                                        │  │
│  │                                                       │  │
│  │  Orchestrates the entire cascade execution            │  │
│  │  • Query routing & model selection                    │  │
│  │  • Drafter -> Verifier coordination                   │  │
│  │  • Cost tracking & telemetry                          │  │
│  └───────────────────────────────────────────────────────┘  │
│                          ↓                                  │
│  ┌───────────────────────────────────────────────────────┐  │
│  │  Domain Pipeline                                      │  │
│  │                                                       │  │
│  │  Automatic domain classification                      │  │
│  │  • Rule-based detection (CODE, MATH, DATA, etc.)      │  │
│  │  • Optional ML semantic classification                │  │
│  │  • Domain-optimized pipelines & model selection       │  │
│  └───────────────────────────────────────────────────────┘  │
│                          ↓                                  │
│  ┌───────────────────────────────────────────────────────┐  │
│  │  Quality Validation Engine                            │  │
│  │                                                       │  │
│  │  Multi-dimensional quality checks                     │  │
│  │  • Length validation (too short/verbose)              │  │
│  │  • Confidence scoring (logprobs analysis)             │  │
│  │  • Format validation (JSON, structured output)        │  │
│  │  • Semantic alignment (intent matching)               │  │
│  └───────────────────────────────────────────────────────┘  │
│                          ↓                                  │
│  ┌───────────────────────────────────────────────────────┐  │
│  │  Cascading Engine (<2ms overhead)                     │  │
│  │                                                       │  │
│  │  Smart model escalation strategy                      │  │
│  │  • Try cheap models first (speculative execution)     │  │
│  │  • Validate quality instantly                         │  │
│  │  • Escalate only when needed                          │  │
│  │  • Automatic retry & fallback                         │  │
│  └───────────────────────────────────────────────────────┘  │
│                          ↓                                  │
│  ┌───────────────────────────────────────────────────────┐  │
│  │  Provider Abstraction Layer                           │  │
│  │                                                       │  │
│  │  Unified interface for >17 providers                   │  │
│  │  • OpenAI • Anthropic • Groq • Ollama                 │  │
│  │  • Together • vLLM • HuggingFace • LiteLLM            │  │
│  │  • Vercel AI SDK (17+ additional providers)            │  │
│  └───────────────────────────────────────────────────────┘  │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Quick Start

Drop-In Gateway (Existing Apps)

If you already have an app using the OpenAI or Anthropic APIs and want the fastest integration, run the gateway and point your existing client at it:

python -m cascadeflow.server --mode auto --port 8084

Docs: docs/guides/gateway.md

Python

pip install cascadeflow[all]

from cascadeflow import CascadeAgent, ModelConfig

# Define your cascade - try cheap model first, escalate if needed
agent = CascadeAgent(models=[
    ModelConfig(name="gpt-4o-mini", provider="openai", cost=0.000375),  # Draft model (~$0.375/1M tokens)
    ModelConfig(name="gpt-5", provider="openai", cost=0.00562),         # Verifier model (~$5.62/1M tokens)
])

# Run query - automatically routes to optimal model
result = await agent.run("What's the capital of France?")

print(f"Answer: {result.content}")
print(f"Model used: {result.model_used}")
print(f"Cost: ${result.total_cost:.6f}")

💡 Optional: Use ML-based Semantic Quality Validation

For advanced use cases, you can add ML-based semantic similarity checking to validate that responses align with queries.

Step 1: Install the optional ML package:

pip install cascadeflow[semantic]  # Adds semantic similarity via FastEmbed (~80MB model)

Step 2: Use semantic quality validation:

from cascadeflow.quality.semantic import SemanticQualityChecker

# Initialize semantic checker (downloads model on first use)
checker = SemanticQualityChecker(
    similarity_threshold=0.5,  # Minimum similarity score (0-1)
    toxicity_threshold=0.7     # Maximum toxicity score (0-1)
)

# Validate query-response alignment
query = "Explain Python decorators"
response = "Decorators are a way to modify functions using @syntax..."

result = checker.validate(query, response, check_toxicity=True)

print(f"Similarity: {result.similarity:.2%}")
print(f"Passed: {result.passed}")
print(f"Toxic: {result.is_toxic}")

What you get:

🎯 Semantic similarity scoring (query ↔ response alignment)
🛡️ Optional toxicity detection
🔄 Automatic model download and caching
🚀 Fast inference (~100ms per check)

Full example: See semantic_quality_domain_detection.py

⚠️ GPT-5 Note: GPT-5 streaming requires organization verification. Non-streaming works for all users. Verify here if needed (~15 min). Basic cascadeflow examples work without - GPT-5 is only called when needed (typically 20-30% of requests).

📖 Learn more: Python Documentation | Quickstart Guide | Providers Guide

TypeScript

npm install @cascadeflow/core

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

// Same API as Python!
const agent = new CascadeAgent({
  models: [
    { name: 'gpt-4o-mini', provider: 'openai', cost: 0.000375 },
    { name: 'gpt-4o', provider: 'openai', cost: 0.00625 },
  ],
});

const result = await agent.run('What is TypeScript?');
console.log(`Model: ${result.modelUsed}`);
console.log(`Cost: $${result.totalCost}`);
console.log(`Saved: ${result.savingsPercentage}%`);

💡 Optional: ML-based Semantic Quality Validation

For advanced quality validation, enable ML-based semantic similarity checking to ensure responses align with queries.

Step 1: Install the optional ML packages:

npm install @cascadeflow/ml @xenova/transformers

Step 2: Enable semantic validation in your cascade:

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

const agent = new CascadeAgent({
  models: [
    { name: 'gpt-4o-mini', provider: 'openai', cost: 0.000375 },
    { name: 'gpt-4o', provider: 'openai', cost: 0.00625 },
  ],
  quality: {
    threshold: 0.40,                    // Traditional confidence threshold
    requireMinimumTokens: 5,            // Minimum response length
    useSemanticValidation: true,        // Enable ML validation
    semanticThreshold: 0.5,             // 50% minimum similarity
  },
});

// Responses now validated for semantic alignment
const result = await agent.run('Explain TypeScript generics');

Step 3: Or use semantic validation directly:

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

const checker = new SemanticQualityChecker();

if (await checker.isAvailable()) {
  const result = await checker.checkSimilarity(
    'What is TypeScript?',
    'TypeScript is a typed superset of JavaScript.'
  );

  console.log(`Similarity: ${(result.similarity * 100).toFixed(1)}%`);
  console.log(`Passed: ${result.passed}`);
}

What you get:

🎯 Query-response semantic alignment detection
🚫 Off-topic response filtering
📦 BGE-small-en-v1.5 embeddings (~40MB, auto-downloads)
⚡ Fast CPU inference (~50-100ms with caching)
🔄 Request-scoped caching (50% latency reduction)
🌐 Works in Node.js, Browser, and Edge Functions

Example: semantic-quality.ts

📖 Learn more: TypeScript Documentation | Quickstart Guide | Node.js Examples | Browser/Edge Guide

🔄 Migration Example

Migrate in 5min from direct Provider implementation to cost savings and full cost control and transparency.

Before (Standard Approach)

Cost: $0.000113, Latency: 850ms

# Using expensive model for everything
result = openai.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "What's 2+2?"}]
)

After (With cascadeflow)

Cost: $0.000007, Latency: 234ms

agent = CascadeAgent(models=[
    ModelConfig(name="gpt-4o-mini", provider="openai", cost=0.000375),
    ModelConfig(name="gpt-4o", provider="openai", cost=0.00625),
])

result = await agent.run("What's 2+2?")

🔥 Saved: $0.000106 (94% reduction), 3.6x faster

📊 Learn more: Cost Tracking Guide | Production Best Practices | Performance Optimization

n8n Integration

Use cascadeflow in n8n workflows for no-code AI automation with automatic cost optimization!

Installation

Open n8n
Go to Settings → Community Nodes
Search for: @cascadeflow/n8n-nodes-cascadeflow
Click Install

Two Nodes

Node	Type	Use case
CascadeFlow (Model)	Language Model sub-node	Drop-in for any Chain/LLM node
CascadeFlow Agent	Standalone agent (`main` in/out)	Tool calling, memory, multi-step reasoning

Quick Start (Model):

Add two AI Chat Model nodes (cheap drafter + powerful verifier)
Add CascadeFlow (Model) and connect both models
Connect to Basic LLM Chain or Chain node
Check Logs tab on the Chain node to see cascade decisions

Quick Start (Agent):

Add a Chat Trigger node
Add CascadeFlow Agent and connect it to the trigger
Connect Drafter, Verifier, optional Memory and Tools
Check the Agent Output tab for cascade metadata and trace

Result: 40-85% cost savings in your n8n workflows!

Features:

Works with any AI Chat Model node (OpenAI, Anthropic, Ollama, Azure, etc.)
Mix providers (e.g., Ollama drafter + GPT-4o verifier)
Agent node: tool calling, memory, per-tool routing, tool call validation
16-domain cascading for specialized model routing
Real-time flow visualization in Logs/Output tabs

🔌 Learn more: n8n Integration Guide | n8n Documentation

LangChain Integration

Use cascadeflow with LangChain for intelligent model cascading with full LCEL, streaming, and tools support!

Installation

TypeScript

npm install @cascadeflow/langchain @langchain/core @langchain/openai

Python

pip install cascadeflow langchain-openai

Quick Start

TypeScript - Drop-in replacement for any LangChain chat model

import { ChatOpenAI } from '@langchain/openai';
import { ChatAnthropic } from '@langchain/anthropic';
import { withCascade } from '@cascadeflow/langchain';

const cascade = withCascade({
  drafter: new ChatOpenAI({ model: 'gpt-4o-mini' }),      // $0.15/$0.60 per 1M tokens
  verifier: new ChatAnthropic({ model: 'claude-sonnet-4-5' }),  // $3/$15 per 1M tokens
  qualityThreshold: 0.8, // 80% queries use drafter
});

// Use like any LangChain chat model
const result = await cascade.invoke('Explain quantum computing');

// Optional: Enable LangSmith tracing (see https://smith.langchain.com)
// Set LANGSMITH_API_KEY, LANGSMITH_PROJECT, LANGSMITH_TRACING=true

// Or with LCEL chains
const chain = prompt.pipe(cascade).pipe(new StringOutputParser());

Python - Drop-in replacement for any LangChain chat model

from langchain_openai import ChatOpenAI
from langchain_anthropic import ChatAnthropic
from cascadeflow.integrations.langchain import CascadeFlow

cascade = CascadeFlow(
    drafter=ChatOpenAI(model="gpt-4o-mini"),      # $0.15/$0.60 per 1M tokens
    verifier=ChatAnthropic(model="claude-sonnet-4-5"),  # $3/$15 per 1M tokens
    quality_threshold=0.8,  # 80% queries use drafter
)

# Use like any LangChain chat model
result = await cascade.ainvoke("Explain quantum computing")

# Optional: Enable LangSmith tracing (see https://smith.langchain.com)
# Set LANGSMITH_API_KEY, LANGSMITH_PROJECT, LANGSMITH_TRACING=true

# Or with LCEL chains
chain = prompt | cascade | StrOutputParser()

💡 Optional: Cost Tracking with Callbacks (Python)

Track costs, tokens, and cascade decisions with LangChain-compatible callbacks:

from cascadeflow.integrations.langchain.langchain_callbacks import get_cascade_callback

# Track costs similar to get_openai_callback()
with get_cascade_callback() as cb:
    response = await cascade.ainvoke("What is Python?")

    print(f"Total cost: ${cb.total_cost:.6f}")
    print(f"Drafter cost: ${cb.drafter_cost:.6f}")
    print(f"Verifier cost: ${cb.verifier_cost:.6f}")
    print(f"Total tokens: {cb.total_tokens}")
    print(f"Successful requests: {cb.successful_requests}")

Features:

🎯 Compatible with get_openai_callback() pattern
💰 Separate drafter/verifier cost tracking
📊 Token usage (including streaming)
🔄 Works with LangSmith tracing
⚡ Near-zero overhead

Full example: See langchain_cost_tracking.py

💡 Optional: Model Discovery & Analysis Helpers (TypeScript)

For discovering optimal cascade pairs from your existing LangChain models, use the built-in discovery helpers:

import {
  discoverCascadePairs,
  findBestCascadePair,
  analyzeModel,
  validateCascadePair
} from '@cascadeflow/langchain';

// Your existing LangChain models (configured with YOUR API keys)
const myModels = [
  new ChatOpenAI({ model: 'gpt-3.5-turbo' }),
  new ChatOpenAI({ model: 'gpt-4o-mini' }),
  new ChatOpenAI({ model: 'gpt-4o' }),
  new ChatAnthropic({ model: 'claude-3-haiku' }),
  // ... any LangChain chat models
];

// Quick: Find best cascade pair
const best = findBestCascadePair(myModels);
console.log(`Best pair: ${best.analysis.drafterModel} → ${best.analysis.verifierModel}`);
console.log(`Estimated savings: ${best.estimatedSavings}%`);

// Use it immediately
const cascade = withCascade({
  drafter: best.drafter,
  verifier: best.verifier,
});

// Advanced: Discover all valid pairs
const pairs = discoverCascadePairs(myModels, {
  minSavings: 50,              // Only pairs with ≥50% savings
  requireSameProvider: false,  // Allow cross-provider cascades
});

// Validate specific pair
const validation = validateCascadePair(drafter, verifier);
console.log(`Valid: ${validation.valid}`);
console.log(`Warnings: ${validation.warnings}`);

What you get:

🔍 Automatic discovery of optimal cascade pairs from YOUR models
💰 Estimated cost savings calculations
⚠️ Validation warnings for misconfigured pairs
📊 Model tier analysis (drafter vs verifier candidates)

Full example: See model-discovery.ts

Features:

✅ Full LCEL support (pipes, sequences, batch)
✅ Streaming with pre-routing
✅ Tool calling and structured output
✅ LangSmith cost tracking metadata
✅ Cost tracking callbacks (Python)
✅ Works with all LangChain features

🦜 Learn more: LangChain Integration Guide | TypeScript Package | Python Examples

Resources

Examples

Python Examples:

Basic Examples - Get started quickly

Example	Description	Link
Basic Usage	Simple cascade setup with OpenAI models	View
Preset Usage	Use built-in presets for quick setup	View
Multi-Provider	Mix multiple AI providers in one cascade	View
Reasoning Models	Use reasoning models (o1/o3, Claude Sonnet 4, DeepSeek-R1)	View
Tool Execution	Function calling and tool usage	View
Streaming Text	Stream responses from cascade agents	View
Cost Tracking	Track and analyze costs across queries	View
Agentic Multi-Agent	Multi-turn tool loops & agent-as-a-tool delegation	View

Advanced Examples - Production & customization

Example	Description	Link
Production Patterns	Best practices for production deployments	View
FastAPI Integration	Integrate cascades with FastAPI	View
Streaming Tools	Stream tool calls and responses	View
Batch Processing	Process multiple queries efficiently	View
Multi-Step Cascade	Build complex multi-step cascades	View
Edge Device	Run cascades on edge devices with local models	View
vLLM Example	Use vLLM for local model deployment	View
Multi-Instance Ollama	Run draft/verifier on separate Ollama instances	View
Multi-Instance vLLM	Run draft/verifier on separate vLLM instances	View
Custom Cascade	Build custom cascade strategies	View
Custom Validation	Implement custom quality validators	View
User Budget Tracking	Per-user budget enforcement and tracking	View
User Profile Usage	User-specific routing and configurations	View
Rate Limiting	Implement rate limiting for cascades	View
Guardrails	Add safety and content guardrails	View
Cost Forecasting	Forecast costs and detect anomalies	View
Semantic Quality Detection	ML-based domain and quality detection	View
Profile Database Integration	Integrate user profiles with databases	View
LangChain Basic	Simple LangChain cascade setup	View
LangChain Streaming	Stream responses with LangChain	View
LangChain Model Discovery	Discover and analyze LangChain models	View
LangChain LangSmith	Cost tracking with LangSmith integration	View
LangChain Cost Tracking	Track costs with callback handlers	View
LangChain LCEL Pipeline	LCEL chains with cascade routing	View
LangGraph Multi-Agent	LangGraph multi-agent orchestration	View

TypeScript Examples:

Basic Examples - Get started quickly

Example	Description	Link
Basic Usage	Simple cascade setup (Node.js)	View
Tool Calling	Function calling with tools (Node.js)	View
Multi-Provider	Mix providers in TypeScript (Node.js)	View
Reasoning Models	Use reasoning models (o1/o3, Claude Sonnet 4, DeepSeek-R1)	View
Cost Tracking	Track and analyze costs across queries	View
Semantic Quality	ML-based semantic validation with embeddings	View
Streaming	Stream responses in TypeScript	View
Tool Execution	Tool execution engine and result handling	View
Streaming Tools	Stream tool calls with event detection	View
Agentic Multi-Agent	Multi-turn tool loops & multi-agent orchestration	View

Advanced Examples - Production, edge & LangChain

Example	Description	Link
Production Patterns	Production best practices (Node.js)	View
Multi-Instance Ollama	Run draft/verifier on separate Ollama instances	View
Multi-Instance vLLM	Run draft/verifier on separate vLLM instances	View
Browser/Edge	Vercel Edge runtime example	View
LangChain Basic	Simple LangChain cascade setup	View
LangChain Cross-Provider	Haiku → GPT-5 with PreRouter	View
LangChain LangSmith	Cost tracking with LangSmith	View
LangChain Cost Tracking	Compare cascadeflow vs LangSmith cost tracking	View
LangGraph Multi-Agent	LangGraph multi-agent orchestration	View
LangChain Tool Risk Gating	Tool routing based on risk and complexity	View

📂 View All Python Examples → | View All TypeScript Examples →

Documentation

Getting Started - Core concepts and basics

Guide	Description	Link
Quickstart	Get started with cascadeflow in 5 minutes	Read
Providers Guide	Configure and use different AI providers	Read
Presets Guide	Using and creating custom presets	Read
Streaming Guide	Stream responses from cascade agents	Read
Tools Guide	Function calling and tool usage	Read
Cost Tracking	Track and analyze API costs	Read
Agentic Patterns (Python)	Tool loops, multi-agent, agent-as-a-tool delegation	Read
Agentic Patterns (TypeScript)	Tool loops, multi-agent orchestration	Read
Gateway Guide	Drop-in OpenAI/Anthropic-compatible server	Read

Advanced Topics - Production, customization & integrations

Guide	Description	Link
Production Guide	Best practices for production deployments	Read
Performance Guide	Optimize cascade performance and latency	Read
Custom Cascade	Build custom cascade strategies	Read
Custom Validation	Implement custom quality validators	Read
Edge Device	Deploy cascades on edge devices	Read
Browser Cascading	Run cascades in the browser/edge	Read
FastAPI Integration	Integrate with FastAPI applications	Read
LangChain Integration	Use cascadeflow with LangChain	Read
n8n Integration	Use cascadeflow in n8n workflows	Read
Local Providers	Ollama & vLLM self-hosted deployment	Read
OpenClaw Provider	OpenClaw custom provider setup	Read
Enterprise Guide	Enterprise deployments and configuration	Read
Quick Integration	Integrate cascadeflow fast	Read
User Budget Tracking	Per-user cost limits and budgets	Read
Proxy Routing	Provider-aware proxy routing	Read

📚 View All Documentation →

Features

Feature	Benefit
🎯 Speculative Cascading	Tries cheap models first, escalates intelligently
💰 40-85% Cost Savings	Research-backed, proven in production
⚡ 2-10x Faster	Small models respond in <50ms vs 500-2000ms
⚡ Low Latency	Sub-2ms framework overhead, negligible performance impact
🔄 Mix Any Providers	OpenAI, Anthropic, Groq, Ollama, vLLM, Together + LiteLLM (optional) + LangChain integration
👤 User Profile System	Per-user budgets, tier-aware routing, enforcement callbacks
✅ Quality Validation	Automatic checks + semantic similarity (optional ML, ~80MB, CPU)
🎨 Cascading Policies	Domain-specific pipelines, multi-step validation strategies
🧠 Domain Understanding	15 domains auto-detected (code, medical, legal, finance, math, etc.), routes to specialists
🤖 Drafter/Validator Pattern	20-60% savings for agent/tool systems
🔧 Tool Calling Support	Universal format, works across all providers
📊 Cost Tracking	Built-in analytics + OpenTelemetry export (vendor-neutral)
🚀 3-Line Integration	Zero architecture changes needed
🔁 Agent Loops	Multi-turn tool execution with automatic tool call, result, re-prompt cycles
📋 Message & Tool Call Lists	Full conversation history with tool_calls and tool_call_id preservation across turns
🪝 Hooks & Callbacks	Telemetry callbacks, cost events, and streaming hooks for observability
🏭 Production Ready	Streaming, batch processing, tool handling, reasoning model support, caching, error recovery, anomaly detection

License

Free for commercial use. Attribution appreciated but not required.

Contributing

We ❤️ contributions!

📝 Contributing Guide - Python & TypeScript development setup

Recently Shipped

✅ Agent Loops & Multi-Agent - Multi-turn tool execution, agent-as-a-tool delegation, LangGraph orchestration
✅ Tool Execution Engine - Automatic tool call routing, parallel execution, risk gating
✅ Hooks & Callbacks - Telemetry callbacks, cost events, streaming hooks for observability
✅ Vercel AI SDK Integration - 17+ additional providers with automatic provider detection
✅ OpenClaw Provider - Custom provider for OpenClaw deployments
✅ Gateway Server - Drop-in OpenAI/Anthropic-compatible proxy endpoint
✅ User Tier Management - Cost controls and limits per user tier with advanced routing
✅ Semantic Quality Validators - Lightweight local quality scoring via FastEmbed
✅ Code Complexity Detection - Dynamic cascading based on task complexity analysis
✅ Domain Aware Cascading - ML-based semantic domain detection with per-domain routing
✅ Benchmark Reports - Automated benchmarking (MMLU, GSM8K, MT-Bench, HumanEval, TruthfulQA)

Support

📖 GitHub Discussions - Searchable Q&A
🐛 GitHub Issues - Bug reports & feature requests
📧 Email Support - Direct support

Citation

If you use cascadeflow in your research or project, please cite:

@software{cascadeflow2025,
  author = {Lemony Inc., Sascha Buehrle and Contributors},
  title = {cascadeflow: Smart AI model cascading for cost optimization},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/lemony-ai/cascadeflow}
}

Ready to cut your AI costs by 40-85%?

pip install cascadeflow

npm install @cascadeflow/core

Read the Docs • View Python Examples • View TypeScript Examples • Join Discussions

About

Built with ❤️ by Lemony Inc. and the cascadeflow Community

One cascade. Hundreds of specialists.

New York | Zurich

⭐ Star us on GitHub if cascadeflow helps you save money!

Name		Name	Last commit message	Last commit date
Latest commit History 436 Commits
.github		.github
cascadeflow		cascadeflow
docs		docs
examples		examples
packages		packages
scripts		scripts
tests		tests
.env.example		.env.example
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
MANIFEST.in		MANIFEST.in
README.md		README.md
SECURITY.md		SECURITY.md
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
pyproject.toml		pyproject.toml
requirements-dev.txt		requirements-dev.txt
requirements.txt		requirements.txt
turbo.json		turbo.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Smart AI model cascading for cost optimization

Why cascadeflow?

Use Cases

How cascadeflow Works

Quick Start

Drop-In Gateway (Existing Apps)

Python

TypeScript

🔄 Migration Example

Before (Standard Approach)

After (With cascadeflow)

n8n Integration

Installation

Two Nodes

LangChain Integration

Installation

Quick Start

Resources

Examples

Documentation

Features

License

Contributing

Recently Shipped

Support

Citation

About

About

Uh oh!

Releases 10

Contributors 3

Uh oh!

Languages

License

lemony-ai/cascadeflow

Folders and files

Latest commit

History

Repository files navigation

Smart AI model cascading for cost optimization

Why cascadeflow?

Use Cases

How cascadeflow Works

Quick Start

Drop-In Gateway (Existing Apps)

Python

TypeScript

🔄 Migration Example

Before (Standard Approach)

After (With cascadeflow)

n8n Integration

Installation

Two Nodes

LangChain Integration

Installation

Quick Start

Resources

Examples

Documentation

Features

License

Contributing

Recently Shipped

Support

Citation

About

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 10

Contributors 3

Uh oh!

Languages