uv-research-workspace

Manage Python research projects with uv workspaces and Git sub-repositories.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/ryan-ressmeyer/llm-skills --skill uv-research-workspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uv-research-workspace
Source: https://github.com/ryan-ressmeyer/llm-skills/tree/main/uv-research-workspace
Command: npx skills add https://github.com/ryan-ressmeyer/llm-skills --skill uv-research-workspace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the management of complex Python research projects by enabling the use of uv workspaces, which allow multiple Git sub-repositories to share a single virtual environment, promoting modularity and reproducibility.

Core Features & Use Cases

  • Shared Environment: All sub-repositories within the workspace utilize a single .venv for dependency management.
  • Modularity and Reusability: Encourages splitting code into independent, reusable Git repositories.
  • Reproducibility: Ensures consistent dependency locking across all parts of the project.
  • Use Case: Setting up a new multi-repository Python project where different components (e.g., data processing, analysis scripts, utility functions) are managed as separate Git repositories but share a unified development environment.

Quick Start

Create a new uv workspace for your research project by initializing a root directory and configuring its pyproject.toml file.

Frequently Asked Questions about uv-research-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage dependencies across multiple Python Git submodules in a monorepo?

uv workspaces allow multiple Git sub-repositories to share a single virtual environment, enabling unified dependency management and consistent locking across independent yet interconnected codebases within a monorepo.

How do I set up a shared virtual environment for multiple Python research repositories?

To set up a shared virtual environment, initialize a root directory with uv, configure its pyproject.toml to define the workspace, and use uv sync to link all sub-repositories into one unified .venv.

Does uv workspaces support cross-repo dependencies for independent Python packages?

Yes, uv workspaces support cross-repo dependencies by using dual dependency patterns, allowing independent Python packages within the monorepo to reference each other while utilizing the shared virtual environment.

What is the best way to modularize a Python research project with reusable Git repositories?

Using uv workspaces is an effective way to modularize Python research projects, splitting code into independent, reusable Git repositories that share a single virtual environment to ensure reproducibility.

Can I use uv sync to handle dependency locking for multiple interconnected Python codebases?

Yes, you can use uv sync to handle dependency locking for multiple interconnected Python codebases, ensuring consistent reproducible dependency resolution across all sub-repositories within the workspace.