Streamlining Multi-Project Python Development
Teams and open-source projects increasingly adopt workspaces to manage shared code, enforce consistency, and simplify dependency handling across multiple services. Large codebases often involve several interdependent Python projects, making coordination a challenge. Recognizing this, PyCharm 2026.1.1 brings built-in support for uv, Poetry, and Hatch workspaces — currently in Beta. This enhancement allows the IDE to automatically manage dependencies and environments across your entire workspace, reducing manual overhead.
Intelligent Workspace Detection
When you open a workspace, PyCharm can now derive its full structure and all dependencies directly from pyproject.toml files. This deep understanding of project relationships minimizes the configuration you need to perform manually.
Because this represents a fundamental shift in how PyCharm processes workspaces, the feature is opt-in. Here’s what you should know during the transition:
- Opt-in dialog: Upon opening a project, PyCharm may suggest enabling automatic detection for uv workspaces and Poetry/Hatch setups.
- Manual configuration: You can toggle workspace detection in Settings | Project Structure.
- Configuration note: If you previously modified settings in
.ideafiles, those settings may be reset when you accept the new model.
Managing Workspaces and Their Projects
PyCharm now offers an integrated experience that automatically handles the complexities of multi-package setups in uv workspaces. When you open a uv workspace, the IDE identifies individual projects and their interdependencies, preparing the project structure for immediate work.
Visualizing Workspace Dependencies
Once loaded, you can verify how your projects relate to each other. PyCharm displays these dependencies in Settings | Project Dependencies. The relationships are derived directly from your configuration and are shown as read-only in the UI. To modify the dependency graph, edit the pyproject.toml file manually — PyCharm updates its internal model accordingly.
Automatic Environment Configuration
PyCharm prioritizes a zero-config approach for your Python SDK. When you open a .py or pyproject.toml file within a project, the IDE immediately checks for a compatible environment. If one exists on your system, PyCharm configures it as the SDK for that project automatically. If no environment is detected, a file-level notification suggests creating a new uv environment and installing the necessary dependencies.
Maintaining Environment Consistency
Beyond initial setup, PyCharm continuously monitors your environment to ensure it stays synchronized with your defined requirements. If a dependency changes in pyproject.toml, the IDE alerts you and offers to update the environment. This proactive approach helps prevent version conflicts and keeps your workspace stable.
Getting Started with the Beta
To try the new workspace support, ensure you are using PyCharm 2026.1.1 or later. Open a project that uses uv, Poetry, or Hatch, and follow the opt-in prompts. For existing workspaces, review your .idea settings before enabling the feature. Feedback is welcome via the official channels to help refine the functionality before full release.
This beta release marks a significant step in simplifying modern Python development workflows. By automating detection, dependency visualization, and environment management, PyCharm reduces the cognitive load of managing multiple projects — letting you focus on code.