pipecat-ai-cli 0.1.0__tar.gz

pipecat_ai_cli-0.1.0/.github/workflows/publish.yaml

@@ -0,0 +1,78 @@
+name: publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      gitref:
+        type: string
+        description: 'what git tag to build (e.g. v0.0.74)'
+        required: true
+
+jobs:
+  build:
+    name: 'Build and upload wheels'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.inputs.gitref }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: 'latest'
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Install development dependencies
+        run: uv sync --group dev
+      - name: Build project
+        run: uv build
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels
+          path: ./dist
+
+  publish-to-pypi:
+    name: 'Publish to PyPI'
+    runs-on: ubuntu-latest
+    needs: [build]
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pipecat-ai-cli
+    permissions:
+      id-token: write
+    steps:
+      - name: Download wheels
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: ./dist
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+          print-hash: true
+
+  publish-to-test-pypi:
+    name: 'Publish to Test PyPI'
+    runs-on: ubuntu-latest
+    needs: [build]
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/pipecat-ai-cli
+    permissions:
+      id-token: write
+    steps:
+      - name: Download wheels
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: ./dist
+      - name: Publish to Test PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+          print-hash: true
+          repository-url: https://test.pypi.org/legacy/

pipecat_ai_cli-0.1.0/.github/workflows/publish_test.yaml

@@ -0,0 +1,51 @@
+name: publish-test
+
+on: workflow_dispatch
+
+jobs:
+  build:
+    name: 'Build and upload wheels'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+        with:
+          fetch-tags: true
+          fetch-depth: 100
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: 'latest'
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Install development dependencies
+        run: uv sync --group dev
+      - name: Build project
+        run: uv build
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels
+          path: ./dist
+
+  publish-to-test-pypi:
+    name: 'Publish to Test PyPI'
+    runs-on: ubuntu-latest
+    needs: [build]
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/pipecat-ai-cli
+    permissions:
+      id-token: write
+    steps:
+      - name: Download wheels
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: ./dist
+      - name: Publish to Test PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+          print-hash: true
+          repository-url: https://test.pypi.org/legacy/

pipecat_ai_cli-0.1.0/.github/workflows/tests.yaml

@@ -0,0 +1,37 @@
+name: tests
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - '**'
+
+concurrency:
+  group: build-test-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: 'Unit and Integration Tests'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: 'latest'
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Run tests
+        run: uv run pytest

pipecat_ai_cli-0.1.0/.gitignore

@@ -0,0 +1,58 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Linting
+.ruff_cache/
+.djlintcache
+
+# Distribution
+dist/
+build/
+
+# Misc
+*.log
+*.bak
+*.tmp
+

pipecat_ai_cli-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,8 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.1
+    hooks:
+      - id: ruff
+        language_version: python3
+        args: [--fix]
+      - id: ruff-format

pipecat_ai_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to **Pipecat** 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.1.0] - 2025-10-17
+
+### Added
+
+- Core CLI commands:
+
+  - `pipecat init` - Interactive project scaffolding
+  - `pipecat tail` - Real-time bot monitoring
+  - `pipecat cloud` - Deployment and management commands for Pipecat Cloud
+
+- `pc` alias for all commands

pipecat_ai_cli-0.1.0/LICENSE

@@ -0,0 +1,24 @@
+BSD 2-Clause License
+
+Copyright (c) 2024–2025, 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.

pipecat_ai_cli-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: pipecat-ai-cli
+Version: 0.1.0
+Summary: CLI tool for scaffolding Pipecat AI voice agent projects
+License-Expression: BSD-2-Clause
+Project-URL: Source, https://github.com/pipecat-ai/pipecat-cli
+Project-URL: Website, https://pipecat.ai
+Project-URL: Issues, https://github.com/pipecat-ai/pipecat-cli/issues
+Keywords: pipecat,ai,cli,voice,agents,scaffolding
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Communications :: Conferencing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer<1,>=0.9.0
+Requires-Dist: rich<14,>=13.0.0
+Requires-Dist: jinja2<4,>=3.1.0
+Requires-Dist: questionary<3,>=2.0.0
+Requires-Dist: ruff<1,>=0.12.1
+Requires-Dist: pipecat-ai-tail>=0.0.1
+Requires-Dist: pipecatcloud>=0.2.6
+Dynamic: license-file
+
+# Pipecat CLI
+
+A complete toolkit for building, deploying, and monitoring [Pipecat](https://github.com/pipecat-ai/pipecat) AI voice agents.
+
+- **Scaffold** new projects with `pipecat init`
+- **Deploy** to production with `pipecat cloud`
+- **Monitor** live bots with `pipecat tail`
+
+## Requirements
+
+- Python 3.10+
+
+## Installation
+
+```bash
+uv tool install pipecat-ai-cli
+```
+
+This installs the CLI globally. If you don't have `uv`, you can also use `pipx install pipecat-ai-cli`.
+
+> **Tip:** All commands can use either `pipecat` or the shorter `pc` alias.
+
+## Create a New Project
+
+Create a new Pipecat project interactively:
+
+```bash
+pipecat init
+```
+
+The CLI will guide you through selecting:
+
+- Bot type and client framework
+- Transport provider (Daily, Twilio, etc.)
+- Pipeline mode (Cascade or Realtime)
+- AI services (STT, LLM, TTS)
+- Optional features and deployment target
+
+**Generated Project Structure**
+
+```
+mybot/
+├── server/                  # Python bot server
+│   ├── bot.py              # Main bot implementation
+│   ├── pyproject.toml      # Python dependencies
+│   ├── .env.example        # Environment variables template
+│   ├── Dockerfile          # Container image (if cloud enabled)
+│   └── pcc-deploy.toml     # Deployment config (if cloud enabled)
+├── client/                  # Web client (if generated)
+│   ├── src/
+│   ├── package.json
+│   └── ...
+├── .gitignore
+└── README.md                # Project setup instructions
+```
+
+## Monitor Your Bot
+
+Use the built-in Tail dashboard to monitor your bot in real-time:
+
+```bash
+# Connect to local bot (default: ws://localhost:9292)
+pipecat tail
+
+# Connect to remote session
+pipecat tail --url wss://your-bot.example.com
+```
+
+Tail provides:
+
+- 📜 Real-time system logs
+- 💬 Live conversation tracking
+- 🔊 Audio level monitoring
+- 📈 Service metrics and usage stats
+
+## Deploy to Pipecat Cloud
+
+Deploy and manage your bot in production with [Pipecat Cloud](https://www.daily.co/products/pipecat-cloud/):
+
+```bash
+# Authenticate
+pipecat cloud auth login
+
+# Build and deploy
+pipecat cloud docker build-push
+pipecat cloud deploy
+
+# Manage deployments
+pipecat cloud agent list
+pipecat cloud agent logs <agent-name>
+```
+
+Cloud commands provide:
+
+- 🔐 Authentication and credential management
+- 🐳 Docker build and registry integration
+- 🚀 One-command deployment
+- 📊 Agent status and log monitoring
+- 🔧 Runtime configuration management
+
+**Note:** When you enable "Deploy to Pipecat Cloud" during project creation, the necessary Docker and deployment config files are automatically generated.
+
+Learn more in the [Pipecat Cloud documentation](https://docs.pipecat.ai/deployment/pipecat-cloud/introduction).
+
+## 📚 Next steps
+
+- See the [Pipecat documentation](https://docs.pipecat.ai) for more about building bots
+- Learn how to extend the template using [examples & recipes](https://docs.pipecat.ai/examples)
+- [Join our Discord](https://discord.gg/pipecat) to get help or provide feedback

pipecat_ai_cli-0.1.0/README.md

@@ -0,0 +1,109 @@
+# Pipecat CLI
+
+A complete toolkit for building, deploying, and monitoring [Pipecat](https://github.com/pipecat-ai/pipecat) AI voice agents.
+
+- **Scaffold** new projects with `pipecat init`
+- **Deploy** to production with `pipecat cloud`
+- **Monitor** live bots with `pipecat tail`
+
+## Requirements
+
+- Python 3.10+
+
+## Installation
+
+```bash
+uv tool install pipecat-ai-cli
+```
+
+This installs the CLI globally. If you don't have `uv`, you can also use `pipx install pipecat-ai-cli`.
+
+> **Tip:** All commands can use either `pipecat` or the shorter `pc` alias.
+
+## Create a New Project
+
+Create a new Pipecat project interactively:
+
+```bash
+pipecat init
+```
+
+The CLI will guide you through selecting:
+
+- Bot type and client framework
+- Transport provider (Daily, Twilio, etc.)
+- Pipeline mode (Cascade or Realtime)
+- AI services (STT, LLM, TTS)
+- Optional features and deployment target
+
+**Generated Project Structure**
+
+```
+mybot/
+├── server/                  # Python bot server
+│   ├── bot.py              # Main bot implementation
+│   ├── pyproject.toml      # Python dependencies
+│   ├── .env.example        # Environment variables template
+│   ├── Dockerfile          # Container image (if cloud enabled)
+│   └── pcc-deploy.toml     # Deployment config (if cloud enabled)
+├── client/                  # Web client (if generated)
+│   ├── src/
+│   ├── package.json
+│   └── ...
+├── .gitignore
+└── README.md                # Project setup instructions
+```
+
+## Monitor Your Bot
+
+Use the built-in Tail dashboard to monitor your bot in real-time:
+
+```bash
+# Connect to local bot (default: ws://localhost:9292)
+pipecat tail
+
+# Connect to remote session
+pipecat tail --url wss://your-bot.example.com
+```
+
+Tail provides:
+
+- 📜 Real-time system logs
+- 💬 Live conversation tracking
+- 🔊 Audio level monitoring
+- 📈 Service metrics and usage stats
+
+## Deploy to Pipecat Cloud
+
+Deploy and manage your bot in production with [Pipecat Cloud](https://www.daily.co/products/pipecat-cloud/):
+
+```bash
+# Authenticate
+pipecat cloud auth login
+
+# Build and deploy
+pipecat cloud docker build-push
+pipecat cloud deploy
+
+# Manage deployments
+pipecat cloud agent list
+pipecat cloud agent logs <agent-name>
+```
+
+Cloud commands provide:
+
+- 🔐 Authentication and credential management
+- 🐳 Docker build and registry integration
+- 🚀 One-command deployment
+- 📊 Agent status and log monitoring
+- 🔧 Runtime configuration management
+
+**Note:** When you enable "Deploy to Pipecat Cloud" during project creation, the necessary Docker and deployment config files are automatically generated.
+
+Learn more in the [Pipecat Cloud documentation](https://docs.pipecat.ai/deployment/pipecat-cloud/introduction).
+
+## 📚 Next steps
+
+- See the [Pipecat documentation](https://docs.pipecat.ai) for more about building bots
+- Learn how to extend the template using [examples & recipes](https://docs.pipecat.ai/examples)
+- [Join our Discord](https://discord.gg/pipecat) to get help or provide feedback