Add BSD-3-Clause license and clarify modern editable installs

Author: rsgalloway

.github/workflows/tests.yml

@@ -13,6 +13,7 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python }}
+      - run: python -m pip install --upgrade pip
       - run: python -m pip install '.[dev]'
       - run: python -m pytest
       - run: python -m build

.gitignore

@@ -1,7 +1,7 @@
 __pycache__/
 *.py[cod]
 .pytest_cache/
-.venv/
+.venv*/
 .env
 .env.*
 build/

LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Ryan Galloway
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -6,19 +6,36 @@ BYO workers belong in the separate worker package, not this client.
 
 ## Development install
 
-Requires Python 3.10+.
+Requires Python 3.10+ and a modern pip (21.3+ for editable installs).
+Use a supported interpreter explicitly; the system `python3` may be older.
 
 ```bash
-python -m venv .venv
+python3.12 -m venv .venv
 source .venv/bin/activate
-pip install -e '.[dev]'
+python -m pip install --upgrade pip
+python -m pip install -e '.[dev]'
 pytest
 python -m build
 python -m twine check dist/*
 ```
 
-A package license must be selected before the first public release. CI builds and
-checks distributions but does not publish them.
+If pip reports that editable mode requires `setup.py`, check `python --version`
+and `python -m pip --version`. Python 3.8 is unsupported. Create a new environment
+with Python 3.10+ and upgrade pip there; upgrading pip alone cannot change its
+Python interpreter. A `setup.py` compatibility shim is not needed.
+
+With [uv](https://docs.astral.sh/uv/), a supported Python can also be provisioned
+without changing the system Python. Preserve an existing environment by using a
+new directory:
+
+```bash
+uv venv --python 3.12 .venv312
+source .venv312/bin/activate
+uv pip install -e '.[dev]'
+```
+
+Licensed under [BSD-3-Clause](LICENSE). CI builds and checks distributions but does
+not publish them.
 
 ## Usage
 

pyproject.toml

@@ -7,6 +7,8 @@ name = "subfork"
 version = "0.1.0a1"
 description = "Python API client for Subfork graph authoring and execution"
 readme = "README.md"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
 requires-python = ">=3.10"
 dependencies = ["httpx>=0.28,<1"]
 classifiers = [