Python version selection

Without --python, quickstart uses the newest usable Python installation marked publishable for new content on the selected Posit Connect server. It writes a >=major.minor requirement and asks uv to create the environment with that major/minor. uv may download Python according to your uv settings. Server selection and credentials use the usual --name, --server, --api-key, TLS options, environment variables, and saved servers.

If no server is configured, quickstart uses the Python interpreter running rsconnect. If the server cannot be queried or credentials are missing, it warns and uses that interpreter without checking server compatibility. If a successful lookup finds no usable publishable Python, quickstart fails: check the server's Python configuration or use --python. A failed Python download or dependency installation also fails and removes the incomplete project. If several servers are saved without a default, select one with --name or --server, or set a default. Invalid server nicknames and CA certificate paths are errors.

--python overrides discovery and makes no server request. A major/minor version permits any patch release, a full version is exact, and a specifier such as >=3.10,<3.13 is used as supplied. Explicit server options are ignored when --python is supplied.

quickstart

Create a new Posit Connect project of the given TYPE in .//. Supported TYPE values: streamlit, shiny, fastapi, api, flask, notebook, voila, quarto. Writes a pyproject.toml with a [tool.posit.connect] section, creates a uv-managed virtualenv, and prints the local-run and deploy commands.

Usage:

quickstart [OPTIONS] TYPE NAME

Options:

  -n, --name TEXT     The nickname of the Posit Connect server to deploy to.
  -s, --server TEXT   The URL for the Posit Connect server to deploy to. (Also
                      settable via CONNECT_SERVER environment variable.)
  -k, --api-key TEXT  The API key to use to authenticate with Posit Connect.
                      (Also settable via CONNECT_API_KEY environment
                      variable.)
  -i, --insecure      Disable TLS certification/host validation. (Also
                      settable via CONNECT_INSECURE environment variable.)
  -c, --cacert FILE   The path to trusted TLS CA certificates. (Also settable
                      via CONNECT_CA_CERTIFICATE environment variable.)
  -v, --verbose       Enable verbose output. Use -vv for very verbose (debug)
                      output.
  --python VERSION    Python version for 'requires-python' in the generated
                      pyproject.toml. A bare 'major.minor' like '3.10' means
                      any 3.10.x; a full '3.11.14' is exact; pass an operator
                      for full control (e.g. '>=3.11' or '>=3.11,<3.14'). By
                      default, use the newest publishable Python on the
                      selected Connect server, or the interpreter running
                      rsconnect.
  --help              Show this message and exit.