Examples

Explore a comprehensive collection of runnable examples demonstrating every feature from basic chat to advanced multi-agent security policies.

Table of contents

  1. 🌟 Showcase
  2. OpenAI Examples
    1. Gemini
    2. Anthropic
    3. Ollama Examples
    4. DeepSeek Examples
    5. Mistral Examples
    6. OpenRouter Examples
    7. xAI Examples
    8. Amazon Bedrock Examples
    9. MCP Examples

A comprehensive list of runnable examples available in the examples/ directory of the repository.

🌟 Showcase

Example Description
examples/applications/brand-perception-checker/ Brand Perception Auditor — A full-stack (Node+React) app demonstrating multi-provider orchestration, tool calling (Google SERP), and structured output.
examples/applications/hr-chatbot-rag/ HR Chatbot RAG — A production Next.js chatbot featuring @node-llm/orm, streaming, and persistence.
examples/scripts/openai/core/support-agent.mjs Real-world Travel Support AI Agent using Context Isolation, Auto-executing Tools, and Structured Output.
examples/scripts/openai/security/content-policy-hooks.mjs Content Policy & Security using beforeRequest and afterResponse hooks for PII redaction.
examples/scripts/openai/security/tool-policies.mjs Advanced Tool Security using confirm and dry-run modes for human-in-the-loop auditing.

OpenAI Examples

Example Description
examples/scripts/openai/chat/basic.mjs Basic chat with streaming
examples/scripts/openai/chat/events.mjs Lifecycle hooks (onNewMessage, etc)
examples/scripts/openai/chat/tools.mjs Automatic tool execution with the class-based Tool DSL
examples/scripts/openai/chat/raw-json.mjs Defining tools with raw JSON Schema
examples/scripts/openai/chat/tool-choice.mjs Forcing/disabling tool choice
examples/scripts/openai/chat/structured.mjs Zod schema validation
examples/scripts/openai/chat/predicted-outputs.mjs Predicted Outputs for low-latency code edits
examples/scripts/openai/multimodal/vision.mjs Image analysis via URL
examples/scripts/openai/multimodal/files.mjs Analyzing local files
examples/scripts/openai/images/generate.mjs DALL-E 3 Generation
examples/scripts/openai/multimodal/image_edit.mjs In-painting, edits, and variations
examples/scripts/openai/safety/moderation.mjs Custom safety thresholds
examples/scripts/openai/embeddings/create.mjs Creating text embeddings
examples/scripts/openai/chat/usage.mjs Token usage tracking
examples/scripts/openai/chat/parallel-tools.mjs Parallel tool execution
examples/scripts/openai/chat/tool-concurrency.mjs Concurrent tool execution (toolConcurrency)
examples/scripts/openai/chat/callback-stacking.mjs Registering multiple hooks for the same event
examples/scripts/openai/chat/max-tokens.mjs Controlling output length
examples/scripts/openai/chat/streaming-tools.mjs Tool use with streaming
examples/scripts/openai/chat/instructions.mjs System prompt instructions
examples/scripts/openai/chat/reasoning.mjs Reasoning capabilities (o1)
examples/scripts/openai/chat/params.mjs Custom model parameters
examples/scripts/openai/chat/streaming.mjs Advanced streaming examples
examples/scripts/openai/discovery/models.mjs Listing available models
examples/scripts/openai/multimodal/transcribe.mjs Audio transcription
examples/scripts/openai/multimodal/multi-image.mjs Multiple image analysis

Gemini

Anthropic

Ollama Examples

Example Description
examples/scripts/ollama/chat/basic.mjs Local model chat
examples/scripts/ollama/chat/streaming.mjs Streaming local inference
examples/scripts/ollama/chat/tools.mjs Function calling with Llama 3.1
examples/scripts/ollama/multimodal/vision.mjs Multi-modal local analysis
examples/scripts/ollama/embeddings/similarity.mjs Vector similarity search
examples/scripts/ollama/discovery/list.mjs Inspecting local model library

DeepSeek Examples

Mistral Examples

Example Description
examples/scripts/mistral/chat/basic.mjs Basic chat with Mistral Large
examples/scripts/mistral/chat/streaming.mjs Streaming chat responses
examples/scripts/mistral/chat/reasoning.mjs Magistral reasoning with thinking
examples/scripts/mistral/chat/tools.mjs Function calling with Mistral
examples/scripts/mistral/chat/structured.mjs Structured output with Zod
examples/scripts/mistral/embeddings/create.mjs Creating text embeddings
examples/scripts/mistral/multimodal/vision.mjs Image analysis with Pixtral
examples/scripts/mistral/multimodal/transcribe.mjs Audio transcription
examples/scripts/mistral/safety/moderation.mjs Content moderation
examples/scripts/mistral/discovery/models.mjs Listing available models

OpenRouter Examples

Example Description
examples/scripts/openrouter/chat/basic.mjs Multi-model chat gateway
examples/scripts/openrouter/chat/streaming.mjs Unified streaming across 300+ models
examples/scripts/openrouter/chat/tools.mjs Cross-provider function calling
examples/scripts/openrouter/chat/reasoning.mjs Accessing DeepSeek & o1 reasoning
examples/scripts/openrouter/discovery/models.mjs Exploring the global model library
examples/scripts/openrouter/multimodal/vision.mjs Unified vision API for all models
examples/scripts/openrouter/embeddings/create.mjs Aggregated embedding services

xAI Examples

Example Description
examples/scripts/xai/chat/basic.mjs Basic chat with Grok-3
examples/scripts/xai/chat/streaming.mjs Streaming chat responses
examples/scripts/xai/chat/tools.mjs Function calling with Grok
examples/scripts/xai/chat/structured.mjs Structured output with Zod schema
examples/scripts/xai/multimodal/vision.mjs Image analysis with Grok Vision
examples/scripts/xai/images/generate.mjs Image generation with Aurora
examples/scripts/xai/discovery/models.mjs Listing available models

Amazon Bedrock Examples

Example Description
examples/scripts/bedrock/chat/basic.mjs Basic chat via the Converse API
examples/scripts/bedrock/chat/streaming.mjs Streaming chat responses
examples/scripts/bedrock/chat/tools.mjs Function calling
examples/scripts/bedrock/chat/vision.mjs Multimodal vision with Claude/Nova
examples/scripts/bedrock/chat/thinking.mjs Extended thinking (Claude 3.7 / DeepSeek R1)
examples/scripts/bedrock/chat/nova.mjs Amazon Nova model family
examples/scripts/bedrock/chat/guardrails.mjs Guardrail trace assessments
examples/scripts/bedrock/chat/moderation.mjs Standalone moderation via Guardrails
examples/scripts/bedrock/chat/extra_fields.mjs additionalModelRequestFields escape hatch
examples/scripts/bedrock/chat/usage.mjs Token usage tracking
examples/scripts/bedrock/chat/max-tokens.mjs Controlling output length
examples/scripts/bedrock/chat/instructions.mjs System prompt instructions
examples/scripts/bedrock/chat/params.mjs Custom model parameters
examples/scripts/bedrock/embeddings/basic.mjs Titan Embeddings V2
examples/scripts/bedrock/image/titan.mjs Titan Image Generator
examples/scripts/bedrock/discovery/models.mjs Listing available models

MCP Examples

Example Description
examples/scripts/mcp/github/dynamic-github-bridge.ts Connects to GitHub to manage issues, PRs, and repository data
examples/scripts/mcp/filesystem/fs-explorer.ts Reads and summarizes local files within a bounded directory
examples/scripts/mcp/puppeteer/web-browser.ts Autonomous web browsing, clicking, and data extraction

See examples/scripts/mcp/README.md for setup requirements and how to run these with tsx.