feat: update readme, add license

Author: gadomski

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Development Seed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,3 +1,39 @@
 # stac-fastapi-geoparquet
 
-TODO
+A [stac-fastapi](https://github.com/stac-utils/stac-fastapi) with a [stac-geoparquet](https://github.com/stac-utils/stac-geoparquet/blob/main/spec/stac-geoparquet-spec.md) backend.
+
+**stac-fastapi-geoparquet** can serve a full-featured STAC API from a **stac-geoparquet** file located (e.g.) in blob storage — no database required!
+
+> [!WARNING]
+> This project is under active development 👷 and may change and break at any time.
+
+## Usage
+
+To start a STAC API server pointing to a single **stac-geoparquet** file:
+
+```shell
+$ python -m pip install 'stac-fastapi-geoparquet[serve]'
+$ STAC_FASTAPI_GEOPARQUET_HREF=data/naip.parquet uvicorn stac_fastapi.geoparquet.main:app
+INFO:     Started server process [47920]
+INFO:     Waiting for application startup.
+INFO:     Application startup complete.
+INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+To explore the API, you can use [stac browser](https://radiantearth.github.io/stac-browser/#/external/http:/127.0.0.1:8000/?.language=en).
+
+## Development
+
+Get [uv](https://docs.astral.sh/uv/getting-started/installation/), then:
+
+```shell
+git clone [email protected]:stac-utils/stac-fastapi-geoparquet.git
+cd stac-fastapi-geoparquet
+uv sync
+```
+
+To run the tests:
+
+```shell
+uv run pytest
+```

pyproject.toml

@@ -17,6 +17,7 @@ dependencies = [
 
 [project.optional-dependencies]
 lambda = ["mangum==0.19.0"]
+serve = ["uvicorn>=0.34.0"]
 
 [dependency-groups]
 dev = [