deepctl 0.1.0__tar.gz

deepctl-0.1.0/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: deepctl
+Version: 0.1.0
+Summary: Official Deepgram CLI for speech recognition and audio intelligence
+Author-email: Deepgram <devrel@deepgram.com>
+Maintainer-email: Deepgram <devrel@deepgram.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/deepgram/cli
+Project-URL: Documentation, https://developers.deepgram.com/docs/cli
+Project-URL: Repository, https://github.com/deepgram/cli
+Project-URL: Bug Tracker, https://github.com/deepgram/cli/issues
+Project-URL: Community, https://discord.gg/deepgram
+Keywords: deepgram,speech,recognition,transcription,audio,cli
+Classifier: Development Status :: 3 - Alpha
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Requires-Dist: deepgram-sdk>=3.0.0
+Requires-Dist: deepctl-core>=0.1.0
+Requires-Dist: deepctl-cmd-login>=0.1.0
+Requires-Dist: deepctl-cmd-projects>=0.1.0
+Requires-Dist: deepctl-cmd-transcribe>=0.1.0
+Requires-Dist: deepctl-cmd-usage>=0.1.0
+Requires-Dist: deepctl-cmd-mcp>=0.1.0
+Requires-Dist: deepctl-cmd-debug>=0.1.0
+Requires-Dist: deepctl-cmd-debug-browser>=0.1.0
+Requires-Dist: deepctl-cmd-debug-network>=0.1.0
+Requires-Dist: deepctl-cmd-debug-audio>=0.1.0
+Requires-Dist: deepctl-shared-utils>=0.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: requests<3.0,>=2.31
+Requires-Dist: pyjwt>=2.8.0
+Requires-Dist: keyring>=24.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: platformdirs>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: responses>=0.23.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
+Requires-Dist: types-requests>=2.31.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Requires-Dist: tox>=4.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+
+# deepctl
+
+The official Deepgram CLI.
+
+## Quick Start
+
+### Try it without installing (like `npx`)
+
+```bash
+# Using pipx (traditional)
+pipx run deepctl --help
+pipx run deepctl transcribe audio.wav
+
+# Using uv (recommended - much faster!)
+uvx deepctl --help
+uvx deepctl transcribe audio.wav
+```
+
+### Install permanently
+
+```bash
+# Recommended: Using pipx (supports plugins!)
+pipx install deepctl
+
+# Alternative: Using uv tool (plugins require manual workarounds)
+uv tool install deepctl
+```
+
+## Usage
+
+The CLI provides multiple command aliases for flexibility:
+
+- `deepctl` - Primary command
+- `deepgram` - Alternative command
+- `dg` - Short alias
+
+### Basic Commands
+
+```bash
+# Authentication
+deepctl login
+
+# Transcribe audio
+deepctl transcribe audio.wav
+deepctl transcribe https://example.com/audio.mp3
+
+# Manage projects
+deepctl projects list
+deepctl projects create "My Project"
+
+# View usage statistics
+deepctl usage --month 2024-01
+```
+
+### Configuration
+
+The CLI supports multiple configuration methods:
+
+1. Command-line arguments (highest priority)
+2. Environment variables
+3. User config file (`~/.deepgram/config.yaml`)
+4. Project config file (`./deepgram.yaml`)
+
+### Output Formats
+
+Choose your preferred output format:
+
+```bash
+deepctl transcribe audio.wav --output json
+deepctl transcribe audio.wav --output yaml
+deepctl transcribe audio.wav --output table
+deepctl transcribe audio.wav --output csv
+```
+
+## Development
+
+This CLI is built with Python and uses a modular plugin architecture. **Cross-platform compatibility** is a core requirement - the CLI must work identically on Linux, Windows, macOS (Intel), and macOS (Apple Silicon).
+
+### Requirements
+
+- Python 3.10+
+- `uv`
+- Works on all major platforms:
+  - Linux (x86_64, arm64)
+  - Windows (x86_64)
+  - macOS (Intel x86_64, Apple Silicon arm64)
+
+### Install uv
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### Installation for Development
+
+```bash
+git clone https://github.com/deepgram/cli
+cd cli
+
+# Create virtual environment and install dependencies
+uv venv
+uv pip install -e ".[dev]"
+```
+
+### Dependencies
+
+All dependencies are managed in `pyproject.toml`. Install them with:
+
+```bash
+uv pip install -e .              # Runtime dependencies
+uv pip install -e ".[dev]"       # Development dependencies
+uv pip install -e ".[test]"      # Test dependencies
+```
+
+### Workspace Structure
+
+This repository is organized as a uv workspace (monorepo) to support multiple related packages:
+
+```
+cli/                    # Workspace root
+├── src/               # Main CLI package (deepctl)
+│   └── deepgram_cli/
+├── packages/          # Additional workspace packages
+│   └── (future packages)
+└── docs/              # Shared documentation
+```
+
+See [Workspace and Monorepo Architecture](docs/Workspace%20and%20Monorepo%20Architecture.md) for detailed information about the workspace structure and how to add new packages.
+
+### Running Tests
+
+```bash
+uv run pytest
+```
+
+## Plugin Support
+
+### Installing Plugins
+
+Deepctl supports external plugins that add custom commands:
+
+```bash
+# First, install deepctl globally with pipx
+pipx install deepctl
+
+# Then inject plugins into the same environment
+pipx inject deepctl deepctl-plugin-example
+pipx inject deepctl your-custom-plugin
+```
+
+### Creating Plugins
+
+Create custom commands by extending the `BaseCommand` class:
+
+```python
+from deepctl_core.base_command import BaseCommand
+
+class MyCommand(BaseCommand):
+    name = "mycommand"
+    help = "Description of my command"
+
+    def handle(self, config, auth_manager, client, **kwargs):
+        # Command implementation
+        pass
+```
+
+See [packages/deepctl-plugin-example](packages/deepctl-plugin-example) for a complete example.
+
+## Support
+
+- [Documentation](https://developers.deepgram.com/docs/cli)
+- [Community Discord](https://discord.gg/deepgram)
+- [Bug Reports](https://github.com/deepgram/cli/issues)
+
+## License
+
+MIT License - see LICENSE file for details.

deepctl-0.1.0/README.md

@@ -0,0 +1,181 @@
+# deepctl
+
+The official Deepgram CLI.
+
+## Quick Start
+
+### Try it without installing (like `npx`)
+
+```bash
+# Using pipx (traditional)
+pipx run deepctl --help
+pipx run deepctl transcribe audio.wav
+
+# Using uv (recommended - much faster!)
+uvx deepctl --help
+uvx deepctl transcribe audio.wav
+```
+
+### Install permanently
+
+```bash
+# Recommended: Using pipx (supports plugins!)
+pipx install deepctl
+
+# Alternative: Using uv tool (plugins require manual workarounds)
+uv tool install deepctl
+```
+
+## Usage
+
+The CLI provides multiple command aliases for flexibility:
+
+- `deepctl` - Primary command
+- `deepgram` - Alternative command
+- `dg` - Short alias
+
+### Basic Commands
+
+```bash
+# Authentication
+deepctl login
+
+# Transcribe audio
+deepctl transcribe audio.wav
+deepctl transcribe https://example.com/audio.mp3
+
+# Manage projects
+deepctl projects list
+deepctl projects create "My Project"
+
+# View usage statistics
+deepctl usage --month 2024-01
+```
+
+### Configuration
+
+The CLI supports multiple configuration methods:
+
+1. Command-line arguments (highest priority)
+2. Environment variables
+3. User config file (`~/.deepgram/config.yaml`)
+4. Project config file (`./deepgram.yaml`)
+
+### Output Formats
+
+Choose your preferred output format:
+
+```bash
+deepctl transcribe audio.wav --output json
+deepctl transcribe audio.wav --output yaml
+deepctl transcribe audio.wav --output table
+deepctl transcribe audio.wav --output csv
+```
+
+## Development
+
+This CLI is built with Python and uses a modular plugin architecture. **Cross-platform compatibility** is a core requirement - the CLI must work identically on Linux, Windows, macOS (Intel), and macOS (Apple Silicon).
+
+### Requirements
+
+- Python 3.10+
+- `uv`
+- Works on all major platforms:
+  - Linux (x86_64, arm64)
+  - Windows (x86_64)
+  - macOS (Intel x86_64, Apple Silicon arm64)
+
+### Install uv
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### Installation for Development
+
+```bash
+git clone https://github.com/deepgram/cli
+cd cli
+
+# Create virtual environment and install dependencies
+uv venv
+uv pip install -e ".[dev]"
+```
+
+### Dependencies
+
+All dependencies are managed in `pyproject.toml`. Install them with:
+
+```bash
+uv pip install -e .              # Runtime dependencies
+uv pip install -e ".[dev]"       # Development dependencies
+uv pip install -e ".[test]"      # Test dependencies
+```
+
+### Workspace Structure
+
+This repository is organized as a uv workspace (monorepo) to support multiple related packages:
+
+```
+cli/                    # Workspace root
+├── src/               # Main CLI package (deepctl)
+│   └── deepgram_cli/
+├── packages/          # Additional workspace packages
+│   └── (future packages)
+└── docs/              # Shared documentation
+```
+
+See [Workspace and Monorepo Architecture](docs/Workspace%20and%20Monorepo%20Architecture.md) for detailed information about the workspace structure and how to add new packages.
+
+### Running Tests
+
+```bash
+uv run pytest
+```
+
+## Plugin Support
+
+### Installing Plugins
+
+Deepctl supports external plugins that add custom commands:
+
+```bash
+# First, install deepctl globally with pipx
+pipx install deepctl
+
+# Then inject plugins into the same environment
+pipx inject deepctl deepctl-plugin-example
+pipx inject deepctl your-custom-plugin
+```
+
+### Creating Plugins
+
+Create custom commands by extending the `BaseCommand` class:
+
+```python
+from deepctl_core.base_command import BaseCommand
+
+class MyCommand(BaseCommand):
+    name = "mycommand"
+    help = "Description of my command"
+
+    def handle(self, config, auth_manager, client, **kwargs):
+        # Command implementation
+        pass
+```
+
+See [packages/deepctl-plugin-example](packages/deepctl-plugin-example) for a complete example.
+
+## Support
+
+- [Documentation](https://developers.deepgram.com/docs/cli)
+- [Community Discord](https://discord.gg/deepgram)
+- [Bug Reports](https://github.com/deepgram/cli/issues)
+
+## License
+
+MIT License - see LICENSE file for details.

deepctl-0.1.0/pyproject.toml

@@ -0,0 +1,392 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "deepctl"
+version = "0.1.0"
+description = "Official Deepgram CLI for speech recognition and audio intelligence"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "Deepgram", email = "devrel@deepgram.com" }]
+maintainers = [{ name = "Deepgram", email = "devrel@deepgram.com" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+keywords = [
+    "deepgram",
+    "speech",
+    "recognition",
+    "transcription",
+    "audio",
+    "cli",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.0.0",
+    "deepgram-sdk>=3.0.0",
+    "deepctl-core>=0.1.0",              # Core components moved to separate package
+    "deepctl-cmd-login>=0.1.0",         # Login command package
+    "deepctl-cmd-projects>=0.1.0",      # Projects command package
+    "deepctl-cmd-transcribe>=0.1.0",    # Transcribe command package
+    "deepctl-cmd-usage>=0.1.0",         # Usage command package
+    "deepctl-cmd-mcp>=0.1.0",           # MCP server command package
+    "deepctl-cmd-debug>=0.1.0",         # Debug command group package
+    "deepctl-cmd-debug-browser>=0.1.0", # Browser debug subcommand
+    "deepctl-cmd-debug-network>=0.1.0", # Network debug subcommand
+    "deepctl-cmd-debug-audio>=0.1.0",   # Audio debug subcommand
+    "deepctl-shared-utils>=0.1.0",      # Shared utilities
+    "pydantic>=2.0.0",
+    "rich>=13.0.0",
+    "httpx>=0.24.0",
+    "requests>=2.31,<3.0",
+    "pyjwt>=2.8.0",
+    "keyring>=24.0.0",
+    "pyyaml>=6.0.0",
+    "typer>=0.9.0",
+    "platformdirs>=3.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    # Testing
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "pytest-mock>=3.10.0",
+    "responses>=0.23.0",
+    # Code Quality
+    "black>=23.0.0",
+    "ruff>=0.8.0",
+    "mypy>=1.0.0",
+    # Type Stubs
+    "types-PyYAML>=6.0.0",
+    "types-requests>=2.31.0",
+    # Development Tools
+    "pre-commit>=3.0.0",
+    "tox>=4.0.0",
+    # Publishing
+    "twine>=4.0.0",
+    "build>=0.10.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/deepgram/cli"
+Documentation = "https://developers.deepgram.com/docs/cli"
+Repository = "https://github.com/deepgram/cli"
+"Bug Tracker" = "https://github.com/deepgram/cli/issues"
+"Community" = "https://discord.gg/deepgram"
+
+[project.scripts]
+deepctl = "deepctl.main:main"
+deepgram = "deepctl.main:main"
+dg = "deepctl.main:main"
+
+# Entry points are now provided by individual command packages
+# [project.entry-points."deepctl.commands"]
+# transcribe = "deepctl.commands.transcribe:TranscribeCommand"
+# projects = "deepctl.commands.projects:ProjectsCommand"
+# usage = "deepctl.commands.usage:UsageCommand"
+# login = "deepctl.commands.login:LoginCommand"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["deepctl*"]
+
+[tool.black]
+line-length = 79
+target-version = ['py310']
+include = '\.pyi?$'
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+files = "src/,packages/*/src"
+
+[tool.pytest.ini_options]
+testpaths = ["tests", "packages/*/tests"]
+python_files = ["test_*.py", "*_test.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+# pythonpath is the correct option name (not python_path)
+pythonpath = ["."]
+# Add package directories to sys.path
+addopts = "--strict-markers --import-mode=importlib"
+markers = [
+    "unit: Unit tests",
+    "integration: Integration tests",
+    "slow: Slow running tests",
+    "requires_auth: Tests that require authentication",
+    "requires_network: Tests that require network access",
+    "benchmark: Benchmark tests",
+]
+
+[tool.tox]
+requires = ["tox>=4.19"]
+env_list = ["py310", "py311", "py312", "lint"]
+skip_missing_interpreters = true
+
+[tool.tox.env_run_base]
+package = "skip"
+deps = [
+    "uv",
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "pytest-mock>=3.10.0",
+]
+set_env = { PYTHONDONTWRITEBYTECODE = "1", PYTHONPATH = "{tox_root}" }
+allowlist_externals = ["uv"]
+commands_pre = [
+    [
+        "uv",
+        "pip",
+        "install",
+        "-e",
+        ".",
+        "-e",
+        "packages/deepctl-core",
+        "-e",
+        "packages/deepctl-shared-utils",
+        "-e",
+        "packages/deepctl-cmd-login",
+        "-e",
+        "packages/deepctl-cmd-projects",
+        "-e",
+        "packages/deepctl-cmd-transcribe",
+        "-e",
+        "packages/deepctl-cmd-usage",
+        "-e",
+        "packages/deepctl-cmd-debug",
+        "-e",
+        "packages/deepctl-cmd-debug-audio",
+        "-e",
+        "packages/deepctl-cmd-debug-browser",
+        "-e",
+        "packages/deepctl-cmd-debug-network",
+        "-e",
+        "packages/deepctl-cmd-mcp",
+    ],
+]
+change_dir = "{tox_root}"
+commands = [
+    [
+        "pytest",
+        "tests",
+        "packages/deepctl-core/tests",
+        "packages/deepctl-shared-utils/tests",
+        "packages/deepctl-cmd-login/tests",
+        "packages/deepctl-cmd-projects/tests",
+        "packages/deepctl-cmd-transcribe/tests",
+        "packages/deepctl-cmd-usage/tests",
+        "packages/deepctl-cmd-debug/tests",
+        "packages/deepctl-cmd-debug-audio/tests",
+        "packages/deepctl-cmd-debug-browser/tests",
+        "packages/deepctl-cmd-debug-network/tests",
+        "packages/deepctl-cmd-mcp/tests",
+        "--cov=deepctl",
+        "--cov=deepctl_core",
+        "--cov=deepctl_cmd_login",
+        "--cov=deepctl_cmd_projects",
+        "--cov=deepctl_cmd_transcribe",
+        "--cov=deepctl_cmd_usage",
+        "--cov=deepctl_shared_utils",
+        "--cov=deepctl_cmd_debug",
+        "--cov=deepctl_cmd_debug_audio",
+        "--cov=deepctl_cmd_debug_browser",
+        "--cov=deepctl_cmd_debug_network",
+        "--cov=deepctl_cmd_mcp",
+        "--cov-report=term-missing",
+        "--cov-report=html",
+        "-v",
+    ],
+]
+
+# py310, py311, py312 environments will inherit from env_run_base
+# No need to specify base_python - tox will infer it from the environment name
+
+[tool.tox.env.lint]
+# base_python will default to python3.11 as per the env name
+deps = [
+    "uv",
+    "mypy>=1.0.0",
+    "ruff>=0.8.0",
+    "black>=23.0.0",
+    "types-PyYAML>=6.0.0",
+    "types-requests>=2.31.0",
+]
+allowlist_externals = ["uv"]
+commands_pre = [
+    [
+        "uv",
+        "pip",
+        "install",
+        "-e",
+        ".",
+        "-e",
+        "packages/deepctl-core",
+        "-e",
+        "packages/deepctl-shared-utils",
+    ],
+]
+commands = [
+    [
+        "black",
+        "--check",
+        "src/",
+        "packages/deepctl-core/src",
+        "packages/deepctl-shared-utils/src",
+        "packages/deepctl-cmd-login/src",
+        "packages/deepctl-cmd-projects/src",
+        "packages/deepctl-cmd-transcribe/src",
+        "packages/deepctl-cmd-usage/src",
+        "packages/deepctl-cmd-debug/src",
+        "packages/deepctl-cmd-debug-audio/src",
+        "packages/deepctl-cmd-debug-browser/src",
+        "packages/deepctl-cmd-debug-network/src",
+        "packages/deepctl-cmd-mcp/src",
+    ],
+    [
+        "ruff",
+        "check",
+        "src/",
+        "packages/deepctl-core/src",
+        "packages/deepctl-shared-utils/src",
+        "packages/deepctl-cmd-login/src",
+        "packages/deepctl-cmd-projects/src",
+        "packages/deepctl-cmd-transcribe/src",
+        "packages/deepctl-cmd-usage/src",
+        "packages/deepctl-cmd-debug/src",
+        "packages/deepctl-cmd-debug-audio/src",
+        "packages/deepctl-cmd-debug-browser/src",
+        "packages/deepctl-cmd-debug-network/src",
+        "packages/deepctl-cmd-mcp/src",
+    ],
+    [
+        "mypy",
+        "src/",
+        "packages/deepctl-core/src",
+        "packages/deepctl-shared-utils/src",
+        "packages/deepctl-cmd-login/src",
+        "packages/deepctl-cmd-projects/src",
+        "packages/deepctl-cmd-transcribe/src",
+        "packages/deepctl-cmd-usage/src",
+        "packages/deepctl-cmd-debug/src",
+        "packages/deepctl-cmd-debug-audio/src",
+        "packages/deepctl-cmd-debug-browser/src",
+        "packages/deepctl-cmd-debug-network/src",
+        "packages/deepctl-cmd-mcp/src",
+    ],
+]
+
+[tool.uv]
+# Optional: uv-specific configuration
+# Uncomment and configure as needed
+
+# Set the Python version constraint
+# python = ">=3.10"
+
+# Package index configuration
+# index-url = "https://pypi.org/simple"
+# extra-index-url = []
+
+# Virtual environment configuration
+# venv = ".venv"
+
+# Development dependencies (can also be specified here)
+# dev-dependencies = [
+#     "pytest>=7.0.0",
+#     "black>=23.0.0",
+#     "mypy>=1.0.0",
+# ]
+
+[tool.uv.sources]
+# Workspace dependencies
+deepctl-core = { workspace = true }
+deepctl-cmd-login = { workspace = true }
+deepctl-cmd-projects = { workspace = true }
+deepctl-cmd-transcribe = { workspace = true }
+deepctl-cmd-usage = { workspace = true }
+deepctl-cmd-mcp = { workspace = true }
+deepctl-cmd-debug = { workspace = true }
+deepctl-cmd-debug-browser = { workspace = true }
+deepctl-cmd-debug-network = { workspace = true }
+deepctl-cmd-debug-audio = { workspace = true }
+deepctl-shared-utils = { workspace = true }
+
+[tool.uv.workspace]
+# Workspace configuration
+members = ["packages/*"]
+
+[dependency-groups]
+dev = ["types-pyyaml>=6.0.12.20250516", "types-requests>=2.32.4.20250611"]
+
+[tool.ruff]
+# Exclude common directories
+exclude = [
+    ".git",
+    ".mypy_cache",
+    ".tox",
+    ".venv",
+    "__pycache__",
+    "dist",
+    "build",
+    "*.egg-info",
+]
+
+# Same line length as Black
+line-length = 88
+
+# Target Python 3.10+
+target-version = "py310"
+
+[tool.ruff.lint]
+# Enable multiple rule sets
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+    "ARG", # flake8-unused-arguments
+    "SIM", # flake8-simplify
+    "TCH", # flake8-type-checking
+    "RUF", # Ruff-specific rules
+]
+
+# Ignore specific rules
+ignore = [
+    "E501",   # line too long (handled by formatter)
+    "B008",   # function calls in argument defaults
+    "B904",   # raise from exception
+    "SIM105", # try-except-pass
+    "RUF001", # ambiguous unicode characters (info symbol)
+    "ARG001", # unused function arguments (often needed for interfaces)
+    "E721",   # type comparison (sometimes needed for Pydantic)
+]
+
+# Allow autofix for all enabled rules
+fixable = ["ALL"]
+
+[tool.ruff.lint.per-file-ignores]
+# Ignore unused imports in __init__ files
+"**/__init__.py" = ["F401"]
+# Ignore imports in tests
+"**/test_*.py" = ["F401", "ARG"]
+# Ignore unused arguments in command handler methods
+"**/command.py" = ["ARG002"]
+"**/commands.py" = ["ARG002"]
+# The root project (deepctl) is implicitly a member since it contains [project]

deepctl-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

deepctl-0.1.0/src/deepctl/__init__.py

@@ -0,0 +1,11 @@
+"""deepctl - Official command-line interface for Deepgram's speech
+recognition API."""
+
+__version__ = "0.1.0"
+__author__ = "Deepgram"
+__email__ = "devrel@deepgram.com"
+__license__ = "MIT"
+
+from .main import main
+
+__all__ = ["main"]

deepctl-0.1.0/src/deepctl/main.py

@@ -0,0 +1,178 @@
+"""Main entry point for deepctl."""
+
+import sys
+
+import click
+from deepctl_core import Config, setup_output
+from rich.console import Console
+from rich.traceback import install
+
+# Install rich traceback for better error messages
+install(show_locals=True)
+console = Console()
+
+
+def preprocess_hyphenated_commands(args: list[str]) -> list[str]:
+    """Convert hyphenated commands to nested commands.
+
+    This function looks for commands in the format 'group-subcommand' and
+    converts them to the nested format Click expects (e.g., 'group
+    subcommand').
+
+    Args:
+        args: Command line arguments
+
+    Returns:
+        Modified arguments with hyphenated commands converted to nested format
+    """
+    if not args:
+        return args
+
+    # Get all registered commands to know which are groups
+    from importlib import metadata
+
+    group_commands = set()
+
+    # Discover group commands from entry points
+    try:
+        entry_points = metadata.entry_points()
+        for entry_point in entry_points.select(group="deepctl.commands"):
+            # We'll need to check if it's a group, but for now we'll use a
+            # heuristic
+            subcommand_group = f"deepctl.subcommands.{entry_point.name}"
+            try:
+                subcommand_eps = list(
+                    entry_points.select(group=subcommand_group)
+                )
+                if subcommand_eps:
+                    group_commands.add(entry_point.name)
+            except Exception:
+                pass
+    except Exception:
+        pass
+
+    # Process arguments
+    new_args = []
+    i = 0
+
+    while i < len(args):
+        arg = args[i]
+
+        # Skip if it's an option (starts with -)
+        if arg.startswith("-"):
+            new_args.append(arg)
+            i += 1
+            # If it's an option with a value, include the next arg too
+            if i < len(args) and not args[i].startswith("-"):
+                new_args.append(args[i])
+                i += 1
+            continue
+
+        # Check if this could be a hyphenated command
+        if "-" in arg and not arg.startswith("-"):
+            parts = arg.split("-", 1)
+            if len(parts) == 2:
+                group_name, subcommand = parts
+
+                # If the first part is a known group command, convert it
+                if group_name in group_commands:
+                    new_args.extend([group_name, subcommand])
+                    i += 1
+                    continue
+
+        # Otherwise, keep the argument as-is
+        new_args.append(arg)
+        i += 1
+
+    return new_args
+
+
+# Create CLI group
+@click.group(name="deepctl")
+@click.version_option(version="0.1.0", prog_name="deepctl")
+@click.option(
+    "--config",
+    "-c",
+    type=click.Path(exists=True),
+    help="Path to configuration file",
+)
+@click.option(
+    "--profile",
+    "-p",
+    help="Configuration profile to use",
+)
+@click.option(
+    "--output",
+    "-o",
+    type=click.Choice(["json", "yaml", "table", "csv"], case_sensitive=False),
+    help="Output format",
+)
+@click.option(
+    "--quiet",
+    "-q",
+    is_flag=True,
+    help="Suppress non-essential output",
+)
+@click.option(
+    "--verbose",
+    "-v",
+    is_flag=True,
+    help="Enable verbose output",
+)
+@click.pass_context
+def cli(
+    ctx: click.Context,
+    config: str | None,
+    profile: str | None,
+    output: str | None,
+    quiet: bool,
+    verbose: bool,
+) -> None:
+    """deepctl - Official Deepgram CLI for speech recognition and audio
+    intelligence."""
+
+    # Initialize configuration
+    ctx.ensure_object(dict)
+    ctx.obj["config"] = Config(config_path=config, profile=profile)
+
+    # Setup output formatting
+    setup_output(
+        format_type=output or ctx.obj["config"].get("output.format", "json"),
+        quiet=quiet,
+        verbose=verbose,
+    )
+
+
+# Load commands from entry points
+def load_commands() -> None:
+    """Load commands from package entry points."""
+    # Use the plugin manager to load all commands
+    from deepctl_core import PluginManager
+
+    plugin_manager = PluginManager()
+    plugin_manager.load_plugins(cli)
+
+
+# Load commands when module is imported
+load_commands()
+
+
+def main() -> None:
+    """Main entry point for the CLI."""
+    try:
+        # Preprocess arguments to handle hyphenated commands
+        args = sys.argv[1:]  # Skip the program name
+        processed_args = preprocess_hyphenated_commands(args)
+
+        # Call CLI with processed arguments
+        cli(args=processed_args, standalone_mode=True)
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Operation cancelled by user[/yellow]")
+        sys.exit(1)
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

deepctl-0.1.0/src/deepctl.egg-info/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: deepctl
+Version: 0.1.0
+Summary: Official Deepgram CLI for speech recognition and audio intelligence
+Author-email: Deepgram <devrel@deepgram.com>
+Maintainer-email: Deepgram <devrel@deepgram.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/deepgram/cli
+Project-URL: Documentation, https://developers.deepgram.com/docs/cli
+Project-URL: Repository, https://github.com/deepgram/cli
+Project-URL: Bug Tracker, https://github.com/deepgram/cli/issues
+Project-URL: Community, https://discord.gg/deepgram
+Keywords: deepgram,speech,recognition,transcription,audio,cli
+Classifier: Development Status :: 3 - Alpha
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Requires-Dist: deepgram-sdk>=3.0.0
+Requires-Dist: deepctl-core>=0.1.0
+Requires-Dist: deepctl-cmd-login>=0.1.0
+Requires-Dist: deepctl-cmd-projects>=0.1.0
+Requires-Dist: deepctl-cmd-transcribe>=0.1.0
+Requires-Dist: deepctl-cmd-usage>=0.1.0
+Requires-Dist: deepctl-cmd-mcp>=0.1.0
+Requires-Dist: deepctl-cmd-debug>=0.1.0
+Requires-Dist: deepctl-cmd-debug-browser>=0.1.0
+Requires-Dist: deepctl-cmd-debug-network>=0.1.0
+Requires-Dist: deepctl-cmd-debug-audio>=0.1.0
+Requires-Dist: deepctl-shared-utils>=0.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: requests<3.0,>=2.31
+Requires-Dist: pyjwt>=2.8.0
+Requires-Dist: keyring>=24.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: platformdirs>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: responses>=0.23.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
+Requires-Dist: types-requests>=2.31.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Requires-Dist: tox>=4.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+
+# deepctl
+
+The official Deepgram CLI.
+
+## Quick Start
+
+### Try it without installing (like `npx`)
+
+```bash
+# Using pipx (traditional)
+pipx run deepctl --help
+pipx run deepctl transcribe audio.wav
+
+# Using uv (recommended - much faster!)
+uvx deepctl --help
+uvx deepctl transcribe audio.wav
+```
+
+### Install permanently
+
+```bash
+# Recommended: Using pipx (supports plugins!)
+pipx install deepctl
+
+# Alternative: Using uv tool (plugins require manual workarounds)
+uv tool install deepctl
+```
+
+## Usage
+
+The CLI provides multiple command aliases for flexibility:
+
+- `deepctl` - Primary command
+- `deepgram` - Alternative command
+- `dg` - Short alias
+
+### Basic Commands
+
+```bash
+# Authentication
+deepctl login
+
+# Transcribe audio
+deepctl transcribe audio.wav
+deepctl transcribe https://example.com/audio.mp3
+
+# Manage projects
+deepctl projects list
+deepctl projects create "My Project"
+
+# View usage statistics
+deepctl usage --month 2024-01
+```
+
+### Configuration
+
+The CLI supports multiple configuration methods:
+
+1. Command-line arguments (highest priority)
+2. Environment variables
+3. User config file (`~/.deepgram/config.yaml`)
+4. Project config file (`./deepgram.yaml`)
+
+### Output Formats
+
+Choose your preferred output format:
+
+```bash
+deepctl transcribe audio.wav --output json
+deepctl transcribe audio.wav --output yaml
+deepctl transcribe audio.wav --output table
+deepctl transcribe audio.wav --output csv
+```
+
+## Development
+
+This CLI is built with Python and uses a modular plugin architecture. **Cross-platform compatibility** is a core requirement - the CLI must work identically on Linux, Windows, macOS (Intel), and macOS (Apple Silicon).
+
+### Requirements
+
+- Python 3.10+
+- `uv`
+- Works on all major platforms:
+  - Linux (x86_64, arm64)
+  - Windows (x86_64)
+  - macOS (Intel x86_64, Apple Silicon arm64)
+
+### Install uv
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### Installation for Development
+
+```bash
+git clone https://github.com/deepgram/cli
+cd cli
+
+# Create virtual environment and install dependencies
+uv venv
+uv pip install -e ".[dev]"
+```
+
+### Dependencies
+
+All dependencies are managed in `pyproject.toml`. Install them with:
+
+```bash
+uv pip install -e .              # Runtime dependencies
+uv pip install -e ".[dev]"       # Development dependencies
+uv pip install -e ".[test]"      # Test dependencies
+```
+
+### Workspace Structure
+
+This repository is organized as a uv workspace (monorepo) to support multiple related packages:
+
+```
+cli/                    # Workspace root
+├── src/               # Main CLI package (deepctl)
+│   └── deepgram_cli/
+├── packages/          # Additional workspace packages
+│   └── (future packages)
+└── docs/              # Shared documentation
+```
+
+See [Workspace and Monorepo Architecture](docs/Workspace%20and%20Monorepo%20Architecture.md) for detailed information about the workspace structure and how to add new packages.
+
+### Running Tests
+
+```bash
+uv run pytest
+```
+
+## Plugin Support
+
+### Installing Plugins
+
+Deepctl supports external plugins that add custom commands:
+
+```bash
+# First, install deepctl globally with pipx
+pipx install deepctl
+
+# Then inject plugins into the same environment
+pipx inject deepctl deepctl-plugin-example
+pipx inject deepctl your-custom-plugin
+```
+
+### Creating Plugins
+
+Create custom commands by extending the `BaseCommand` class:
+
+```python
+from deepctl_core.base_command import BaseCommand
+
+class MyCommand(BaseCommand):
+    name = "mycommand"
+    help = "Description of my command"
+
+    def handle(self, config, auth_manager, client, **kwargs):
+        # Command implementation
+        pass
+```
+
+See [packages/deepctl-plugin-example](packages/deepctl-plugin-example) for a complete example.
+
+## Support
+
+- [Documentation](https://developers.deepgram.com/docs/cli)
+- [Community Discord](https://discord.gg/deepgram)
+- [Bug Reports](https://github.com/deepgram/cli/issues)
+
+## License
+
+MIT License - see LICENSE file for details.

deepctl-0.1.0/src/deepctl.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/deepctl/__init__.py
+src/deepctl/main.py
+src/deepctl.egg-info/PKG-INFO
+src/deepctl.egg-info/SOURCES.txt
+src/deepctl.egg-info/dependency_links.txt
+src/deepctl.egg-info/entry_points.txt
+src/deepctl.egg-info/requires.txt
+src/deepctl.egg-info/top_level.txt

deepctl-0.1.0/src/deepctl.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

deepctl-0.1.0/src/deepctl.egg-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+deepctl = deepctl.main:main
+deepgram = deepctl.main:main
+dg = deepctl.main:main

deepctl-0.1.0/src/deepctl.egg-info/requires.txt

@@ -0,0 +1,38 @@
+click>=8.0.0
+deepgram-sdk>=3.0.0
+deepctl-core>=0.1.0
+deepctl-cmd-login>=0.1.0
+deepctl-cmd-projects>=0.1.0
+deepctl-cmd-transcribe>=0.1.0
+deepctl-cmd-usage>=0.1.0
+deepctl-cmd-mcp>=0.1.0
+deepctl-cmd-debug>=0.1.0
+deepctl-cmd-debug-browser>=0.1.0
+deepctl-cmd-debug-network>=0.1.0
+deepctl-cmd-debug-audio>=0.1.0
+deepctl-shared-utils>=0.1.0
+pydantic>=2.0.0
+rich>=13.0.0
+httpx>=0.24.0
+requests<3.0,>=2.31
+pyjwt>=2.8.0
+keyring>=24.0.0
+pyyaml>=6.0.0
+typer>=0.9.0
+platformdirs>=3.0.0
+
+[dev]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0
+pytest-cov>=4.0.0
+pytest-mock>=3.10.0
+responses>=0.23.0
+black>=23.0.0
+ruff>=0.8.0
+mypy>=1.0.0
+types-PyYAML>=6.0.0
+types-requests>=2.31.0
+pre-commit>=3.0.0
+tox>=4.0.0
+twine>=4.0.0
+build>=0.10.0

deepctl-0.1.0/src/deepctl.egg-info/top_level.txt

@@ -0,0 +1 @@
+deepctl