pycontrol-init 0.1.0a0

uvx bootstrapper for creating pyControl workspaces.

pycontrol-init

pycontrol-init is a small uvx bootstrapper for creating uv-backed pyControl workspaces.

Install uv, then create and launch a workspace:

uvx --python 3.11 --prerelease allow pycontrol-init my-workspace --launch

To initialize the current directory instead:

uvx --python 3.11 --prerelease allow pycontrol-init . --launch

The command creates the target directory when needed, initializes a uv project, adds pycontrol-gui, scaffolds the standard workspace layout, and optionally launches the GUI.

Usage

pycontrol-init [path] [--launch] [--force]

path defaults to the current directory. Relative paths are resolved from the directory where the command is run.

Examples:

pycontrol-init
pycontrol-init .
pycontrol-init my-workspace --launch
pycontrol-init ~/pycontrol-workspaces/ws1 --with-slack

Optional integration helpers can be installed into the workspace:

pycontrol-init my-workspace --with-slack
pycontrol-init my-workspace --with-notion
pycontrol-init my-workspace --with-s3
pycontrol-init my-workspace --with-integrations

For release smoke tests, package indexes can be overridden:

pycontrol-init test-workspace \
  --index-url https://test.pypi.org/simple/ \
  --extra-index-url https://pypi.org/simple/

Development

uv sync --group dev
uv run pytest
uv run ruff check src tests