Deploy your app to cloud

This quickstart shows you how to deploy an application to LangSmith Cloud using the langgraph deploy command.

For a comprehensive Cloud deployment guide including GitHub-based deployments and all configuration options, refer to the Cloud deployment setup guide.

The langgraph deploy command is in beta.

Prerequisites

Before you begin, ensure you have:

A LangSmith account on the Plus plan or above and an API key.
Docker installed and running. Verify with docker ps.
On Apple Silicon (M1/M2/M3): Docker Buildx for cross-compiling to linux/amd64.
The LangGraph CLI:
```
uv tool install langgraph-cli
```

1. Create a LangGraph app

Create a new app from the new-langgraph-project-python template:

langgraph new path/to/your/app --template new-langgraph-project-python
cd path/to/your/app

Run langgraph new without --template for an interactive menu of available templates.

2. Set your API key

Add your LangSmith API key to a .env file in your project root:

LANGSMITH_API_KEY=lsv2_...

The langgraph deploy command reads this automatically. Alternatively, pass it inline:

LANGSMITH_API_KEY=lsv2_... langgraph deploy

3. Deploy

Run the deploy command from your project directory:

langgraph deploy

This creates a dev deployment named after your project directory by default. Use --name or --deployment-type prod to override.

To update an existing deployment after making code changes, re-run langgraph deploy. It finds the existing deployment by name and updates it in place.

You can also use langgraph deploy list to see all deployments, langgraph deploy logs to tail runtime logs, and langgraph deploy delete <ID> to remove a deployment. For details, refer to the CLI reference.

4. Test in Studio

Studio is an interactive agent IDE connected directly to your deployment. Use it to send messages, inspect intermediate state at each node, edit state mid-run, and replay from any prior checkpoint without writing code. Once the deployment is ready:

Go to LangSmith and select Deployments in the left sidebar.
Select your deployment to view its details.
Click Studio in the top right corner to open Studio.

5. Test the API

Copy the API URL from the deployment details view, then use it to call your application:

Python SDK (Async)
Python SDK (Sync)
JavaScript SDK
Rest API

Install the LangGraph Python SDK:
```
pip install langgraph-sdk
```

Send a message to the assistant (stateless run):

from langgraph_sdk import get_client

client = get_client(url="your-deployment-url", api_key="your-langsmith-api-key")

async for chunk in client.runs.stream(
    None,  # Threadless run
    "agent", # Name of assistant. Defined in langgraph.json.
    input={
        "messages": [{
            "role": "human",
            "content": "What is LangGraph?",
        }],
    },
    stream_mode="updates",
):
    print(f"Receiving new event of type: {chunk.event}...")
    print(chunk.data)
    print("\n\n")

Install the LangGraph Python SDK:
```
pip install langgraph-sdk
```

Send a message to the assistant (threadless run):

from langgraph_sdk import get_sync_client

client = get_sync_client(url="your-deployment-url", api_key="your-langsmith-api-key")

for chunk in client.runs.stream(
    None,  # Threadless run
    "agent", # Name of assistant. Defined in langgraph.json.
    input={
        "messages": [{
            "role": "human",
            "content": "What is LangGraph?",
        }],
    },
    stream_mode="updates",
):
    print(f"Receiving new event of type: {chunk.event}...")
    print(chunk.data)
    print("\n\n")

Install the LangGraph JS SDK:
```
npm install @langchain/langgraph-sdk
```

Send a message to the assistant (threadless run):

const { Client } = await import("@langchain/langgraph-sdk");

const client = new Client({ apiUrl: "your-deployment-url", apiKey: "your-langsmith-api-key" });

const streamResponse = client.runs.stream(
    null, // Threadless run
    "agent", // Assistant ID
    {
        input: {
            "messages": [
                { "role": "user", "content": "What is LangGraph?"}
            ]
        },
        streamMode: "messages",
    }
);

for await (const chunk of streamResponse) {
    console.log(`Receiving new event of type: ${chunk.event}...`);
    console.log(JSON.stringify(chunk.data));
    console.log("\n\n");
}

curl -s --request POST \
    --url <DEPLOYMENT_URL>/runs/stream \
    --header 'Content-Type: application/json' \
    --header "X-Api-Key: <LANGSMITH API KEY>" \
    --data "{
        \"assistant_id\": \"agent\",
        \"input\": {
            \"messages\": [
                {
                    \"role\": \"human\",
                    \"content\": \"What is LangGraph?\"
                }
            ]
        },
        \"stream_mode\": \"updates\"
    }"

Next steps

Assistants

Deploy the same graph with different models, prompts, or tools per assistant.

Threads

Persist state across multiple runs so your agent remembers context between interactions.

Runs

Kick off background runs for long-running jobs and stream results back to your client.

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.

Agent server

Core capabilities

Develop agents

Deployment guides

Studio

Auth & access control

Server customization

Prerequisites

1. Create a LangGraph app

2. Set your API key

3. Deploy

4. Test in Studio

5. Test the API

Next steps

Assistants

Threads

Runs

Agent server

Core capabilities

Develop agents

Deployment guides

Studio

Auth & access control

Server customization

Documentation Index

​Prerequisites

​1. Create a LangGraph app

​2. Set your API key

​3. Deploy

​4. Test in Studio

​5. Test the API

​Next steps

Assistants

Threads

Runs

Prerequisites

1. Create a LangGraph app

2. Set your API key

3. Deploy

4. Test in Studio

5. Test the API

Next steps