Skip to main content
Create an Agent Server on LangSmith Cloud from a connected GitHub repository or directly from your local project. The LangSmith UI deploys from GitHub. The langgraph deploy CLI builds locally or triggers a remote build.
For a shorter walkthrough, see the deployment quickstart.

Prerequisites

Create an Agent Server

A GitHub organization owner or admin must authorize LangChain’s hosted-langserve GitHub app once for the workspace. After authorization, any user with deployment permissions can create Agent Servers from repositories that the app can access.To create an Agent Server:
  1. From the LangSmith UI, select Agent Servers.
  2. In the top-right corner, select + Agent Server.
  3. If the Source selector appears, select GitHub repository rather than Docker image. Complete the GitHub authorization flow if prompted.
  4. Select a repository.
  5. Enter a name for the Agent Server.
  6. In Git Ref (Branch or Tag), enter a branch name or a full tag ref such as refs/tags/v1.0.0.
  7. Enter the full path to the LangGraph API configuration file, including the file name. For example, enter langgraph.json if the file is in the repository root.
  8. For a branch, choose whether to enable Automatically update Agent Server on push to branch. This option is unavailable for tags. You can change it later in Agent Server Settings.
  9. For Agent Server type, select Serverless or Dedicated, depending on whether the workload can tolerate cold starts or needs always-on capacity.
  10. Choose whether to make the Agent Server shareable through Studio.
  11. Add environment variables and secrets. For more information, see Environment variables.
  12. Select Submit. LangSmith queues the Agent Server for provisioning. In a project-based workspace, LangSmith also creates a tracing project with the same name as the Agent Server. In an agent-based workspace, LangSmith instead binds the Agent Server to an agent, and the Agent Server reports into one of the agent’s environments.
The GitHub user who authorizes the hosted-langserve app must own the GitHub organization or account. Other users with deployment permissions do not need GitHub administrator access after the initial authorization.

Manage GitHub repository access

After you authorize the hosted-langserve GitHub app, configure which repositories it can access:
  1. In GitHub, go to Settings > Applications.
  2. Find hosted-langserve, then select Configure.
  3. Under Repository access, select All repositories or Only select repositories.
  4. If you selected Only select repositories, add or remove repositories as needed.
  5. Select Save.
The repository list in the Create Agent Server pane reflects the updated access. If you rename or transfer a repository that an Agent Server uses, change the Agent Server’s repository.

See also