---
id: pydevd
version: "3.5.0"
license: EPL
license_treatment: copyleft
maintenance: active
---

# pydevd — PyDev.Debugger (used in PyDev, PyCharm and VSCode Python)

License: copyleft · Maintenance: active · Downloads: 1.4M/mo

## What it is and what it does

pydevd is the debugger backend used internally by PyDev (Eclipse), PyCharm, VSCode Python extensions, and other IDEs. It provides interactive debugging capabilities including breakpoints, stepping, and variable inspection. The package is typically bundled by these IDEs, but it's also available on PyPI for standalone installation to enable remote debugging scenarios—where you install it on a remote machine and connect it back to a debugger UI running in your local IDE.

The debugger supports Python 3.8 onwards on CPython and PyPy, with recent versions including Cython-based speedup modules and optimized tracing via sys.monitoring on Python 3.12. It's mature, actively maintained, and has no known security vulnerabilities. Most developers encounter it indirectly through their IDE; direct installation is primarily useful for remote debugging workflows where manual setup is required.

Use it for:

- Debug Python code running on a remote server by installing pydevd there and connecting to your local IDE.
- Set up interactive debugging in containerized or cloud environments where the debugger backend must be installed separately.
- Debug long-running processes or background jobs that cannot easily be run locally.
- Integrate debugging into custom Python applications or scripts that need IDE-level debugging without bundling a full IDE.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

pydevd is a Python debugger backend that attaches to running processes for interactive debugging, with support for remote debugging across machines and optimized tracing on Python 3.12 via sys.monitoring.

Yes, if you need remote debugging or are building a custom debugging setup. No, if you're using PyCharm, VSCode, or PyDev—these IDEs bundle pydevd already. Install only when you explicitly need the debugger backend on a machine separate from your IDE, or when setting up remote debugging infrastructure.

## Install

pip install pydevd
uv add pydevd
poetry add pydevd

## Installing pydevd

Before you install: Medium install friction due to compiled wheels for multiple Python versions and platforms. The project is actively maintained with recent commits and no known vulnerabilities, though it's typically bundled by IDEs rather than installed standalone.

License in practice: Licensed under EPL (Eclipse Public License 1.0), a copyleft license. Users can use and modify the code freely, but modifications and derivative works must be distributed under the same license terms.

Quickstart:

pip install pydevd

import pydevd
pydevd.settrace(host="10.1.1.1")  # Connect to remote debugger
# or for VSCode DAP protocol:
pydevd.settrace(host="10.1.1.1", protocol="dap")

Requires Python 3.8 or later; for Python 3.3–3.7 use pydevd 2.10.0; for Python 2 use pydevd 2.8.0.

Verify before relying:

- Whether sys.monitoring on Python 3.12 provides measurably faster tracing compared to earlier versions in real-world debugging scenarios.
- Exact performance characteristics and overhead when used with PyPy versus CPython.
- Whether the package can be used standalone for local debugging or is primarily intended for remote scenarios.

## Package facts

- License: EPL (copyleft)
- Python support: unspecified
- Install friction: medium
- Maintenance: active
- Downloads: 1.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python debugger backend, remote debugging python, attach debugger to process, python sys.monitoring debugger, interactive python debugging, debugger for pycharm vscode, python process debugging, debugger, remote-debugging, ide-backend

[View on SkillFed](https://skillfed.io/packages/pydevd) · [View on PyPI](https://pypi.org/project/pydevd/)