pipecatcloud 0.0.6__tar.gz → 0.0.9__tar.gz

pipecatcloud-0.0.9/.github/workflows/publish-pypi.yml

@@ -0,0 +1,59 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (must match pyproject.toml, e.g. 0.0.4)'
+        required: true
+        type: string
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pipecat-cloud
+    permissions:
+      id-token: write # IMPORTANT: this permission is needed for trusted publishing
+      contents: write # Needed for tagging
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Verify version matches
+        run: |
+          pip install tomli
+          PROJECT_VERSION=$(python -c "import tomli; print(tomli.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          if [ "$PROJECT_VERSION" != "${{ github.event.inputs.version }}" ]; then
+            echo "Error: Input version (${{ github.event.inputs.version }}) does not match pyproject.toml version ($PROJECT_VERSION)"
+            exit 1
+          fi
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Create release tag
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git tag -a "v${{ github.event.inputs.version }}" -m "Version ${{ github.event.inputs.version }}"
+          git push origin "v${{ github.event.inputs.version }}"
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+          print-hash: true

pipecatcloud-0.0.9/.github/workflows/publish-test.yml

@@ -0,0 +1,59 @@
+name: Publish to TEST PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (must match pyproject.toml, e.g. 0.0.4)'
+        required: true
+        type: string
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://test.pypi.org/project/pipecat-cloud
+    permissions:
+      id-token: write # IMPORTANT: this permission is needed for trusted publishing
+      contents: write # Needed for tagging
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Verify version matches
+        run: |
+          pip install tomli
+          PROJECT_VERSION=$(python -c "import tomli; print(tomli.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          if [ "$PROJECT_VERSION" != "${{ github.event.inputs.version }}" ]; then
+            echo "Error: Input version (${{ github.event.inputs.version }}) does not match pyproject.toml version ($PROJECT_VERSION)"
+            exit 1
+          fi
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Create release tag
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git tag -a "v${{ github.event.inputs.version }}" -m "Version ${{ github.event.inputs.version }}"
+          git push origin "v${{ github.event.inputs.version }}"
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+          print-hash: true

{pipecatcloud-0.0.6 → pipecatcloud-0.0.9}/.github/workflows/python-publish.yml

@@ -1,12 +1,4 @@
-# This workflow will upload a Python Package to PyPI when a release is created
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
-
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
-
-name: Upload Python Package
+name: Build and publish Python package
 
 on:
   release:
@@ -57,7 +49,7 @@ jobs:
 
     environment:
       name: pypi
-      url: https://pypi.org/p/pipecatcloud
+      url: https://pypi.org/p/pipecat-cloud
 
     steps:
       - uses: actions/checkout@v4
@@ -73,24 +65,11 @@ jobs:
         with:
           packages-dir: dist/
 
-      - name: Read CHANGELOG
-        id: changelog
-        run: |
-          if [ -f "CHANGELOG.md" ]; then
-            echo "CHANGELOG_CONTENT<<EOF" >> $GITHUB_ENV
-            cat CHANGELOG.md >> $GITHUB_ENV
-            echo "EOF" >> $GITHUB_ENV
-          else
-            echo "CHANGELOG_CONTENT=No changelog available." >> $GITHUB_ENV
-          fi
-
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ github.ref }}
           name: Release ${{ github.ref_name }}
-          body: |
-            ${{ env.CHANGELOG_CONTENT }}
           draft: false
           prerelease: false
           files: |

{pipecatcloud-0.0.6 → pipecatcloud-0.0.9}/.gitignore

@@ -1,3 +1,5 @@
+pcc-deploy.toml
+
 # Python
 __pycache__/
 *.py[cod]

pipecatcloud-0.0.9/CHANGELOG.md

@@ -0,0 +1,88 @@
+# Pipecat Cloud Changelog
+
+All notable changes to **Pipecat Cloud** will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.9] - 2025-02-27
+
+### Added
+- `agent status [agent-name]` now shows deployment info and scaling configuration
+- `agent sessions [agent-name]` lists active session count for an agent (will list session details in future)
+- `agent start [agent-name] -D` now shows the Daily room URL (and token) to join in the terminal output
+
+### Changed
+- Changed CLI command from `pipecat` to `pipecatcloud` or `pcc`
+- `agent delete` prompts the user for confirmation first
+- `agent start` now checks the target deployment first to ensure it exists and is in a healthy state
+- Changed the information order of `agent status` so the health badge is clearly visible in terminal
+- `agent deploy` now defaults to "Y" for the confirmation prompts
+
+### Fixed
+- Fixed lint error with payload data in `agent start`
+- Fixed a bug where `pcc-deploy.toml` files were required to be present
+- `deploy` command now correctly passes the secret set to the deployment from the `pcc-deploy.toml` file
+
+## [0.0.8] - 2025-02-03
+
+### Added
+- `secrets set [set-name] --file` allowing you to create a secret set from .env file
+- `agent scale` to modify agent configuration without pushing a new image
+- `run` command for running bot.py files locally via FastAPI. This initial implementation is very basic and will be expanded in the future.
+- `organizations select` allows passing an `--org / -o` option to bypass prompt
+
+### Fixed
+- All commands use the correct shorthand flag syntax (`-` vs. `--`)
+- CLI config extends from module config to avoid loading config TOML with package imports
+- `secrets list` now correctly lists all secrets vs. just a single entry
+- `deploy` command displays live status to prevent skewed terminal output
+- `deploy` command no longer allows pushing images without a tag
+- `agent logs` paginate / filter / sort and tidy up display for logs
+- `start` command correctly clears the live terminal text
+- `pcc-deploy.toml` files now work as intended with `deploy` command
+- `deploy` method now passes configuration parameters correctly
+- Switching organizations will fully remove any default API tokens from the previously selected organization
+
+### Changed
+- Local config now retains default keys when switching between organizations
+- Local config now retains defaukt keys when logging in again
+- `deploy` will check passed secret set exists before deployment
+- `secrets list` now takes an optional `--sets / -s` parameter that filters by secret sets or image pull secrets
+- `organizations keys create` now prompts you to set the newly created key as the default after creation (if active org matches)
+- `organizations keys delete` not prompts to confirm if selected key is currently your local config default
+- `Agent` module import has been renamed to `Session` to better reflect API
+
+
+## [0.0.7] - 2025-02-01
+
+### Added
+
+- `run` command for running an agent locally. This initial implementation is very basic and will be expanded in the future.
+
+### Changed
+
+- `start_agent` method no longer requires an organization. If not provided, it will assume the namespace of the API token owner.
+- `start` command no longer looks up the agent before starting (health check is handled by the proxy route.)
+
+## [0.0.6] - 2025-02-01
+
+### Added
+
+- `pipecatcloud.agent` module for working with agents via Python scripts
+    - `start_agent` method for starting an agent
+
+### Backlog
+
+- `deploy` make image pull secrets non-optional, but allow for bypassing
+- Fix: update docs to assert that the bot method must be async
+- Fix: Secrets are not upserting (overriding each time, which may be preferrable?)
+- Fix: deployment process needs better output
+- `organizations keys create` should ask if you'd like to set the created key as default after creation (if org matches)
+- Sense check image parameter of the deploy command (does it have a tag, etc)
+- `agent logs` paginate / filter / sort and tidy up display for logs
+- Fix: start command should clear the live text
+- Secrets from .env method
+- Fix: .pcc-deploy.toml should read correctly 
+- New conveience method to add account associated Daily API Key to a secret set
+- Add: concurrency support for agent deployments

pipecatcloud-0.0.9/LICENSE

@@ -0,0 +1,24 @@
+BSD 2-Clause License
+
+Copyright (c) 2024, Daily
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

pipecatcloud-0.0.9/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.2
+Name: pipecatcloud
+Version: 0.0.9
+Summary: Cloud hosting for Pipecat AI applications
+License: BSD 2-Clause License
+Project-URL: Website, https://docs.pipecat.daily.co/
+Keywords: pipecat,pipecat-ai,voice,ai,llm
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp<4.0.0,~=3.11.13
+Requires-Dist: fastapi~=0.115.6
+Requires-Dist: loguru~=0.7.3
+Requires-Dist: python-dotenv~=1.0.1
+Requires-Dist: uvicorn~=0.32.0
+Requires-Dist: typer~=0.13.0
+Requires-Dist: synchronicity~=0.7.6
+Requires-Dist: toml~=0.10.2
+Requires-Dist: questionary~=2.1.0
+
+<h1><div align="center">
+ <img alt="pipecat cloud" width="500px" height="auto" src="./pipecat-cloud.png">
+</div></h1>
+
+[![Docs](https://img.shields.io/badge/documentation-blue)](https://docs.pipecat.daily.co)
+[![PyPI](https://img.shields.io/pypi/v/pipecatcloud)](https://pypi.org/project/pipecatcloud)
+
+# Pipecat Cloud
+
+Python module and CLI for interacting with [Pipecat Cloud](https://pipecat.daily.co).
+
+### Requirements
+
+- Python 3.10+
+- Docker and a Docker repository (e.g. Docker Hub)
+- Active [Pipecat Cloud](https://pipecat.daily.co)
+  account
+
+### Documentation
+
+Documentation for Pipecat Cloud is available [here](https://docs.pipecat.daily.co).
+
+### Installation
+
+```shell
+pip install pipecatcloud
+
+pcc --version
+pcc --help
+
+# Note: you can use `pcc` or `pipecatcloud` interchangeably
+pcc auth login
+```
+
+! All CLI commands have a `--help` flag that will display the command usage and options.
+
+## Usage
+
+1. Create an account at [Pipecat Cloud](https://pipecat.daily.co)
+
+2. Login to your account `pcc auth login`
+
+3. (Optional): Clone the starter agent [here](https://github.com/daily-co/pipecat-cloud-starter)
+
+4. Build your agent `docker build --platform linux/arm64 -t your-agent-name .`
+
+5. Push your Docker image to your repository `docker push your-repository/your-agent-name:0.1`
+
+6. Deploy your agent `pcc deploy starter-agent your-repository/your-agent-name:0.1`
+
+### Usage in Python scripts
+
+If want to programmatically start an agent within a Python script, you can use the `pipecatcloud.agent` module.
+
+```python
+from pipecatcloud.agent import Agent
+
+agent = Agent(
+    agent_name="your-agent-name",
+    organization="your-organization",
+    api_key="your-api-key",
+)
+
+await agent.start()
+```

pipecatcloud-0.0.9/README.md

@@ -0,0 +1,65 @@
+<h1><div align="center">
+ <img alt="pipecat cloud" width="500px" height="auto" src="./pipecat-cloud.png">
+</div></h1>
+
+[![Docs](https://img.shields.io/badge/documentation-blue)](https://docs.pipecat.daily.co)
+[![PyPI](https://img.shields.io/pypi/v/pipecatcloud)](https://pypi.org/project/pipecatcloud)
+
+# Pipecat Cloud
+
+Python module and CLI for interacting with [Pipecat Cloud](https://pipecat.daily.co).
+
+### Requirements
+
+- Python 3.10+
+- Docker and a Docker repository (e.g. Docker Hub)
+- Active [Pipecat Cloud](https://pipecat.daily.co)
+  account
+
+### Documentation
+
+Documentation for Pipecat Cloud is available [here](https://docs.pipecat.daily.co).
+
+### Installation
+
+```shell
+pip install pipecatcloud
+
+pcc --version
+pcc --help
+
+# Note: you can use `pcc` or `pipecatcloud` interchangeably
+pcc auth login
+```
+
+! All CLI commands have a `--help` flag that will display the command usage and options.
+
+## Usage
+
+1. Create an account at [Pipecat Cloud](https://pipecat.daily.co)
+
+2. Login to your account `pcc auth login`
+
+3. (Optional): Clone the starter agent [here](https://github.com/daily-co/pipecat-cloud-starter)
+
+4. Build your agent `docker build --platform linux/arm64 -t your-agent-name .`
+
+5. Push your Docker image to your repository `docker push your-repository/your-agent-name:0.1`
+
+6. Deploy your agent `pcc deploy starter-agent your-repository/your-agent-name:0.1`
+
+### Usage in Python scripts
+
+If want to programmatically start an agent within a Python script, you can use the `pipecatcloud.agent` module.
+
+```python
+from pipecatcloud.agent import Agent
+
+agent = Agent(
+    agent_name="your-agent-name",
+    organization="your-organization",
+    api_key="your-api-key",
+)
+
+await agent.start()
+```

pipecatcloud-0.0.9/publish-pypi.yml

@@ -0,0 +1,59 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (must match pyproject.toml, e.g. 0.0.4)'
+        required: true
+        type: string
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pipecat-cloud
+    permissions:
+      id-token: write # IMPORTANT: this permission is needed for trusted publishing
+      contents: write # Needed for tagging
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Verify version matches
+        run: |
+          pip install tomli
+          PROJECT_VERSION=$(python -c "import tomli; print(tomli.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          if [ "$PROJECT_VERSION" != "${{ github.event.inputs.version }}" ]; then
+            echo "Error: Input version (${{ github.event.inputs.version }}) does not match pyproject.toml version ($PROJECT_VERSION)"
+            exit 1
+          fi
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Create release tag
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git tag -a "v${{ github.event.inputs.version }}" -m "Version ${{ github.event.inputs.version }}"
+          git push origin "v${{ github.event.inputs.version }}"
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+          print-hash: true

pipecatcloud-0.0.9/publish-test.yml

@@ -0,0 +1,59 @@
+name: Publish to TEST PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (must match pyproject.toml, e.g. 0.0.4)'
+        required: true
+        type: string
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://test.pypi.org/project/pipecat-cloud
+    permissions:
+      id-token: write # IMPORTANT: this permission is needed for trusted publishing
+      contents: write # Needed for tagging
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Verify version matches
+        run: |
+          pip install tomli
+          PROJECT_VERSION=$(python -c "import tomli; print(tomli.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          if [ "$PROJECT_VERSION" != "${{ github.event.inputs.version }}" ]; then
+            echo "Error: Input version (${{ github.event.inputs.version }}) does not match pyproject.toml version ($PROJECT_VERSION)"
+            exit 1
+          fi
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Create release tag
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git tag -a "v${{ github.event.inputs.version }}" -m "Version ${{ github.event.inputs.version }}"
+          git push origin "v${{ github.event.inputs.version }}"
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+          print-hash: true

{pipecatcloud-0.0.6 → pipecatcloud-0.0.9}/pyproject.toml

@@ -4,23 +4,27 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pipecatcloud"
-version = "0.0.6"
+version = "0.0.9"
 requires-python = ">=3.10"
+description = "Cloud hosting for Pipecat AI applications"
+license = { text = "BSD 2-Clause License" }
+readme = "README.md"
+keywords = ["pipecat", "pipecat-ai", "voice", "ai", "llm"]
 dependencies = [
-    "aiohttp~=3.10.10",
-    "fastapi~=0.115.5",
-    "loguru~=0.7.2",
+    "aiohttp~=3.11.13,<4.0.0",
+    "fastapi~=0.115.6",
+    "loguru~=0.7.3",
     "python-dotenv~=1.0.1",
     "uvicorn~=0.32.0",
     "typer~=0.13.0",
     "synchronicity~=0.7.6",
     "toml~=0.10.2",
-    "questionary~=2.1.0",
+    "questionary~=2.1.0"
 ]
 
 [project.scripts]
 pcc = "pipecatcloud.__main__:main"
-pipecat = "pipecatcloud.__main__:main"
+pipecatcloud = "pipecatcloud.__main__:main"
 
 [tool.setuptools]
 package-dir = {"" = "src"}
@@ -32,3 +36,6 @@ include = ["pipecatcloud*"]
 [tool.ruff]
 exclude = ["*_pb2.py"]
 line-length = 100
+
+[project.urls]
+Website = "https://docs.pipecat.daily.co/"

{pipecatcloud-0.0.6 → pipecatcloud-0.0.9}/src/pipecatcloud/__init__.py

@@ -3,10 +3,5 @@ import sys
 
 from loguru import logger
 
-PIPECAT_CLI_NAME = "pcc"
-PIPECAT_CREDENTIALS_PATH = "~/.pipecatcloud.toml"
-PIPECAT_DEPLOY_CONFIG_PATH = ".pcc-deploy.toml"
-
-
 logger.remove()
 logger.add(sys.stderr, level=str(os.getenv("PCC_LOG_LEVEL", "INFO")))

pipecatcloud-0.0.9/src/pipecatcloud/_utils/auth_utils.py

@@ -0,0 +1,19 @@
+import functools
+
+from pipecatcloud._utils.console_utils import console
+from pipecatcloud.cli import PIPECAT_CLI_NAME
+from pipecatcloud.cli.config import config
+
+
+def requires_login(func):
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        org = config.get("org")
+        token = config.get("token")
+        if org is None or token is None:
+            console.error(
+                f"You are not logged in. Please run `{PIPECAT_CLI_NAME} auth login` first.",
+            )
+            return
+        return func(*args, **kwargs)
+    return wrapper