Merge branch 'langfuse:main' into main

Author: RiviaAzusa

.github/workflows/release.yml

@@ -12,7 +12,6 @@ This is the Langfuse Python SDK, a client library for accessing the Langfuse obs
 ```bash
 # Install Poetry plugins (one-time setup)
 poetry self add poetry-dotenv-plugin
-poetry self add poetry-bumpversion
 
 # Install all dependencies including optional extras
 poetry install --all-extras
@@ -50,16 +49,21 @@ poetry run pre-commit run --all-files
 
 ### Building and Releasing
 ```bash
-# Build the package
+# Build the package locally (for testing)
 poetry build
 
-# Run release script (handles versioning, building, tagging, and publishing)
-poetry run release
-
 # Generate documentation
 poetry run pdoc -o docs/ --docformat google --logo "https://langfuse.com/langfuse_logo.svg" langfuse
 ```
 
+Releases are automated via GitHub Actions. To release:
+1. Go to Actions > "Release Python SDK" workflow
+2. Click "Run workflow"
+3. Select version bump type (patch/minor/major/prerelease)
+4. For prereleases, select the type (alpha/beta/rc)
+
+The workflow handles versioning, building, PyPI publishing (via OIDC), and GitHub release creation.
+
 ## Architecture
 
 ### Core Components
@@ -112,7 +116,7 @@ Environment variables (defined in `_client/environment_variables.py`):
 - `pyproject.toml`: Poetry configuration, dependencies, and tool settings
 - `ruff.toml`: Local development linting config (stricter)
 - `ci.ruff.toml`: CI linting config (more permissive)
-- `langfuse/version.py`: Version string (updated by release script)
+- `langfuse/version.py`: Version string (updated by CI release workflow)
 
 ## API Generation
 

CLAUDE.md

@@ -6,7 +6,6 @@
 
 ```
 poetry self add poetry-dotenv-plugin
-poetry self add poetry-bumpversion
 ```
 
 ### Install dependencies
@@ -58,34 +57,25 @@ poetry run mypy langfuse --no-error-summary
 
 ### Publish release
 
-#### Release script
-
-Make sure you have your PyPi API token setup in your poetry config. If not, you can set it up by running:
-
-```sh
-poetry config pypi-token.pypi $your-api-token
-```
-
-Run the release script:
-
-```sh
-poetry run release
-```
-
-#### Manual steps (for prepatch versions)
-
-1. `poetry version patch`
-   - `poetry version prepatch` for pre-release versions
-2. `poetry install`
-3. `poetry build`
-4. `git commit -am "chore: release v{version}"`
-5. `git push`
-6. `git tag v{version}`
-7. `git push --tags`
-8. `poetry publish`
-   - Create PyPi API token: <https://pypi.org/manage/account/token/>
-   - Setup: `poetry config pypi-token.pypi your-api-token`
-9. Create a release on GitHub with the changelog
+Releases are automated via GitHub Actions using PyPI Trusted Publishing (OIDC).
+
+To create a release:
+
+1. Go to [Actions > Release Python SDK](https://github.com/langfuse/langfuse-python/actions/workflows/release.yml)
+2. Click "Run workflow"
+3. Select the version bump type:
+   - `patch` - Bug fixes (1.0.0 → 1.0.1)
+   - `minor` - New features (1.0.0 → 1.1.0)
+   - `major` - Breaking changes (1.0.0 → 2.0.0)
+   - `prerelease` - Pre-release versions (1.0.0 → 1.0.0a1)
+4. For pre-releases, select the type: `alpha`, `beta`, or `rc`
+5. Click "Run workflow"
+
+The workflow will automatically:
+- Bump the version in `pyproject.toml` and `langfuse/version.py`
+- Build the package
+- Publish to PyPI
+- Create a git tag and GitHub release with auto-generated release notes
 
 ### SDK Reference