pip install from git source fails: pyproject.toml is in Gradata/ subdirectory

[Gradata]

Problem

pip install git+https://github.com/Gradata/gradata.git fails with:

error: Multiple top-level packages discovered in a flat-layout: ...
does not appear to be a Python project: neither 'setup.py' nor 'pyproject.toml' found

The Python package's pyproject.toml lives in the Gradata/ subdirectory, not at repo root. The working URL is:

pip install git+https://github.com/Gradata/gradata.git#subdirectory=Gradata

Why this matters

The gradata-plugin one-liner installer (gradata-plugin#5) needs to install the SDK from git source until PyPI publish lands. Every new user pasting the curl|sh installer hits this. Currently working around it with the #subdirectory=Gradata URL fragment.

Suggested fixes (pick one)

A) Move pyproject.toml to repo root — most user-friendly, makes the naïve URL work. Requires updating CI paths and any tooling that assumes Gradata/ layout.

B) Document the subdirectory requirement prominently in README — minimal change, but keeps the friction.

C) Add a stub pyproject.toml at root that points to the subdirectory — middle ground.

Repro

python3 -m venv /tmp/v && /tmp/v/bin/pip install git+https://github.com/Gradata/gradata.git
# fails

/tmp/v/bin/pip install 'git+https://github.com/Gradata/gradata.git#subdirectory=Gradata'
# works, installs gradata 0.7.5

Verified 2026-05-07.