feat: initial import

Author: hbredin

.github/workflows/release.yml

@@ -0,0 +1,99 @@
+name: Publish Python 🐍 distribution 📦 to PyPI
+
+on: push
+
+jobs:
+  build:
+    name: Build distribution 📦
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
+        fetch-depth: 0
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version-file: ".python-version"
+    - name: Build
+      run: uv build
+    - name: Store the distribution packages
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+  publish-to-pypi:
+    name: >-
+      Publish Python 🐍 distribution 📦 to PyPI
+    if: startsWith(github.ref, 'refs/tags/')  # only publish to PyPI on tag pushes
+    needs:
+    - build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      id-token: write
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
+        cache-dependency-glob: uv.lock
+    - name: Publish distribution 📦 to PyPI
+      run: uv publish --trusted-publishing always  --publish-url https://upload.pypi.org/legacy/
+
+
+  github-release:
+    name: >-
+      Sign the Python 🐍 distribution 📦 with Sigstore
+      and upload them to GitHub Release
+    needs:
+    - publish-to-pypi
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write  # IMPORTANT: mandatory for making GitHub Releases
+      id-token: write  # IMPORTANT: mandatory for sigstore
+
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+    - name: Sign the dists with Sigstore
+      uses: sigstore/gh-action-sigstore-python@v3.0.0
+      with:
+        inputs: >-
+          ./dist/*.tar.gz
+          ./dist/*.whl
+    - name: Create GitHub Release
+      env:
+        GITHUB_TOKEN: ${{ github.token }}
+      run: >-
+        gh release create
+        "$GITHUB_REF_NAME"
+        --repo "$GITHUB_REPOSITORY"
+        --notes ""
+    - name: Upload artifact signatures to GitHub Release
+      env:
+        GITHUB_TOKEN: ${{ github.token }}
+      # Upload to GitHub Release using the `gh` CLI.
+      # `dist/` contains the built packages, and the
+      # sigstore-produced signatures and certificates.
+      run: >-
+        gh release upload
+        "$GITHUB_REF_NAME" dist/**
+        --repo "$GITHUB_REPOSITORY"

.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

.python-version

@@ -0,0 +1 @@
+3.10

CHANGELOG.md

@@ -0,0 +1,5 @@
+# CHANGELOG
+
+## Version 0.1.0a0 (2025-03-05)
+
+- *Hello world!*

README.md

@@ -0,0 +1,58 @@
+<p align="center">
+  <a href="https://pyannote.ai/" target="blank"><img src="https://avatars.githubusercontent.com/u/162698670" width="64" /></a>
+</p>
+
+<div align="center">
+    <h1>Official Python `pyannoteAI` SDK </h1>
+</div>
+
+
+## Installation
+
+```bash
+$ pip install pyannoteAI
+```
+
+Then head over to [`dashboard.pyannote.ai`](https://dashboard.pyannote.ai) and create an API key.
+
+## Speaker diarization 
+
+```python
+# instantiate client
+from pyannoteai import Client
+client = Client("your-api-key")
+
+# upload conversation file
+media_url = client.upload('/path/to/conversation.wav')
+# submit a diarization job
+job_id = client.diarize(media_url)
+# retrieve diarization
+diarization = client.retrieve(job_id)
+# diarization['output']['diarization'] contains diarization output
+```
+
+Use `help(client.diarize)` to learn about options.
+
+## Speaker identification
+
+```python
+# create a voiceprint from a sample of Lex's voice
+lex_url = client.upload('/path/to/lex.wav')
+job_id = client.voiceprint(lex_url)
+lex = client.retrieve(job_id)
+# lex['output']['voiceprint'] contains Lex's voiceprint
+
+# create a voiceprint from a sample of Mark's voice
+mark_url = client.upload('/path/to/mark.wav')
+job_id = client.voiceprint(mark_url)
+mark = client.retrieve(job_id)
+# mark['output']['voiceprint'] contains Mark's voiceprint
+
+# use those voiceprints to track Lex and Mark in the conversation
+voiceprints = {'lex': lex['output']['voiceprint'], 'mark': mark['output']['voiceprint']}
+job_id = client.identify('/path/to/conversation.wav', voiceprints)
+identification = client.retrieve(job_id)
+# identification['output']['identification'] contains identification output
+```
+
+Use `help(client.identify)` to learn about options.

pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "pyannoteAI"
+description = "Official pyannoteAI Python SDK"
+readme = "README.md"
+authors = [
+    { name = "Hervé BREDIN", email = "herve@pyannote.ai" }
+]
+requires-python = ">=3.10"
+
+dynamic = [
+  "version",
+]
+
+dependencies = [
+    "requests>=2.32.3",
+]
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"

src/pyannoteai/__init__.py

@@ -0,0 +1,3 @@
+from .client import Client
+
+__all__ = ['Client']