Add release-related CI and make minor docs tweaks

.github/release.yml

@@ -0,0 +1,14 @@
+changelog:
+  exclude:
+    labels:
+      - internal
+  categories:
+    - title: Breaking Changes
+      labels:
+        - breaking
+    - title: Features
+      labels:
+        - feature
+    - title: Fixes
+      labels:
+        - fix

.github/workflows/changelog-label.yml

@@ -0,0 +1,19 @@
+name: Changelog label
+
+"on":
+  pull_request:
+    types: [opened, reopened, synchronize, labeled, unlabeled]
+
+permissions:
+  pull-requests: read
+
+jobs:
+  changelog-label:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: mheap/github-action-required-labels@v5
+        with:
+          mode: exactly
+          count: 1
+          labels: breaking, feature, fix, internal
+          message: "Label this PR with exactly one of: `breaking`, `feature`, `fix`, `internal` (see CONTRIBUTING.md). Release notes are generated from these labels; use `internal` for changes that should not appear in them."

CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+Release notes live on GitHub:
+https://github.com/vercel-labs/ai-python/releases
+
+`ai` is in public beta starting with 0.3.0 .

CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+We're not accepting community pull requests at this time.
+Bug reports and ideas are very welcome: please open an issue or start a discussion instead.
+
+## Releasing
+
+Every PR needs to be labeled as `breaking`, `feature`, `fix`, or
+`internal`. Release notes are generated from those labels.
+
+1. Draft the release:
+
+   ```bash
+   gh release create vX.Y.Z --generate-notes --draft
+   ```
+
+2. Review the draft on GitHub and add migration notes under **Breaking Changes**.
+3. Publish the release. This creates the tag, which triggers
+   `.github/workflows/publish.yml` and uploads the package to PyPI.
+
+GitHub release notes are the changelog of record; `CHANGELOG.md` only holds
+a pointer.

README.md

@@ -2,6 +2,9 @@
 
 A toolkit for building LLM-powered applications and agent loops.
 
+> [!NOTE]
+> The AI SDK for Python is in public beta.
+
 ## Installation
 
 ```bash

docs/ai-python/app/[lang]/(home)/page.tsx

@@ -105,7 +105,7 @@ async with agent.run(model, [ai.user_message("Robot uprising?")]) as s:
 const HomePage = () => (
   <div className="container mx-auto max-w-5xl">
     <Hero
-      badge="Now in Alpha"
+      badge="Now in Beta"
       description={description}
       title={title}
     >

pyproject.toml

@@ -14,7 +14,6 @@ classifiers = [
     "Intended Audience :: Information Technology",
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
-    "Operating System :: OS Independent",
     "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.12",
@@ -45,6 +44,12 @@ vercel = [
     "vercel>=0.5.9",
 ]
 
+[project.urls]
+Homepage = "https://ai-python.dev"
+Repository = "https://github.com/vercel-labs/ai-python"
+Issues = "https://github.com/vercel-labs/ai-python/issues"
+Changelog = "https://github.com/vercel-labs/ai-python/releases"
+
 [build-system]
 requires = ["hatchling", "uv-dynamic-versioning>=0.7.0"]
 build-backend = "hatchling.build"