From 8f8392137a8a36e83b1b3ad7db25e88134f6acfc Mon Sep 17 00:00:00 2001 From: Eugene Yurtsev Date: Mon, 7 Oct 2024 14:53:40 -0400 Subject: [PATCH] Update MIGRATE.md (#27169) Upgrade the content of MIGRATE.md so it's in sync --- MIGRATE.md | 73 ++++++------------------------------------------------ 1 file changed, 7 insertions(+), 66 deletions(-) diff --git a/MIGRATE.md b/MIGRATE.md index 7254e9b7e3e..65008650764 100644 --- a/MIGRATE.md +++ b/MIGRATE.md @@ -1,70 +1,11 @@ # Migrating -## 🚨Breaking Changes for select chains (SQLDatabase) on 7/28/23 +Please see the following guides for migratin LangChain code: -In an effort to make `langchain` leaner and safer, we are moving select chains to `langchain_experimental`. -This migration has already started, but we are remaining backwards compatible until 7/28. -On that date, we will remove functionality from `langchain`. -Read more about the motivation and the progress [here](https://github.com/langchain-ai/langchain/discussions/8043). +* Migrate to [LangChain v0.3](https://python.langchain.com/docs/versions/v0_3/) +* Migrate to [LangChain v0.2](https://python.langchain.com/docs/versions/v0_2/) +* Migrating from [LangChain 0.0.x Chains](https://python.langchain.com/docs/versions/migrating_chains/) +* Upgrate to [LangGraph Memory](https://python.langchain.com/docs/versions/migrating_memory/) -### Migrating to `langchain_experimental` - -We are moving any experimental components of LangChain, or components with vulnerability issues, into `langchain_experimental`. -This guide covers how to migrate. - -### Installation - -Previously: - -`pip install -U langchain` - -Now (only if you want to access things in experimental): - -`pip install -U langchain langchain_experimental` - -### Things in `langchain.experimental` - -Previously: - -`from langchain.experimental import ...` - -Now: - -`from langchain_experimental import ...` - -### PALChain - -Previously: - -`from langchain.chains import PALChain` - -Now: - -`from langchain_experimental.pal_chain import PALChain` - -### SQLDatabaseChain - -Previously: - -`from langchain.chains import SQLDatabaseChain` - -Now: - -`from langchain_experimental.sql import SQLDatabaseChain` - -Alternatively, if you are just interested in using the query generation part of the SQL chain, you can check out this [`SQL question-answering tutorial`](https://python.langchain.com/v0.2/docs/tutorials/sql_qa/#convert-question-to-sql-query) - -`from langchain.chains import create_sql_query_chain` - -### `load_prompt` for Python files - -Note: this only applies if you want to load Python files as prompts. -If you want to load json/yaml files, no change is needed. - -Previously: - -`from langchain.prompts import load_prompt` - -Now: - -`from langchain_experimental.prompts import load_prompt` +The [LangChain CLI](https://python.langchain.com/docs/versions/v0_3/#migrate-using-langchain-cli) can help automatically upgrade your code to use non deprecated imports. +This will be especially helpful if you're still on either version 0.0.x or 0.1.x of LangChain.