> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langchain.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Develop locally with LangSmith Studio

> Run and test a Managed Deep Agent locally with mda dev and LangSmith Studio.

`mda dev` compiles a Managed Deep Agents project and runs it on a local Agent Server. It opens [LangSmith Studio](/langsmith/studio) so you can interact with the agent and inspect its behavior before deploying.

<Note>
  Managed Deep Agents is in **public [beta](/langsmith/release-stages)** and available on [LangSmith Cloud](/langsmith/cloud) in the US region only.
</Note>

## Start local Studio

Install the project dependencies and add the model provider credentials to `.env`.

Python projects also require [`uv`](https://docs.astral.sh/uv/).

From the project root, run:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
mda dev .
```

The CLI prints the local server and Studio URLs and opens Studio in your browser. Send messages in Studio to inspect model responses, tool calls, state, and interrupts.

After changing project files, stop and rerun `mda dev` to recompile the project.

## What `mda dev` does

`mda dev`:

1. Validates the project and compiles it into `.mda/build`.
2. Copies the project `.env` into the local build and adds local-only identity configuration when needed.
3. Creates a local Context Hub mock for instructions, skills, and memory.
4. Starts the language-specific LangGraph development server.
5. Opens the agent in Studio.

Local development does not create or update a hosted deployment.

## Configure the local server

| Flag                  | Use                                                    |
| --------------------- | ------------------------------------------------------ |
| `--port PORT`         | Set the local server port.                             |
| `--hostname HOSTNAME` | Set the hostname on which the server listens.          |
| `--no-browser`        | Start the server without opening Studio automatically. |
| `--no-reload`         | Disable the LangGraph development server's hot reload. |

For all command details, see the [`mda dev` CLI reference](/langsmith/python/managed-deep-agents-cli#develop-locally).

## Understand local behavior

`mda dev` uses local defaults to make testing easier:

* If the agent uses identity, Studio provides a local test user automatically.
* If the configured sandbox is unavailable, the agent uses a temporary local folder instead. The CLI prints the folder path.

These defaults differ from a deployed agent. Test identity and sandbox behavior in a development deployment before using the agent in production.

***

<div className="source-links">
  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
  </Callout>

  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/langsmith/managed-deep-agents-local-development.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>