Doc fixing

.github/workflows/pypi_release.yaml

@@ -0,0 +1,31 @@
+name: PYPI Release
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+
+jobs:
+  pypi_release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install UV
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+
+      - name: Source Cargo Environment
+        run: source $HOME/.cargo/env
+
+      - name: Build with UV
+        run: uvx --from build pyproject-build --installer uv
+
+      - name: Publish
+        uses: pypa/[email protected]
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_TOKEN_TEMP }}
+          packages_dir: ./dist/

CONTRIBUTING.md

@@ -5,11 +5,12 @@ to develop a fix, we recommend you open an issue before starting.
 
 ## Prerequisites
 
-*goose* uses [uv][uv] for dependency management, and formats with [ruff][ruff].
-
 We provide a shortcut to standard commands using [just][just] in our `justfile`.
 
-## Developing
+* *goose* uses [uv][uv] for dependency management, and formats with [ruff][ruff].
+* check out both this repository as well as https://github.com/squareup/goose next to it. 
+
+## Developing and testing
 
 Now that you have a local environment, you can make edits and run our tests. 
 
@@ -23,6 +24,14 @@ or, as a shortcut,
 just test
 ```
 
+## Running goose from source
+
+`uv run goose session start`
+
+will run a fresh goose session (can use the usual goose commands with `uv run` prefixed)
+
+
+
 ## Evaluations
 
 Given that so much of *goose* involves interactions with LLMs, our unit tests only go so far to

README.md

@@ -163,5 +163,7 @@ This requires `DATABRICKS_HOST` and `DATABRICKS_TOKEN` to be set accordingly
 Yes, goose is open source and always will be. goose is released under the ASL2.0 license meaning you can use it however you like. 
 See LICENSE.md for more details.
 
+To run goose from open source, please see `CONTRIBUTING.md` for instructions on how to set up your environment and you can then run `uv run goose session start`.
+
 
 [pipx]: https://github.com/pypa/pipx?tab=readme-ov-file#install-pipx

pyproject.toml

@@ -8,7 +8,7 @@ dependencies = [
     "attrs>=23.2.0",
     "rich>=13.7.1",
     "ruamel-yaml>=0.18.6",
-    "exchange>=0.7.6",
+    "ai-exchange>=0.8.0",
     "click>=8.1.7",
     "prompt-toolkit>=3.0.47",
 ]