langchain 0.3.26__tar.gz → 0.4.0.dev0__tar.gz

langchain-0.4.0.dev0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.1
+Name: langchain
+Version: 0.4.0.dev0
+Summary: Building applications with LLMs through composability
+License: MIT
+Project-URL: Source Code, https://github.com/langchain-ai/langchain/tree/master/libs/langchain
+Project-URL: Release Notes, https://github.com/langchain-ai/langchain/releases?q=tag%3A%22langchain%3D%3D0%22&expanded=true
+Project-URL: repository, https://github.com/langchain-ai/langchain
+Requires-Python: <4.0,>=3.9
+Requires-Dist: langchain-core<1.0.0,>=0.4.0.dev0
+Requires-Dist: langchain-text-splitters<1.0.0,>=0.3.9
+Requires-Dist: langsmith>=0.1.17
+Requires-Dist: pydantic<3.0.0,>=2.7.4
+Requires-Dist: SQLAlchemy<3,>=1.4
+Requires-Dist: requests<3,>=2
+Requires-Dist: PyYAML>=5.3
+Requires-Dist: async-timeout<5.0.0,>=4.0.0; python_version < "3.11"
+Provides-Extra: community
+Requires-Dist: langchain-community; extra == "community"
+Provides-Extra: anthropic
+Requires-Dist: langchain-anthropic; extra == "anthropic"
+Provides-Extra: openai
+Requires-Dist: langchain-openai; extra == "openai"
+Provides-Extra: google-genai
+Requires-Dist: langchain-google-genai; extra == "google-genai"
+Provides-Extra: fireworks
+Requires-Dist: langchain-fireworks; extra == "fireworks"
+Provides-Extra: ollama
+Requires-Dist: langchain-ollama; extra == "ollama"
+Provides-Extra: together
+Requires-Dist: langchain-together; extra == "together"
+Provides-Extra: mistralai
+Requires-Dist: langchain-mistralai; extra == "mistralai"
+Provides-Extra: huggingface
+Requires-Dist: langchain-huggingface; extra == "huggingface"
+Provides-Extra: groq
+Requires-Dist: langchain-groq; extra == "groq"
+Provides-Extra: deepseek
+Requires-Dist: langchain-deepseek; extra == "deepseek"
+Provides-Extra: perplexity
+Requires-Dist: langchain-perplexity; extra == "perplexity"
+Description-Content-Type: text/markdown
+
+# 🦜️🔗 LangChain
+
+⚡ Building applications with LLMs through composability ⚡
+
+[![Release Notes](https://img.shields.io/github/release/langchain-ai/langchain)](https://github.com/langchain-ai/langchain/releases)
+[![lint](https://github.com/langchain-ai/langchain/actions/workflows/lint.yml/badge.svg)](https://github.com/langchain-ai/langchain/actions/workflows/lint.yml)
+[![test](https://github.com/langchain-ai/langchain/actions/workflows/test.yml/badge.svg)](https://github.com/langchain-ai/langchain/actions/workflows/test.yml)
+[![Downloads](https://static.pepy.tech/badge/langchain/month)](https://pepy.tech/project/langchain)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI)](https://twitter.com/langchainai)
+[![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/langchain-ai/langchain)
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/langchain-ai/langchain)
+[![GitHub star chart](https://img.shields.io/github/stars/langchain-ai/langchain?style=social)](https://star-history.com/#langchain-ai/langchain)
+[![Dependency Status](https://img.shields.io/librariesio/github/langchain-ai/langchain)](https://libraries.io/github/langchain-ai/langchain)
+[![Open Issues](https://img.shields.io/github/issues-raw/langchain-ai/langchain)](https://github.com/langchain-ai/langchain/issues)
+
+
+Looking for the JS/TS version? Check out [LangChain.js](https://github.com/langchain-ai/langchainjs).
+
+To help you ship LangChain apps to production faster, check out [LangSmith](https://smith.langchain.com). 
+[LangSmith](https://smith.langchain.com) is a unified developer platform for building, testing, and monitoring LLM applications. 
+Fill out [this form](https://www.langchain.com/contact-sales) to speak with our sales team.
+
+## Quick Install
+
+`pip install langchain`
+or
+`pip install langsmith && conda install langchain -c conda-forge`
+
+## 🤔 What is this?
+
+Large language models (LLMs) are emerging as a transformative technology, enabling developers to build applications that they previously could not. However, using these LLMs in isolation is often insufficient for creating a truly powerful app - the real power comes when you can combine them with other sources of computation or knowledge.
+
+This library aims to assist in the development of those types of applications. Common examples of these applications include:
+
+**❓ Question answering with RAG**
+
+- [Documentation](https://python.langchain.com/docs/use_cases/question_answering/)
+- End-to-end Example: [Chat LangChain](https://chat.langchain.com) and [repo](https://github.com/langchain-ai/chat-langchain)
+
+**🧱 Extracting structured output**
+
+- [Documentation](https://python.langchain.com/docs/use_cases/extraction/)
+- End-to-end Example: [SQL Llama2 Template](https://github.com/langchain-ai/langchain-extract/)
+
+**🤖 Chatbots**
+
+- [Documentation](https://python.langchain.com/docs/use_cases/chatbots)
+- End-to-end Example: [Web LangChain (web researcher chatbot)](https://weblangchain.vercel.app) and [repo](https://github.com/langchain-ai/weblangchain)
+
+## 📖 Documentation
+
+Please see [here](https://python.langchain.com) for full documentation on:
+
+- Getting started (installation, setting up the environment, simple examples)
+- How-To examples (demos, integrations, helper functions)
+- Reference (full API docs)
+- Resources (high-level explanation of core concepts)
+
+## 🚀 What can this help with?
+
+There are five main areas that LangChain is designed to help with.
+These are, in increasing order of complexity:
+
+**📃 Models and Prompts:**
+
+This includes prompt management, prompt optimization, a generic interface for all LLMs, and common utilities for working with chat models and LLMs.
+
+**🔗 Chains:**
+
+Chains go beyond a single LLM call and involve sequences of calls (whether to an LLM or a different utility). LangChain provides a standard interface for chains, lots of integrations with other tools, and end-to-end chains for common applications.
+
+**📚 Retrieval Augmented Generation:**
+
+Retrieval Augmented Generation involves specific types of chains that first interact with an external data source to fetch data for use in the generation step. Examples include summarization of long pieces of text and question/answering over specific data sources.
+
+**🤖 Agents:**
+
+Agents involve an LLM making decisions about which Actions to take, taking that Action, seeing an Observation, and repeating that until done. LangChain provides a standard interface for agents, a selection of agents to choose from, and examples of end-to-end agents.
+
+**🧐 Evaluation:**
+
+[BETA] Generative models are notoriously hard to evaluate with traditional metrics. One new way of evaluating them is using language models themselves to do the evaluation. LangChain provides some prompts/chains for assisting in this.
+
+For more information on these concepts, please see our [full documentation](https://python.langchain.com).
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://python.langchain.com/docs/contributing/).

langchain-0.4.0.dev0/langchain/__init__.py

@@ -0,0 +1,453 @@
+"""Main entrypoint into package."""
+
+import warnings
+from importlib import metadata
+from typing import Any, Optional
+
+from langchain_core._api.deprecation import surface_langchain_deprecation_warnings
+
+try:
+    __version__ = metadata.version(__package__)
+except metadata.PackageNotFoundError:
+    # Case where package metadata is not available.
+    __version__ = ""
+del metadata  # optional, avoids polluting the results of dir(__package__)
+
+
+def _warn_on_import(name: str, replacement: Optional[str] = None) -> None:
+    """Warn on import of deprecated module."""
+    from langchain._api.interactive_env import is_interactive_env
+
+    if is_interactive_env():
+        # No warnings for interactive environments.
+        # This is done to avoid polluting the output of interactive environments
+        # where users rely on auto-complete and may trigger this warning
+        # even if they are not using any deprecated modules
+        return
+
+    if replacement:
+        warnings.warn(
+            f"Importing {name} from langchain root module is no longer supported. "
+            f"Please use {replacement} instead.",
+            stacklevel=3,
+        )
+    else:
+        warnings.warn(
+            f"Importing {name} from langchain root module is no longer supported.",
+            stacklevel=3,
+        )
+
+
+# Surfaces Deprecation and Pending Deprecation warnings from langchain.
+surface_langchain_deprecation_warnings()
+
+
+def __getattr__(name: str) -> Any:
+    if name == "MRKLChain":
+        from langchain.agents import MRKLChain
+
+        _warn_on_import(name, replacement="langchain.agents.MRKLChain")
+
+        return MRKLChain
+    if name == "ReActChain":
+        from langchain.agents import ReActChain
+
+        _warn_on_import(name, replacement="langchain.agents.ReActChain")
+
+        return ReActChain
+    if name == "SelfAskWithSearchChain":
+        from langchain.agents import SelfAskWithSearchChain
+
+        _warn_on_import(name, replacement="langchain.agents.SelfAskWithSearchChain")
+
+        return SelfAskWithSearchChain
+    if name == "ConversationChain":
+        from langchain.chains import ConversationChain
+
+        _warn_on_import(name, replacement="langchain.chains.ConversationChain")
+
+        return ConversationChain
+    if name == "LLMBashChain":
+        msg = (
+            "This module has been moved to langchain-experimental. "
+            "For more details: "
+            "https://github.com/langchain-ai/langchain/discussions/11352."
+            "To access this code, install it with `pip install langchain-experimental`."
+            "`from langchain_experimental.llm_bash.base "
+            "import LLMBashChain`"
+        )
+        raise ImportError(msg)
+
+    if name == "LLMChain":
+        from langchain.chains import LLMChain
+
+        _warn_on_import(name, replacement="langchain.chains.LLMChain")
+
+        return LLMChain
+    if name == "LLMCheckerChain":
+        from langchain.chains import LLMCheckerChain
+
+        _warn_on_import(name, replacement="langchain.chains.LLMCheckerChain")
+
+        return LLMCheckerChain
+    if name == "LLMMathChain":
+        from langchain.chains import LLMMathChain
+
+        _warn_on_import(name, replacement="langchain.chains.LLMMathChain")
+
+        return LLMMathChain
+    if name == "QAWithSourcesChain":
+        from langchain.chains import QAWithSourcesChain
+
+        _warn_on_import(name, replacement="langchain.chains.QAWithSourcesChain")
+
+        return QAWithSourcesChain
+    if name == "VectorDBQA":
+        from langchain.chains import VectorDBQA
+
+        _warn_on_import(name, replacement="langchain.chains.VectorDBQA")
+
+        return VectorDBQA
+    if name == "VectorDBQAWithSourcesChain":
+        from langchain.chains import VectorDBQAWithSourcesChain
+
+        _warn_on_import(name, replacement="langchain.chains.VectorDBQAWithSourcesChain")
+
+        return VectorDBQAWithSourcesChain
+    if name == "InMemoryDocstore":
+        from langchain_community.docstore import InMemoryDocstore
+
+        _warn_on_import(name, replacement="langchain.docstore.InMemoryDocstore")
+
+        return InMemoryDocstore
+    if name == "Wikipedia":
+        from langchain_community.docstore import Wikipedia
+
+        _warn_on_import(name, replacement="langchain.docstore.Wikipedia")
+
+        return Wikipedia
+    if name == "Anthropic":
+        from langchain_community.llms import Anthropic
+
+        _warn_on_import(name, replacement="langchain_community.llms.Anthropic")
+
+        return Anthropic
+    if name == "Banana":
+        from langchain_community.llms import Banana
+
+        _warn_on_import(name, replacement="langchain_community.llms.Banana")
+
+        return Banana
+    if name == "CerebriumAI":
+        from langchain_community.llms import CerebriumAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.CerebriumAI")
+
+        return CerebriumAI
+    if name == "Cohere":
+        from langchain_community.llms import Cohere
+
+        _warn_on_import(name, replacement="langchain_community.llms.Cohere")
+
+        return Cohere
+    if name == "ForefrontAI":
+        from langchain_community.llms import ForefrontAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.ForefrontAI")
+
+        return ForefrontAI
+    if name == "GooseAI":
+        from langchain_community.llms import GooseAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.GooseAI")
+
+        return GooseAI
+    if name == "HuggingFaceHub":
+        from langchain_community.llms import HuggingFaceHub
+
+        _warn_on_import(name, replacement="langchain_community.llms.HuggingFaceHub")
+
+        return HuggingFaceHub
+    if name == "HuggingFaceTextGenInference":
+        from langchain_community.llms import HuggingFaceTextGenInference
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.llms.HuggingFaceTextGenInference",
+        )
+
+        return HuggingFaceTextGenInference
+    if name == "LlamaCpp":
+        from langchain_community.llms import LlamaCpp
+
+        _warn_on_import(name, replacement="langchain_community.llms.LlamaCpp")
+
+        return LlamaCpp
+    if name == "Modal":
+        from langchain_community.llms import Modal
+
+        _warn_on_import(name, replacement="langchain_community.llms.Modal")
+
+        return Modal
+    if name == "OpenAI":
+        from langchain_community.llms import OpenAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.OpenAI")
+
+        return OpenAI
+    if name == "Petals":
+        from langchain_community.llms import Petals
+
+        _warn_on_import(name, replacement="langchain_community.llms.Petals")
+
+        return Petals
+    if name == "PipelineAI":
+        from langchain_community.llms import PipelineAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.PipelineAI")
+
+        return PipelineAI
+    if name == "SagemakerEndpoint":
+        from langchain_community.llms import SagemakerEndpoint
+
+        _warn_on_import(name, replacement="langchain_community.llms.SagemakerEndpoint")
+
+        return SagemakerEndpoint
+    if name == "StochasticAI":
+        from langchain_community.llms import StochasticAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.StochasticAI")
+
+        return StochasticAI
+    if name == "Writer":
+        from langchain_community.llms import Writer
+
+        _warn_on_import(name, replacement="langchain_community.llms.Writer")
+
+        return Writer
+    if name == "HuggingFacePipeline":
+        from langchain_community.llms.huggingface_pipeline import HuggingFacePipeline
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.llms.huggingface_pipeline.HuggingFacePipeline",
+        )
+
+        return HuggingFacePipeline
+    if name == "FewShotPromptTemplate":
+        from langchain_core.prompts import FewShotPromptTemplate
+
+        _warn_on_import(
+            name,
+            replacement="langchain_core.prompts.FewShotPromptTemplate",
+        )
+
+        return FewShotPromptTemplate
+    if name == "Prompt":
+        from langchain_core.prompts import PromptTemplate
+
+        _warn_on_import(name, replacement="langchain_core.prompts.PromptTemplate")
+
+        # it's renamed as prompt template anyways
+        # this is just for backwards compat
+        return PromptTemplate
+    if name == "PromptTemplate":
+        from langchain_core.prompts import PromptTemplate
+
+        _warn_on_import(name, replacement="langchain_core.prompts.PromptTemplate")
+
+        return PromptTemplate
+    if name == "BasePromptTemplate":
+        from langchain_core.prompts import BasePromptTemplate
+
+        _warn_on_import(name, replacement="langchain_core.prompts.BasePromptTemplate")
+
+        return BasePromptTemplate
+    if name == "ArxivAPIWrapper":
+        from langchain_community.utilities import ArxivAPIWrapper
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.utilities.ArxivAPIWrapper",
+        )
+
+        return ArxivAPIWrapper
+    if name == "GoldenQueryAPIWrapper":
+        from langchain_community.utilities import GoldenQueryAPIWrapper
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.utilities.GoldenQueryAPIWrapper",
+        )
+
+        return GoldenQueryAPIWrapper
+    if name == "GoogleSearchAPIWrapper":
+        from langchain_community.utilities import GoogleSearchAPIWrapper
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.utilities.GoogleSearchAPIWrapper",
+        )
+
+        return GoogleSearchAPIWrapper
+    if name == "GoogleSerperAPIWrapper":
+        from langchain_community.utilities import GoogleSerperAPIWrapper
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.utilities.GoogleSerperAPIWrapper",
+        )
+
+        return GoogleSerperAPIWrapper
+    if name == "PowerBIDataset":
+        from langchain_community.utilities import PowerBIDataset
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.utilities.PowerBIDataset",
+        )
+
+        return PowerBIDataset
+    if name == "SearxSearchWrapper":
+        from langchain_community.utilities import SearxSearchWrapper
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.utilities.SearxSearchWrapper",
+        )
+
+        return SearxSearchWrapper
+    if name == "WikipediaAPIWrapper":
+        from langchain_community.utilities import WikipediaAPIWrapper
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.utilities.WikipediaAPIWrapper",
+        )
+
+        return WikipediaAPIWrapper
+    if name == "WolframAlphaAPIWrapper":
+        from langchain_community.utilities import WolframAlphaAPIWrapper
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.utilities.WolframAlphaAPIWrapper",
+        )
+
+        return WolframAlphaAPIWrapper
+    if name == "SQLDatabase":
+        from langchain_community.utilities import SQLDatabase
+
+        _warn_on_import(name, replacement="langchain_community.utilities.SQLDatabase")
+
+        return SQLDatabase
+    if name == "FAISS":
+        from langchain_community.vectorstores import FAISS
+
+        _warn_on_import(name, replacement="langchain_community.vectorstores.FAISS")
+
+        return FAISS
+    if name == "ElasticVectorSearch":
+        from langchain_community.vectorstores import ElasticVectorSearch
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.vectorstores.ElasticVectorSearch",
+        )
+
+        return ElasticVectorSearch
+    # For backwards compatibility
+    if name in {"SerpAPIChain", "SerpAPIWrapper"}:
+        from langchain_community.utilities import SerpAPIWrapper
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.utilities.SerpAPIWrapper",
+        )
+
+        return SerpAPIWrapper
+    if name == "verbose":
+        from langchain.globals import _verbose
+
+        _warn_on_import(
+            name,
+            replacement=(
+                "langchain.globals.set_verbose() / langchain.globals.get_verbose()"
+            ),
+        )
+
+        return _verbose
+    if name == "debug":
+        from langchain.globals import _debug
+
+        _warn_on_import(
+            name,
+            replacement=(
+                "langchain.globals.set_debug() / langchain.globals.get_debug()"
+            ),
+        )
+
+        return _debug
+    if name == "llm_cache":
+        from langchain.globals import _llm_cache
+
+        _warn_on_import(
+            name,
+            replacement=(
+                "langchain.globals.set_llm_cache() / langchain.globals.get_llm_cache()"
+            ),
+        )
+
+        return _llm_cache
+    msg = f"Could not find: {name}"
+    raise AttributeError(msg)
+
+
+__all__ = [
+    "FAISS",
+    "Anthropic",
+    "ArxivAPIWrapper",
+    "Banana",
+    "BasePromptTemplate",
+    "CerebriumAI",
+    "Cohere",
+    "ConversationChain",
+    "ElasticVectorSearch",
+    "FewShotPromptTemplate",
+    "ForefrontAI",
+    "GoldenQueryAPIWrapper",
+    "GoogleSearchAPIWrapper",
+    "GoogleSerperAPIWrapper",
+    "GooseAI",
+    "HuggingFaceHub",
+    "HuggingFacePipeline",
+    "HuggingFaceTextGenInference",
+    "InMemoryDocstore",
+    "LLMChain",
+    "LLMCheckerChain",
+    "LLMMathChain",
+    "LlamaCpp",
+    "MRKLChain",
+    "Modal",
+    "OpenAI",
+    "Petals",
+    "PipelineAI",
+    "PowerBIDataset",
+    "Prompt",
+    "PromptTemplate",
+    "QAWithSourcesChain",
+    "ReActChain",
+    "SQLDatabase",
+    "SagemakerEndpoint",
+    "SearxSearchWrapper",
+    "SelfAskWithSearchChain",
+    "SerpAPIChain",
+    "SerpAPIWrapper",
+    "StochasticAI",
+    "VectorDBQA",
+    "VectorDBQAWithSourcesChain",
+    "Wikipedia",
+    "WikipediaAPIWrapper",
+    "WolframAlphaAPIWrapper",
+    "Writer",
+]

langchain-0.4.0.dev0/langchain/_api/__init__.py

@@ -0,0 +1,28 @@
+"""Helper functions for managing the LangChain API.
+
+This module is only relevant for LangChain developers, not for users.
+
+.. warning::
+
+    This module and its submodules are for internal use only.  Do not use them
+    in your own code.  We may change the API at any time with no warning.
+
+"""
+
+from .deprecation import (
+    LangChainDeprecationWarning,
+    deprecated,
+    suppress_langchain_deprecation_warning,
+    surface_langchain_deprecation_warnings,
+    warn_deprecated,
+)
+from .module_import import create_importer
+
+__all__ = [
+    "LangChainDeprecationWarning",
+    "create_importer",
+    "deprecated",
+    "suppress_langchain_deprecation_warning",
+    "surface_langchain_deprecation_warnings",
+    "warn_deprecated",
+]

langchain-0.4.0.dev0/langchain/_api/deprecation.py

@@ -0,0 +1,32 @@
+from langchain_core._api.deprecation import (
+    LangChainDeprecationWarning,
+    LangChainPendingDeprecationWarning,
+    deprecated,
+    suppress_langchain_deprecation_warning,
+    surface_langchain_deprecation_warnings,
+    warn_deprecated,
+)
+
+AGENT_DEPRECATION_WARNING = (
+    "LangChain agents will continue to be supported, but it is recommended for new "
+    "use cases to be built with LangGraph. LangGraph offers a more flexible and "
+    "full-featured framework for building agents, including support for "
+    "tool-calling, persistence of state, and human-in-the-loop workflows. For "
+    "details, refer to the "
+    "`LangGraph documentation <https://langchain-ai.github.io/langgraph/>`_"
+    " as well as guides for "
+    "`Migrating from AgentExecutor <https://python.langchain.com/docs/how_to/migrate_agent/>`_"
+    " and LangGraph's "
+    "`Pre-built ReAct agent <https://langchain-ai.github.io/langgraph/how-tos/create-react-agent/>`_."
+)
+
+
+__all__ = [
+    "AGENT_DEPRECATION_WARNING",
+    "LangChainDeprecationWarning",
+    "LangChainPendingDeprecationWarning",
+    "deprecated",
+    "suppress_langchain_deprecation_warning",
+    "surface_langchain_deprecation_warnings",
+    "warn_deprecated",
+]