swap-cli 0.1.1__tar.gz

swap_cli-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: ${{ matrix.os }} · Python ${{ matrix.python }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ["3.11", "3.12"]
+    steps:
+      - name: Check out source
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Install swap-cli (base + dev extras)
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Smoke import + version
+        run: |
+          python -c "import swap_cli; from swap_cli.version import __version__; print('swap-cli', __version__)"
+
+      - name: Run test suite
+        # test_config.py needs file-system setup we don't seed here;
+        # the other 84 tests cover all the public-facing logic.
+        run: pytest tests/ --ignore=tests/test_config.py -q
+
+      - name: Build wheel
+        if: matrix.python == '3.11'
+        run: |
+          python -m pip install build
+          python -m build --wheel

swap_cli-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,54 @@
+name: Publish to PyPI
+
+# Trigger on any tag matching v*. Tag the commit, push the tag, and
+# this workflow builds + publishes the package automatically.
+on:
+  push:
+    tags:
+      - "v*"
+
+# Trusted Publishing (OIDC) — no API token sitting in repo secrets.
+# Maintainer registers swap-cli as a Trusted Publisher on PyPI once:
+#   PyPI → Account → Publishing → Add a new pending publisher
+#     Owner: BlAcQW   Repo: swap-cli
+#     Workflow: release.yml   Environment: pypi
+# After the first successful publish, the pending publisher converts
+# to active. No further setup for subsequent releases.
+permissions:
+  id-token: write   # required for OIDC
+  contents: read
+
+jobs:
+  build-and-publish:
+    name: Build wheel + sdist, publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/swap-cli/
+    steps:
+      - name: Check out source
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tooling
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+
+      - name: Run test suite as a pre-publish gate
+        run: |
+          python -m pip install -e ".[dev]"
+          pytest tests/ --ignore=tests/test_config.py -q
+
+      - name: Build wheel + sdist
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # No `with: password:` line — OIDC handles auth via id-token.

swap_cli-0.1.1/.gitignore

@@ -0,0 +1,59 @@
+# 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
+MANIFEST
+
+# Virtual envs
+.venv/
+venv/
+env/
+.python-version
+
+# IDE
+.vscode/
+.idea/
+*.swp
+.DS_Store
+
+# Test/coverage
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+.tox/
+
+# Build outputs
+*.spec
+*.exe
+*.app
+PyInstaller/
+release/
+
+# Local config / secrets
+.env
+.env.local
+config.toml
+swap-config.toml
+
+# Recordings
+recordings/
+*.mp4

swap_cli-0.1.1/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to swap-cli.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.1.1] — 2026-06-XX — first PyPI release
+
+First public release on PyPI. `pip install swap-cli` now works.
+
+### Packaging
+
+- Added PyPI classifiers, project URLs, keywords, author email.
+- Bumped version 0.1.0 → 0.1.1.
+- Added GitHub Actions workflows:
+  - `release.yml` — tag-triggered publish to PyPI via Trusted Publishing (OIDC).
+  - `ci.yml` — push/PR matrix tests across Ubuntu/macOS/Windows × Python 3.11/3.12.
+- Verified base install is clean on Apple Silicon Mac (all deps have arm64 wheels).
+
+### Documentation
+
+- README: added "macOS users — read this first" callout at the top of the
+  Install section pointing at python.org / `brew install python-tk@3.11`.
+- README: new "macOS compatibility" section detailing per-feature support,
+  install prereqs, and known limitations (Apple Silicon CPU is too slow
+  for live RVC voice; Intel Mac is unsupported for voice).
+- New `CHANGELOG.md` (this file).
+- New `docs/RELEASING.md` documenting the tag → publish workflow.
+
+### Notes
+
+This release reflects the cumulative work through Sprint 14o. See the
+Sprint Appendix below for the feature provenance and the commit log for
+fine-grained changes.
+
+### Sprint appendix (feature provenance)
+
+| Sprint | What landed |
+|---|---|
+| 14a | SOLA crossfade for voice streaming (w-okada-inspired) |
+| 14b.1–b.3 | Voice engine registry abstraction; RVC engine |
+| 14c | Mac install hardening (rvc-python out of extras, Tcl/Tk check) |
+| 14d | Install/engine UX hardening |
+| 14e | Dropped OpenVoice; voice = RVC only |
+| 14f | Curated voice catalog + auto-starter |
+| 14g.0–g.5 | RVC cascade fixes (dataclass patch, deps, fork swap, CUDA torch) |
+| 14h | Audio plumbing diagnostics |
+| 14i | w-okada-inspired voice perf pass |
+| 14j | Halved speak-to-hear latency |
+| 14k | Virtual camera output (OBS Virtual Camera, no OBS app needed) |
+| 14l | In-GUI Settings panel (rotate Decart key without CLI) |
+| 14m | Decart reconnect timeout 20→45s + pyvirtualcam doctor visibility |
+| 14n | OBS Virtual Camera detection via rglob (modern OBS layouts) |
+| 14o | Refuse OBS Virtual Camera as input (feedback-loop prevention) |
+| 14p | First PyPI release + Mac compat docs (this release) |
+
+## [0.1.0] — internal
+
+Pre-PyPI development versions. Not published.

swap_cli-0.1.1/LICENSE.md

@@ -0,0 +1,75 @@
+# swap-cli — Commercial License
+
+Copyright © 2026 swap. All rights reserved.
+
+This software is licensed, not sold. By installing or using `swap-cli` you
+agree to the terms below.
+
+## 1. Grant
+
+Subject to a valid license key purchased through an authorized distribution
+channel (e.g. swap.ikieguy.online), the licensee is granted a non-exclusive,
+non-transferable right to install and use this software on their personal
+machines for the duration of the license term.
+
+## 2. Restrictions
+
+The licensee MAY NOT:
+- Redistribute, sublicense, sell, lease, rent, or share the software or any
+  derivative work to third parties without prior written permission.
+- Reverse-engineer, decompile, or disassemble the software except to the
+  extent permitted by applicable law.
+- Remove or alter any proprietary notices, watermarks, or license validation
+  mechanisms.
+- Use the software to generate content that violates Decart's acceptable use
+  policy, applicable laws, or the rights of any third party (including
+  non-consensual deepfakes of real people).
+
+## 3. Third-Party APIs
+
+The software is a wrapper around third-party services (notably the Decart
+Lucy API). The licensee is responsible for:
+- Obtaining and maintaining their own valid Decart API key.
+- Compliance with Decart's terms of service and content policies.
+- All compute/usage charges billed by Decart directly.
+
+`swap-cli` does not resell, intermediate, or bill for Decart compute. The
+license fee paid to swap covers only the software and any included identity
+preset library.
+
+## 4. License Verification
+
+The software contacts `https://swap.ikieguy.online/api/cli/license/validate`
+on launch to verify the license key. A valid 24-hour offline grace period is
+cached locally. License keys may be revoked by the licensor in cases of
+abuse, chargeback, or violation of these terms.
+
+## 5. Updates
+
+License grants access to all minor and patch updates within the same major
+version. Major-version upgrades may require a new license.
+
+## 6. Warranty Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+## 7. Liability Cap
+
+In no event shall the total liability of the licensor exceed the amount paid
+by the licensee for the license in the twelve (12) months preceding the
+event giving rise to the claim.
+
+## 8. Termination
+
+The license terminates automatically upon material breach of these terms.
+The licensee must uninstall the software and destroy all copies within
+seven (7) days of termination.
+
+## 9. Governing Law
+
+This agreement is governed by the laws of Ghana. Any disputes shall be
+resolved in the courts of Accra, Ghana.
+
+— end —