VernLLM - lightweight resilience layer for OpenAI SDK

LakBud — Mon, 20 Jul 2026 21:20:29 +0000

Introducing vernLLM: A Resilience Layer for LLM Applications

Building production-ready LLM applications is not just about sending prompts and receiving responses. Real-world AI systems need to handle timeouts, provider failures, rate limits, inconsistent outputs, and reliability issues.

That is where vernLLM comes in.

vernLLM is a lightweight resilience layer for OpenAI-compatible chat completion APIs, providing a single interface with built-in retries, timeouts, circuit breaking, caching, structured output, and usage tracking.

Instead of rebuilding the same reliability features for every LLM project, vernLLM gives you the tools needed to make your AI integrations more robust from the start.

Features

Automatic retries with backoff

Transient failures happen. vernLLM automatically retries recoverable errors while failing fast on validation errors and non-retryable responses.

Timeouts & cancellation

Prevent hanging requests with configurable timeouts and cancellation support.

Circuit breaker protection

Automatically stop sending requests to failing providers and recover when the service becomes healthy again.

Structured output with type safety

Pass a Zod schema and receive validated, typed results back.

const result = await llm.call({
  systemPrompt: 'Return JSON: { "skills": string[] }',
  userContent: 'Extract skills from: ...',
  schema: SkillsSchema // zod schema
});

Provider-native JSON Schema support

Constrain model generation itself instead of only validating responses afterward.

Built-in caching support

Cache LLM responses using your own cache adapter with cachedCall and cachedLLMCall.

One interface across providers

Use the same API across multiple providers:

OpenAI
Groq
Mistral
DeepSeek
Cerebras
Together AI
Fireworks AI
Ollama
Anthropic
Gemini
AWS Bedrock
Any HTTP-compatible provider through fromFetch

Why vernLLM?

Many LLM applications end up creating their own wrappers around provider SDKs to handle:

retry logic
API failures
provider switching
response validation
caching
monitoring

vernLLM packages these patterns into a reusable, lightweight library so developers can focus on building AI features instead of maintaining infrastructure.

Quick Start

Install:

pnpm add vern-llm openai

Create your client:

import OpenAI from 'openai';
import { VernLLM } from 'vern-llm';

export const llm = new VernLLM({
  client: new OpenAI({ apiKey: process.env.OPENAI_API_KEY }),
  model: 'gpt-4o',

  maxRetries: 3,
  timeoutMs: 10_000,
  circuitBreaker: true,

  onUsage: ({ totalTokens }) => {
    console.log(`Used ${totalTokens} tokens`);
  },
});


// now do something with it!
export const summary = await llm.cachedLLMCall({
  cacheKey: `resume:${resumeId}`,
  ttl: 3600,
  call: {
    systemPrompt: 'Analyze this resume and return structured hiring insights.',
    userContent: resumeText,
    schema: HiringSummarySchema, // Zod schema
  }
});

Built for Production

vernLLM is designed with production usage in mind:

Zero bundled dependencies
TypeScript-first API
Provider adapters
Extensive test coverage
MIT licensed

Whether you are building AI agents, document processing pipelines, chat applications, or LLM-powered tools, vernLLM provides the reliability layer needed to ship with confidence.

Learn More

Documentation: https://vernllm.vercel.app/

GitHub: https://github.com/LakBud/vernLLM

Contributions, feedback, and ideas are welcome!

DEV Community: LakBud

[Boost]