Merge branch 'master' into updated_oci_model_deployments

.pre-commit-config.yaml

@@ -0,0 +1,129 @@
+repos:
+- repo: local
+  hooks:
+    - id: core
+      name: format core
+      language: system
+      entry: make -C libs/core format
+      files: ^libs/core/
+      pass_filenames: false
+    - id: community
+      name: format community
+      language: system
+      entry: make -C libs/community format
+      files: ^libs/community/
+      pass_filenames: false
+    - id: langchain
+      name: format langchain
+      language: system
+      entry: make -C libs/langchain format
+      files: ^libs/langchain/
+      pass_filenames: false
+    - id: standard-tests
+      name: format standard-tests
+      language: system
+      entry: make -C libs/standard-tests format
+      files: ^libs/standard-tests/
+      pass_filenames: false
+    - id: text-splitters
+      name: format text-splitters
+      language: system
+      entry: make -C libs/text-splitters format
+      files: ^libs/text-splitters/
+      pass_filenames: false
+    - id: anthropic
+      name: format partners/anthropic
+      language: system
+      entry: make -C libs/partners/anthropic format
+      files: ^libs/partners/anthropic/
+      pass_filenames: false
+    - id: chroma
+      name: format partners/chroma
+      language: system
+      entry: make -C libs/partners/chroma format
+      files: ^libs/partners/chroma/
+      pass_filenames: false
+    - id: couchbase
+      name: format partners/couchbase
+      language: system
+      entry: make -C libs/partners/couchbase format
+      files: ^libs/partners/couchbase/
+      pass_filenames: false
+    - id: exa
+      name: format partners/exa
+      language: system
+      entry: make -C libs/partners/exa format
+      files: ^libs/partners/exa/
+      pass_filenames: false
+    - id: fireworks
+      name: format partners/fireworks
+      language: system
+      entry: make -C libs/partners/fireworks format
+      files: ^libs/partners/fireworks/
+      pass_filenames: false
+    - id: groq
+      name: format partners/groq
+      language: system
+      entry: make -C libs/partners/groq format
+      files: ^libs/partners/groq/
+      pass_filenames: false
+    - id: huggingface
+      name: format partners/huggingface
+      language: system
+      entry: make -C libs/partners/huggingface format
+      files: ^libs/partners/huggingface/
+      pass_filenames: false
+    - id: mistralai
+      name: format partners/mistralai
+      language: system
+      entry: make -C libs/partners/mistralai format
+      files: ^libs/partners/mistralai/
+      pass_filenames: false
+    - id: nomic
+      name: format partners/nomic
+      language: system
+      entry: make -C libs/partners/nomic format
+      files: ^libs/partners/nomic/
+      pass_filenames: false
+    - id: ollama
+      name: format partners/ollama
+      language: system
+      entry: make -C libs/partners/ollama format
+      files: ^libs/partners/ollama/
+      pass_filenames: false
+    - id: openai
+      name: format partners/openai
+      language: system
+      entry: make -C libs/partners/openai format
+      files: ^libs/partners/openai/
+      pass_filenames: false
+    - id: pinecone
+      name: format partners/pinecone
+      language: system
+      entry: make -C libs/partners/pinecone format
+      files: ^libs/partners/pinecone/
+      pass_filenames: false
+    - id: prompty
+      name: format partners/prompty
+      language: system
+      entry: make -C libs/partners/prompty format
+      files: ^libs/partners/prompty/
+      pass_filenames: false
+    - id: qdrant
+      name: format partners/qdrant
+      language: system
+      entry: make -C libs/partners/qdrant format
+      files: ^libs/partners/qdrant/
+      pass_filenames: false
+    - id: voyageai
+      name: format partners/voyageai
+      language: system
+      entry: make -C libs/partners/voyageai format
+      files: ^libs/partners/voyageai/
+      pass_filenames: false
+    - id: root
+      name: format docs, cookbook
+      language: system
+      entry: make format
+      files: ^(docs|cookbook)/
+      pass_filenames: false

README.md

@@ -75,7 +75,7 @@ For these applications, LangChain simplifies the entire application lifecycle:
 **🧱 Extracting structured output**
 
 - [Documentation](https://python.langchain.com/docs/tutorials/extraction/)
-- End-to-end Example: [SQL Llama2 Template](https://github.com/langchain-ai/langchain-extract/)
+- End-to-end Example: [LangChain Extract](https://github.com/langchain-ai/langchain-extract/)
 
 **🤖 Chatbots**
 

docs/docs/additional_resources/tutorials.mdx

@@ -12,6 +12,7 @@
 ### [by Mayo Oshin](https://www.youtube.com/@chatwithdata/search?query=langchain)
 ### [by 1 little Coder](https://www.youtube.com/playlist?list=PLpdmBGJ6ELUK-v0MK-t4wZmVEbxM5xk6L)
 ### [by BobLin (Chinese language)](https://www.youtube.com/playlist?list=PLbd7ntv6PxC3QMFQvtWfk55p-Op_syO1C)
+### [by Total Technology Zonne](https://youtube.com/playlist?list=PLI8raxzYtfGyE02fAxiM1CPhLUuqcTLWg&si=fkAye16rQKBJVHc9)
 
 ## Courses
 

docs/docs/concepts/index.mdx

@@ -48,7 +48,7 @@ The conceptual guide does not cover step-by-step instructions or specific implem
 - **[AIMessage](/docs/concepts/messages#aimessage)**: Represents a complete response from an AI model.
 - **[astream_events](/docs/concepts/chat_models#key-methods)**: Stream granular information from [LCEL](/docs/concepts/lcel) chains.
 - **[BaseTool](/docs/concepts/tools/#tool-interface)**: The base class for all tools in LangChain.
-- **[batch](/docs/concepts/runnables)**: Use to execute a runnable with batch inputs a Runnable.
+- **[batch](/docs/concepts/runnables)**: Use to execute a runnable with batch inputs.
 - **[bind_tools](/docs/concepts/tool_calling/#tool-binding)**: Allows models to interact with tools.
 - **[Caching](/docs/concepts/chat_models#caching)**: Storing results to avoid redundant calls to a chat model.
 - **[Chat models](/docs/concepts/multimodality/#multimodality-in-chat-models)**: Chat models that handle multiple data modalities.
@@ -70,7 +70,7 @@ The conceptual guide does not cover step-by-step instructions or specific implem
 - **[langchain-core](/docs/concepts/architecture#langchain-core)**: Core langchain package. Includes base interfaces and in-memory implementations.
 - **[langchain](/docs/concepts/architecture#langchain)**: A package for higher level components (e.g., some pre-built chains).
 - **[langgraph](/docs/concepts/architecture#langgraph)**: Powerful orchestration layer for LangChain. Use to build complex pipelines and workflows.
-- **[langserve](/docs/concepts/architecture#langserve)**: Use to deploy LangChain Runnables as REST endpoints. Uses FastAPI. Works primarily for LangChain Runnables, does not currently integrate with LangGraph.
+- **[langserve](/docs/concepts/architecture#langserve)**: Used to deploy LangChain Runnables as REST endpoints. Uses FastAPI. Works primarily for LangChain Runnables, does not currently integrate with LangGraph.
 - **[LLMs (legacy)](/docs/concepts/text_llms)**: Older language models that take a string as input and return a string as output.
 - **[Managing chat history](/docs/concepts/chat_history#managing-chat-history)**: Techniques to maintain and manage the chat history.
 - **[OpenAI format](/docs/concepts/messages#openai-format)**: OpenAI's message format for chat models.
@@ -79,7 +79,7 @@ The conceptual guide does not cover step-by-step instructions or specific implem
 - **[RemoveMessage](/docs/concepts/messages/#removemessage)**: An abstraction used to remove a message from chat history, used primarily in LangGraph.
 - **[role](/docs/concepts/messages#role)**: Represents the role (e.g., user, assistant) of a chat message.
 - **[RunnableConfig](/docs/concepts/runnables/#runnableconfig)**: Use to pass run time information to Runnables (e.g., `run_name`, `run_id`, `tags`, `metadata`, `max_concurrency`, `recursion_limit`, `configurable`).
-- **[Standard parameters for chat models](/docs/concepts/chat_models#standard-parameters)**: Parameters such as API key, `temperature`, and `max_tokens`,
+- **[Standard parameters for chat models](/docs/concepts/chat_models#standard-parameters)**: Parameters such as API key, `temperature`, and `max_tokens`.
 - **[Standard tests](/docs/concepts/testing#standard-tests)**: A defined set of unit and integration tests that all integrations must pass.
 - **[stream](/docs/concepts/streaming)**: Use to stream output from a Runnable or a graph.
 - **[Tokenization](/docs/concepts/tokens)**: The process of converting data into tokens and vice versa.

docs/docs/concepts/runnables.mdx

@@ -114,7 +114,7 @@ Please see the [Configurable Runnables](#configurable-runnables) section for mor
 | Method                  | Description                                                      |
 |-------------------------|------------------------------------------------------------------|
 | `get_input_schema`      | Gives the Pydantic Schema of the input schema for the Runnable.  |
-| `get_output_chema`      | Gives the Pydantic Schema of the output schema for the Runnable. |
+| `get_output_schema`      | Gives the Pydantic Schema of the output schema for the Runnable. |
 | `config_schema`         | Gives the Pydantic Schema of the config schema for the Runnable. |
 | `get_input_jsonschema`  | Gives the JSONSchema of the input schema for the Runnable.       |
 | `get_output_jsonschema` | Gives the JSONSchema of the output schema for the Runnable.      |
@@ -323,7 +323,7 @@ multiple Runnables and you need to add custom processing logic in one of the ste
 
 There are two ways to create a custom Runnable from a function:
 
-* `RunnableLambda`: Use this simple transformations where streaming is not required.
+* `RunnableLambda`: Use this for simple transformations where streaming is not required.
 * `RunnableGenerator`: use this for more complex transformations when streaming is needed.
 
 See the [How to run custom functions](/docs/how_to/functions) guide for more information on how to use `RunnableLambda` and `RunnableGenerator`.
@@ -347,6 +347,6 @@ Sometimes you may want to experiment with, or even expose to the end user, multi
 To simplify this process, the Runnable interface provides two methods for creating configurable Runnables at runtime:
 
 * `configurable_fields`: This method allows you to configure specific **attributes** in a Runnable. For example, the `temperature` attribute of a chat model.
-* `configurable_alternatives`: This method enables you to specify **alternative** Runnables that can be run during run time. For example, you could specify a list of different chat models that can be used.
+* `configurable_alternatives`: This method enables you to specify **alternative** Runnables that can be run during runtime. For example, you could specify a list of different chat models that can be used.
 
 See the [How to configure runtime chain internals](/docs/how_to/configure) guide for more information on how to configure runtime chain internals.

docs/docs/contributing/how_to/integrations/package.mdx

@@ -291,37 +291,8 @@ import VectorstoreSource from '../../../../src/theme/integration_template/integr
 Embeddings are used to convert `str` objects from `Document.page_content` fields
 into a vector representation (represented as a list of floats).
 
-The `Embeddings` class must inherit from the [Embeddings](https://python.langchain.com/api_reference/core/embeddings/langchain_core.embeddings.embeddings.Embeddings.html#langchain_core.embeddings.embeddings.Embeddings)
-base class. This interface has 5 methods that can be implemented.
-
-| Method/Property         | Description                                          |
-|------------------------ |------------------------------------------------------|
-| `__init__`              | Initialize the embeddings object. (optional)         |
-| `embed_query`           | Embed a list of texts. (required)                    |
-| `embed_documents`       | Embed a list of documents. (required)                |
-| `aembed_query`          | Asynchronously embed a list of texts. (optional)     |
-| `aembed_documents`      | Asynchronously embed a list of documents. (optional) |
-
-### Constructor
-
-The `__init__` constructor is optional but common, but can be used to set up any necessary attributes
-that a user can pass in when initializing the embeddings object. Common attributes include
-
-- `model` - the id of the model to use for embeddings
-
-### Embedding queries vs documents
-
-The `embed_query` and `embed_documents` methods are required. These methods both operate
-on string inputs (the accessing of `Document.page_content` attributes) is handled
-by the VectorStore using the embedding model for legacy reasons.
-
-`embed_query` takes in a single string and returns a single embedding as a list of floats.
-If your model has different modes for embedding queries vs the underlying documents, you can
-implement this method to handle that. 
-
-`embed_documents` takes in a list of strings and returns a list of embeddings as a list of lists of floats.
-
-### Implementation
+Refer to the [Custom Embeddings Guide](/docs/how_to/custom_embeddings) guide for
+detail on a starter embeddings [implementation](/docs/how_to/custom_embeddings/#implementation).
 
 You can start from the following template or langchain-cli command:
 

docs/docs/contributing/index.mdx

@@ -37,7 +37,11 @@ If you are able to help answer questions, please do so! This will allow the main
 
 Our [issues](https://github.com/langchain-ai/langchain/issues) page is kept up to date with bugs, improvements, and feature requests.
 
-There is a taxonomy of labels to help with sorting and discovery of issues of interest. Please use these to help organize issues.
+There is a [taxonomy of labels](https://github.com/langchain-ai/langchain/labels?sort=count-desc)
+to help with sorting and discovery of issues of interest. Please use these to help
+organize issues. Check out the [Help Wanted](https://github.com/langchain-ai/langchain/labels/help%20wanted)
+and [Good First Issue](https://github.com/langchain-ai/langchain/labels/good%20first%20issue)
+tags for recommendations.
 
 If you start working on an issue, please assign it to yourself.