---
id: langchain-openrouter
version: "0.2.8"
license: MIT
license_treatment: permissive
maintenance: active
---

# langchain-openrouter — An integration package connecting OpenRouter and LangChain

License: permissive · Maintenance: active · Downloads: 567.3K/mo

## What it is and what it does

langchain-openrouter is a LangChain integration that bridges your LangChain application to OpenRouter, a unified API for accessing hundreds of AI models from many providers. Instead of managing separate connections to different model providers, you point LangChain to OpenRouter and let it handle routing to the underlying models. The package wraps OpenRouter's API in LangChain's standard model interfaces, so you can swap models or providers by changing a configuration string rather than rewriting application code.

It depends on langchain-core (LangChain's base abstractions) and openrouter (the direct Python client for OpenRouter). The package is in Beta status, actively maintained, and supports Python 3.10 through 3.14. It carries no known security vulnerabilities and uses a permissive MIT license.

Use it for:

- Build a chatbot that can switch between different AI models (GPT, Claude, Llama, etc.) without changing application logic.
- Prototype LangChain agents with multiple model providers to compare quality and cost without rewriting integration code.
- Deploy a production service that routes requests to different models based on availability, cost, or performance tiers via OpenRouter.
- Evaluate different models on the same task by iterating over model names in a LangChain pipeline.
- Reduce vendor lock-in by abstracting model selection through a single, provider-agnostic API layer.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Connects LangChain applications to OpenRouter, a unified API gateway for hundreds of AI models across multiple providers, enabling model selection and switching without changing application code.

Yes. This is a straightforward, low-friction integration for LangChain users who want to access OpenRouter's multi-provider model catalog. It has no security vulnerabilities, active maintenance, permissive licensing, and minimal dependencies. Install it if you're building with LangChain and want the flexibility to choose from hundreds of models without rewriting your code.

## Install

pip install langchain-openrouter
uv add langchain-openrouter
poetry add langchain-openrouter

## Installing langchain-openrouter

Before you install: Low friction: pure Python wheel with only two runtime dependencies (langchain-core and openrouter). Actively maintained with a recent release and no known vulnerabilities.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely in commercial or private projects with minimal restrictions.

Quickstart:

pip install langchain-openrouter

from langchain_openrouter import ChatOpenRouter

model = ChatOpenRouter(model="openrouter/auto")
response = model.invoke("Hello, world!")

Requires Python 3.10 or later; you must have an OpenRouter API key configured (typically via OPENROUTER_API_KEY environment variable).

Verify before relying:

- Whether the package handles model fallback or error recovery when a requested model is unavailable on OpenRouter.
- Performance characteristics and latency overhead compared to direct OpenRouter or LangChain calls.
- Which specific OpenRouter features (routing logic, pricing tiers, rate limiting) are exposed through the LangChain integration.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 567.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

langchain openrouter integration, unified ai model api gateway, multi-provider language model access, openrouter langchain connector, switch ai models without code changes, hundreds of models single api, langchain model provider abstraction, langchain-integration, model-abstraction, multi-provider

[View on SkillFed](https://skillfed.io/packages/langchain-openrouter) · [View on PyPI](https://pypi.org/project/langchain-openrouter/)