# @langchain/classic

> Old abstractions from LangChain.js

Latest version **1.0.48** (published 2026-09-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install @langchain/classic
pnpm add @langchain/classic
yarn add @langchain/classic
bun add @langchain/classic
```

## Health

**Score 80/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.0.48 |
| Published | 2026-09-12 |
| First published | 2025-10-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20 |
| Dependencies | 8 |
| Unpacked size | 5.6 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 18197 |
| Author | LangChain |
| Maintainers | lc-oss-admin, langchain-security |
| Keywords | llm, ai, gpt3, chain, prompt, prompt engineering, chatgpt, machine learning, ml, openai, embeddings, vectorstores |

## Links

- npm: https://www.npmjs.com/package/@langchain/classic
- Repository: https://github.com/langchain-ai/langchainjs
- Homepage: https://github.com/langchain-ai/langchainjs/tree/main/langchain/
- Issues: https://github.com/langchain-ai/langchainjs/issues
- npm.io page: https://npm.io/package/@langchain/classic

## Dependencies (8)

- [zod](https://npm.io/package/zod.md) ^3.25.76 || ^4
- [yaml](https://npm.io/package/yaml.md) ^2.9.0
- [js-yaml](https://npm.io/package/js-yaml.md) ^5.4.1
- [handlebars](https://npm.io/package/handlebars.md) ^4.7.9
- [jsonpointer](https://npm.io/package/jsonpointer.md) ^5.0.1
- [openapi-types](https://npm.io/package/openapi-types.md) ^12.1.3
- [@langchain/openai](https://npm.io/package/@langchain/openai.md) 1.5.13
- [@langchain/textsplitters](https://npm.io/package/@langchain/textsplitters.md) 1.0.1

## Alternatives

- [monaco-yaml](https://npm.io/package/monaco-yaml.md) — 420.1K weekly downloads
- [@crewx/workflow](https://npm.io/package/@crewx/workflow.md) — 3.1K weekly downloads
- [yaml-cat](https://npm.io/package/yaml-cat.md) — 38 weekly downloads
- [nunjucks-in-yaml](https://npm.io/package/nunjucks-in-yaml.md) — 9 weekly downloads
- [shopify-symlinks](https://npm.io/package/shopify-symlinks.md) — 3 weekly downloads

## Recent versions

- 1.0.48 (latest) — 2026-09-12
- 1.0.47-rc.0 (rc) — 2026-09-06
- 1.0.28-dev-1775244116634 (dev) — 2026-04-03
- 1.0.0-alpha.1 (alpha) — 2025-10-14
- 1.0.47 — 2026-09-09
- 1.0.46 — 2026-09-01
- 1.0.45 — 2026-08-20
- 1.0.44 — 2026-08-20
- 1.0.43 — 2026-08-14
- 1.0.42 — 2026-08-12
- 1.0.41 — 2026-08-05
- 1.0.40 — 2026-07-09
- 1.0.39 — 2026-07-09
- 1.0.38 — 2026-06-23
- 1.0.37 — 2026-06-22
- … 52 more at https://npm.io/package/@langchain/classic/versions

## README

# @langchain/classic

This package contains functionality from LangChain v0.x that has been moved out of the main `langchain` package as part of the v1.0 release. It exists to provide backward compatibility for existing applications while the core `langchain` package focuses on the essential building blocks for modern agent development.

## When to use this package

Use `@langchain/classic` if you:

- Have existing code that uses legacy chains (e.g., `LLMChain`, `ConversationalRetrievalQAChain`, `RetrievalQAChain`)
- Use the indexing API
- Depend on functionality from `@langchain/community` that was previously re-exported from `langchain`
- Are maintaining an existing application and not yet ready to migrate to the new `createAgent` API

## When NOT to use this package

**For new projects, use `langchain` v1.0 instead.** The new APIs provide:

- **`createAgent`**: A cleaner, more powerful way to build agents with middleware support
- **Better performance**: Optimized for modern agent workflows
- **Focused API surface**: Less complexity, easier to learn
- **Active development**: New features and improvements will focus on v1.0 APIs

See the [LangChain v1.0 release notes](https://docs.langchain.com/oss/javascript/releases/langchain-v1) for more information.

## Installation

```bash npm2yarn
npm install @langchain/classic
```

This package requires `@langchain/core` as a peer dependency:

```bash npm2yarn
npm install @langchain/core
```

## What's included

### Legacy Chains

All chain implementations from v0.x, including:

- `LLMChain` - Basic chain for calling an LLM with a prompt template
- `ConversationalRetrievalQAChain` - Chain for conversational question-answering over documents
- `RetrievalQAChain` - Chain for question-answering over documents without conversation memory
- `StuffDocumentsChain` - Chain for stuffing documents into a prompt
- `MapReduceDocumentsChain` - Chain for map-reduce operations over documents
- `RefineDocumentsChain` - Chain for iterative refinement over documents
- And many more...

### Indexing API

The `RecordManager` and related indexing functionality for managing document updates in vector stores.

### Community Integrations

Re-exports from `@langchain/community` that were previously available in the main `langchain` package.

### Other Deprecated Functionality

Various utilities and abstractions that have been replaced by better alternatives in v1.0.

## Migration

### From `langchain` v0.x to `@langchain/classic`

If you're upgrading to `langchain` v1.0 but want to keep using legacy functionality:

1. Install `@langchain/classic`:

   ```bash npm2yarn
   npm install @langchain/classic
   ```

2. Update your imports:

   ```typescript
   // Before (v0.x)
   import { LLMChain } from "langchain/chains";
   import { ConversationalRetrievalQAChain } from "langchain/chains";

   // After (v1.0)
   import { LLMChain } from "@langchain/classic/chains";
   import { ConversationalRetrievalQAChain } from "@langchain/classic/chains";
   ```

   Or if you imported from the root:

   ```typescript
   // Before (v0.x)
   import { LLMChain } from "langchain";

   // After (v1.0)
   import { LLMChain } from "@langchain/classic";
   ```

### From `@langchain/classic` to `langchain` v1.0

**For new development, we recommend using `createAgent` instead of legacy chains.**

Example migration from `LLMChain`:

```typescript
// Before (using LLMChain)
import { LLMChain } from "@langchain/classic/chains";
import { ChatOpenAI } from "@langchain/openai";
import { PromptTemplate } from "@langchain/core/prompts";

const model = new ChatOpenAI({ model: "gpt-4" });
const prompt = PromptTemplate.fromTemplate(
  "What is a good name for a company that makes {product}?"
);
const chain = new LLMChain({ llm: model, prompt });
const result = await chain.call({ product: "colorful socks" });

// After (using createAgent)
import { createAgent } from "langchain";

const agent = createAgent({
  model: "openai:gpt-4",
  systemPrompt: "You are a creative assistant that helps name companies.",
});

const result = await agent.invoke({
  messages: [
    {
      role: "user",
      content: "What is a good name for a company that makes colorful socks?",
    },
  ],
});
```

For more complex migrations, see the [migration guide](https://docs.langchain.com/oss/javascript/migrate/langchain-v1).

## Support and Maintenance

`@langchain/classic` will receive:

- **Bug fixes**: Critical bugs will be fixed
- **Security updates**: Security vulnerabilities will be patched
- **No new features**: New functionality will focus on `langchain` v1.0 APIs

This package is in **maintenance mode**. For new features and active development, use `langchain` v1.0.

## Examples

### Using a legacy chain

```typescript
import { LLMChain } from "@langchain/classic/chains";
import { ChatOpenAI } from "@langchain/openai";
import { PromptTemplate } from "@langchain/core/prompts";

const model = new ChatOpenAI({ model: "gpt-4" });

const prompt = PromptTemplate.fromTemplate(
  "Tell me a {adjective} joke about {content}."
);

const chain = new LLMChain({ llm: model, prompt });

const result = await chain.call({
  adjective: "funny",
  content: "chickens",
});

console.log(result.text);
```

### Using ConversationalRetrievalQAChain

```typescript
import { ConversationalRetrievalQAChain } from "@langchain/classic/chains";
import { ChatOpenAI } from "@langchain/openai";
import { OpenAIEmbeddings } from "@langchain/openai";
import { MemoryVectorStore } from "langchain/vectorstores/memory";

// Create vector store with documents
const vectorStore = await MemoryVectorStore.fromTexts(
  ["Document 1 text...", "Document 2 text..."],
  [{ id: 1 }, { id: 2 }],
  new OpenAIEmbeddings()
);

// Create chain
const model = new ChatOpenAI({ model: "gpt-4" });
const chain = ConversationalRetrievalQAChain.fromLLM(
  model,
  vectorStore.asRetriever()
);

// Use chain
const result = await chain.call({
  question: "What is in the documents?",
  chat_history: [],
});

console.log(result.text);
```

## Resources

- [LangChain v1.0 Release Notes](https://docs.langchain.com/oss/javascript/releases/langchain-v1)
- [Migration Guide](https://docs.langchain.com/oss/javascript/migrate/langchain-v1)
- [LangChain v1.0 Documentation](https://docs.langchain.com/oss/javascript/langchain/agents)
- [GitHub Repository](https://github.com/langchain-ai/langchainjs)

## Support

For bug reports and issues, please open an issue on [GitHub](https://github.com/langchain-ai/langchainjs/issues).

For questions and discussions, join our [Discord community](https://discord.gg/langchain).

## License

This package is licensed under the MIT License. See the [LICENSE](../../LICENSE) file for details.

---
_Source: https://npm.io/package/@langchain/classic · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._