---
title: "Map Python import graphs to explain coupling before refactors or package splits with pydeps"
description: "Generate Python module dependency graphs so refactors and package splits start from an actual import map instead of guesswork."
verification: "listed"
source: "https://github.com/thebjorn/pydeps"
author: "thebjorn"
publisher_type: "individual"
category:
  - "Code Quality & Review"
framework:
  - "Multi-Framework"
tool_ecosystem:
  github_repo: "thebjorn/pydeps"
  github_stars: 2076
---

# Map Python import graphs to explain coupling before refactors or package splits with pydeps

Generate Python module dependency graphs so refactors and package splits start from an actual import map instead of guesswork.

## Prerequisites

Python, Graphviz, a local Python codebase to analyze.

## Installation

Choose whichever fits your setup:

1. Copy this skill folder into your local skills directory.
2. Clone the repo and symlink or copy the skill into your agent workspace.
3. Add the repo as a git submodule if you manage shared skills centrally.
4. Install it through your internal provisioning or packaging workflow.
5. Download the folder directly from GitHub and place it in your skills collection.

Install command or upstream instructions:

```
Install with pip install pydeps, then install Graphviz so the dot command is available on PATH.
```

## Documentation

- https://github.com/thebjorn/pydeps

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/map-python-import-graphs-to-explain-coupling-before-refactors-or-package-splits-with-pydeps/)