diff --git a/docs/docs/concepts/deployment_options.md b/docs/docs/concepts/deployment_options.md index 1e6789373..0b64e1aa4 100644 --- a/docs/docs/concepts/deployment_options.md +++ b/docs/docs/concepts/deployment_options.md @@ -4,33 +4,55 @@ - [LangGraph Platform](./langgraph_platform.md) - [LangGraph Server](./langgraph_server.md) + - [LangGraph Platform Plans](./plans.md) ## Overview -There are 3 main options for deploying with the LangGraph Platform: +There are 4 main options for deploying with the LangGraph Platform: -1. **[Self-Hosted](#self-hosted)**: Available for **a free trial** and **Enterprise** plan. +1. **[Self-Hosted Lite](#self-hosted-lite)**: Available for all plans. -2. **[Cloud SaaS](#cloud-saas)**: Available for **Plus** and **Enterprise** plans. +2. **[Self-Hosted Enterprise](#self-hosted-enterprise)**: Available for the **Enterprise** plan. -3. **[Bring Your Own Cloud](#bring-your-own-cloud)**: Available only for **Enterprise** plans and **only on AWS**. +3. **[Cloud SaaS](#cloud-saas)**: Available for **Plus** and **Enterprise** plans. -Please see the [LangGraph Platform Pricing](https://www.langchain.com/langgraph-platform-pricing) for more information on the different plans. +4. **[Bring Your Own Cloud](#bring-your-own-cloud)**: Available only for **Enterprise** plans and **only on AWS**. + +Please see the [LangGraph Platform Plans](./plans.md) for more information on the different plans. The guide below will explain the differences between the deployment options. -## Self-Hosted +## Self-Hosted Enterprise !!! important - The Self-Hosted version is only available for **a free trial** and **Enterprise** plan. + The Self-Hosted Enterprise version is only available for the **Enterprise** plan. -With a Self-Hosted deployment, you are responsible for managing the infrastructure, including setting up and maintaining required databases and Redis instances. +With a Self-Hosted Enterprise deployment, you are responsible for managing the infrastructure, including setting up and maintaining required databases and Redis instances. You’ll build a Docker image using the [LangGraph CLI](./langgraph_cli.md), which can then be deployed on your own infrastructure. For more information, please see: +* [Self-Hosted conceptual guide](./self_hosted.md) +* [Self-Hosted Deployment how-to guide](../how-tos/deploy-self-hosted.md) + +## Self-Hosted Lite + +!!! important + + The Self-Hosted Lite version is available for all plans. + +The Self-Hosted Lite deployment option is a free (up to 1 million nodes executed), limited version of LangGraph Platform that you can run locally or in a self-hosted manner. + +With a Self-Hosted Lite deployment, you are responsible for managing the infrastructure, including setting up and maintaining required databases and Redis instances. + +You’ll build a Docker image using the [LangGraph CLI](./langgraph_cli.md), which can then be deployed on your own infrastructure. + + +For more information, please see: + +* [Self-Hosted conceptual guide](./self_hosted.md) * [Self-Hosted Deployment how-to guide](../how-tos/deploy-self-hosted.md) ## Cloud SaaS @@ -69,5 +91,6 @@ For more information please see: For more information please see: +* [LangGraph Platform Plans](./plans.md) * [LangGraph Platform Pricing](https://www.langchain.com/langgraph-platform-pricing) * [Deployment how-to guides](../how-tos/index.md#deployment) diff --git a/docs/docs/concepts/index.md b/docs/docs/concepts/index.md index 27f18eaa6..e6a4545a5 100644 --- a/docs/docs/concepts/index.md +++ b/docs/docs/concepts/index.md @@ -45,7 +45,8 @@ The LangGraph Platform offers a few different deployment options described in th **High Level** - [Why LangGraph Platform?](./langgraph_platform.md): The LangGraph platform is an opinionated way to deploy and manage LangGraph applications. This guide provides an overview of the key features and concepts behind LangGraph Platform. -- [Deployment Options](./deployment_options.md): LangGraph Platform offers three deployment options: self-hosted, [bring your own cloud (BYOC)](./bring_your_own_cloud.md), and [Cloud SaaS](./langgraph_cloud.md). This guide explains the differences between these options, and which Plans they are available on. +- [Deployment Options](./deployment_options.md): LangGraph Platform offers four deployment options: [Self-Hosted Lite](./self_hosted.md#self-hosted-lite), [Self-Hosted Enterprise](./self_hosted.md#self-hosted-enterprise), [bring your own cloud (BYOC)](./bring_your_own_cloud.md), and [Cloud SaaS](./langgraph_cloud.md). This guide explains the differences between these options, and which Plans they are available on. +- [Plans](./plans.md): LangGraph Platforms offer three different plans: Developer, Plus, Enterprise. This guide explains the differences between these options, what deployment options are available for each, and how to sign up for each one. - [Template Applications](./template_applications.md): Reference applications designed to help you get started quickly when building with LangGraph. **Components** @@ -65,3 +66,11 @@ The LangGraph Platform comprises several components that work together to suppor - [Web-hooks](./langgraph_server.md#webhooks): Webhooks allow your running LangGraph application to send data to external services on specific events. - [Cron Jobs](./langgraph_server.md#cron-jobs): Cron jobs are a way to schedule tasks to run at specific times in your LangGraph application. - [Double Texting](./double_texting.md): Double texting is a common issue in LLM applications where users may send multiple messages before the graph has finished running. This guide explains how to handle double texting with LangGraph Deploy. + +**Deployment Options** + + +- [Self-Hosted Lite](./self_hosted.md): A free (up to 1 million nodes executed), limited version of LangGraph Platform that you can run locally or in a self-hosted manner +- [Cloud SaaS](./langgraph_cloud.md): Hosted as part of LangSmith. +- [Bring Your Own Cloud](./bring_your_own_cloud.md): We manage the infrastructure, so you don't have to, but the infrastructure all runs within your cloud. +- [Self-Hosted Enterprise](./self_hosted.md): Completely managed by you. \ No newline at end of file diff --git a/docs/docs/concepts/plans.md b/docs/docs/concepts/plans.md new file mode 100644 index 000000000..49b98ee11 --- /dev/null +++ b/docs/docs/concepts/plans.md @@ -0,0 +1,39 @@ +# LangGraph Platform Plans + + +## Overview +LangGraph Platform is a commercial solution for deploying agentic applications in production. +There are three different plans for using it. + +- **Developer**: All [LangSmith](https://smith.langchain.com/) users have access to this plan. You can sign up for this plan simply by creating a LangSmith account. This gives you access to the [Self-Hosted Lite](./deployment_options.md#self-hosted-lite) deployment option. +- **Plus**: All [LangSmith](https://smith.langchain.com/) users with a [Plus account](https://docs.smith.langchain.com/administration/pricing) have access to this plan. You can sign up for this plan simply by upgrading your LangSmith account to the Plus plan type. This gives you access to the [Cloud](./deployment_options.md#cloud-saas) deployment option. +- **Enterprise**: This is separate from LangSmith plans. You can sign up for this plan by contacting sales@langchain.dev. This gives you access to all deployment options: [Cloud](./deployment_options.md#cloud-saas), [Bring-Your-Own-Cloud](./deployment_options.md#bring-your-own-cloud), and [Self Hosted Enterprise](./deployment_options.md#self-hosted-enterprise) + + +## Plan Details + +| | Developer | Plus | Enterprise | +|------------------------------------------------------------------|---------------------------------------------|-------------------------------------------------------|-----------------------------------------------------| +| Deployment Options | Self-Hosted Lite | Cloud | Self-Hosted Enterprise, Cloud, Bring-Your-Own-Cloud | +| Usage | Free, limited to 1M nodes executed per year | Free while in Beta, will be charged per node executed | Custom | +| APIs for retrieving and updating state and conversational history | ✅ | ✅ | ✅ | +| APIs for retrieving and updating long-term memory | ✅ | ✅ | ✅ | +| Horizontally scalable task queues and servers | ✅ | ✅ | ✅ | +| Real-time streaming of outputs and intermediate steps | ✅ | ✅ | ✅ | +| Assistants API (configurable templates for LangGraph apps) | ✅ | ✅ | ✅ | +| Cron scheduling | -- | ✅ | ✅ | +| LangGraph Studio for prototyping | Desktop only | Coming Soon! | Coming Soon! | +| Authentication & authorization to call the LangGraph APIs | -- | Coming Soon! | Coming Soon! | +| Smart caching to reduce traffic to LLM API | -- | Coming Soon! | Coming Soon! | +| Publish/subscribe API for state | -- | Coming Soon! | Coming Soon! | +| Scheduling prioritization | -- | Coming Soon! | Coming Soon! | + +Please see the [LangGraph Platform Pricing](https://www.langchain.com/langgraph-platform-pricing) for information on pricing. + +## Related + +For more information, please see: + +* [Deployment Options conceptual guide](./deployment_options.md) +* [LangGraph Platform Pricing](https://www.langchain.com/langgraph-platform-pricing) +* [LangSmith Plans](https://docs.smith.langchain.com/administration/pricing) diff --git a/docs/docs/concepts/self_hosted.md b/docs/docs/concepts/self_hosted.md new file mode 100644 index 000000000..b9123b51a --- /dev/null +++ b/docs/docs/concepts/self_hosted.md @@ -0,0 +1,35 @@ +# Self-Hosted + +!!! note Prerequisites + + - [LangGraph Platform](./langgraph_platform.md) + - [Deployment Options](./deployment_options.md) + +## Versions + +There are two versions of the self hosted deployment: [Self-Hosted Enterprise](./deployment_options.md#self-hosted-enterprise) and [Self-Hosted Lite](./deployment_options.md#self-hosted-lite). + +### Self-Hosted Lite + +The Self-Hosted Lite version is a limited version of LangGraph Platform that you can run locally or in a self-hosted manner (up to 1 million nodes executed). + +When using the Self-Hosted Lite version, you authenticate with a [LangSmith](https://smith.langchain.com/) API key. + +### Self-Hosted Enterprise + +The Self-Hosted Enterprise version is the full version of LangGraph Platform. + +To use the Self-Hosted Enterprise version, you must acquire a license key that you will need to pass in when running the Docker image. To acquire a license key, please email sales@langchain.dev. + +## Requirements + +- You use `langgraph-cli` and/or [LangGraph Studio](./langgraph_studio.md) app to test graph locally. +- You use `langgraph build` command to build image. + +## How it works + +- Deploy Redis and Postgres instances on your own infrastructure. +- Build the docker image for [LangGraph Server](./langgraph_server.md) using the [LangGraph CLI](./langgraph_cli.md) +- Deploy a web server that will run the docker image and pass in the necessary environment variables. + +See the [how-to guide](../how-tos/deploy-self-hosted.md) diff --git a/docs/docs/how-tos/deploy-self-hosted.md b/docs/docs/how-tos/deploy-self-hosted.md index d1454c07f..93f2771d8 100644 --- a/docs/docs/how-tos/deploy-self-hosted.md +++ b/docs/docs/how-tos/deploy-self-hosted.md @@ -14,7 +14,7 @@ With the self-hosted deployment option, you are responsible for managing the inf You will need to do the following: 1. Deploy Redis and Postgres instances on your own infrastructure. -2. Build a docker image with the LangGraph Deploy server using the LangGraph CLI. +2. Build a docker image with the [LangGraph Sever](../concepts/langgraph_server.md) using the [LangGraph CLI](../concepts/langgraph_cli.md). 3. Deploy a web server that will run the docker image and pass in the necessary environment variables. ## Environment Variables @@ -23,7 +23,8 @@ You will eventually need to pass in the following environment variables to the L - `REDIS_URI`: Connection details to a Redis instance. Redis will be used as a pub-sub broker to enable streaming real time output from background runs. - `DATABASE_URI`: Postgres connection details. Postgres will be used to store assistants, threads, runs, persist thread state and long term memory, and to manage the state of the background task queue with 'exactly once' semantics. -- `LANGSMITH_API_KEY`: LangSmith API key. This will be used to authenticate ONCE at server start up. +- `LANGSMITH_API_KEY`: (If using [Self-Hosted Lite]) LangSmith API key. This will be used to authenticate ONCE at server start up. +- `LANGGRAPH_CLOUD_LICENSE_KEY`: (If using Self-Hosted Enterprise) LangGraph Platform license key. This will be used to authenticate ONCE at server start up. ## Build the Docker Image @@ -67,6 +68,8 @@ If you want to run this quickly without setting up a separate Redis and Postgres * You need to replace `my-image` with the name of the image you built in the previous step (from `langgraph build`). and you should provide appropriate values for `REDIS_URI`, `DATABASE_URI`, and `LANGSMITH_API_KEY`. * If your application requires additional environment variables, you can pass them in a similar way. + * If using Self-Hosted Enterprise, you must provide `LANGGRAPH_CLOUD_LICENSE_KEY` as an additional environment variable. + ### Using Docker Compose