anyscribe 0.16.0__tar.gz

anyscribe-0.16.0/.claude/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.0.1",
+  "configurations": [
+    {
+      "name": "landing",
+      "runtimeExecutable": "python3",
+      "runtimeArgs": ["-m", "http.server", "8899", "--directory", "landing"],
+      "port": 8899
+    }
+  ]
+}

anyscribe-0.16.0/.claude/settings.json

@@ -0,0 +1,25 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm run:*)",
+      "Bash(curl -s http://127.0.0.1:8457/api/health)",
+      "Bash(python3 -m json.tool)",
+      "Read(//tmp/**)",
+      "Read(//private/tmp/**)",
+      "Bash(curl -s http://127.0.0.1:8457/api/config)",
+      "Bash(xargs ls:*)",
+      "Bash(xargs cat:*)",
+      "Read(//Users/rish/labs/projects/anyscribecli/**)",
+      "Bash(git status:*)",
+      "Read(//Users/rish/labs/oss/KraftedX-Labs/kx-tess/**)",
+      "Bash(mv \"128x128 - White.png\" kx-logo-white-128.png)",
+      "Bash(mv \"64x64 - White.png\" kx-logo-white-64.png)",
+      "Bash(mv \"32x32 - White.png\" kx-logo-white-32.png)",
+      "Bash(mv \"Footer Horizontal.png\" doodles-desktop.png)",
+      "Bash(mv \"Footer Horizontal 2.0.png\" doodles-desktop-2.png)"
+    ]
+  },
+  "enabledPlugins": {
+    "ponytail@ponytail": true
+  }
+}

anyscribe-0.16.0/.gitattributes

@@ -0,0 +1,6 @@
+* text=auto
+
+ui/**/* text eol=lf
+src/anyscribe/web/static/**/*.html text eol=lf
+src/anyscribe/web/static/**/*.css text eol=lf
+src/anyscribe/web/static/**/*.js text eol=lf

anyscribe-0.16.0/.github/workflows/ci.yml

@@ -0,0 +1,63 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+jobs:
+  python:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package and dev tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+          python -m pip install build
+
+      - name: Lint
+        run: ruff check src tests
+
+      - name: Test
+        run: pytest
+
+      - name: Build package
+        run: python -m build
+
+      - name: Rehearse migration (fake HOME, throwaway venv)
+        run: bash scripts/rehearse-migration.sh
+
+  frontend:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: ui/package-lock.json
+
+      - name: Install frontend dependencies
+        working-directory: ui
+        run: npm ci
+
+      - name: Lint frontend
+        working-directory: ui
+        run: npm run lint
+
+      - name: Build frontend
+        working-directory: ui
+        run: npm run build
+
+      - name: Verify committed static bundle is current
+        run: git diff --exit-code -- src/anyscribe/web/static

anyscribe-0.16.0/.github/workflows/publish.yml

@@ -0,0 +1,71 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write  # Required for trusted publishing
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: ui/package-lock.json
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+          python -m pip install build
+
+      - name: Lint
+        run: ruff check src tests
+
+      - name: Test
+        run: pytest
+
+      - name: Install frontend dependencies
+        working-directory: ui
+        run: npm ci
+
+      - name: Lint frontend
+        working-directory: ui
+        run: npm run lint
+
+      - name: Build frontend
+        working-directory: ui
+        run: npm run build
+
+      - name: Verify committed static bundle is current
+        run: git diff --exit-code -- src/anyscribe/web/static
+
+      - name: Build package
+        run: python -m build
+
+      - name: Verify version matches tag
+        run: |
+          TAG="${GITHUB_REF#refs/tags/v}"
+          PKG_VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          if [ "$TAG" != "$PKG_VERSION" ]; then
+            echo "::error::Tag v$TAG does not match package version $PKG_VERSION"
+            exit 1
+          fi
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release create "${GITHUB_REF_NAME}" --title "${GITHUB_REF_NAME}" --generate-notes

anyscribe-0.16.0/.gitignore

@@ -0,0 +1,44 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.venv/
+*.egg
+
+# Environment and secrets
+.env
+*.env.local
+
+# Media files (downloaded content)
+*.mp3
+*.mp4
+*.m4a
+*.wav
+*.ogg
+*.flac
+*.webm
+
+# Claude Code (local-only working state; skills + settings are shared)
+.claude/settings.local.json
+
+# Node.js (frontend build tooling)
+ui/node_modules/
+ui/dist/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# App runtime (these live in ~/.anyscribe/)
+sessions/
+tmp/
+logs/
+.vercel
+.env*.local

anyscribe-0.16.0/AGENTS.md

@@ -0,0 +1,86 @@
+# anyscribe — Agent Directives
+
+## Before Starting Work
+
+1. Read `CLAUDE.md` for architecture and patterns
+2. Read `docs/building/_index.md` for recent project history
+3. If your task touches providers or downloaders, read the relevant living doc
+4. Check `docs/building/journal/` for any recent entries related to your task area
+
+## Memory Layer
+
+`docs/building/journal/` is the project memory. It exists so that agents in future sessions have context about past decisions, bugs, and research.
+
+### Reading memory (before work)
+
+- Scan `docs/building/_index.md` — it's a newest-first table of all entries
+- Read any entries tagged with your task area
+- This prevents re-investigating solved problems or re-debating settled decisions
+
+### Writing memory (after work)
+
+After completing significant work, create a journal entry:
+
+```
+docs/building/journal/YYYY-MM-DD-<descriptive-slug>.md
+```
+
+With frontmatter:
+```yaml
+---
+type: decision|research|troubleshooting|learning
+tags: [relevant, tags]
+tldr: "One-line summary"
+---
+```
+
+Then prepend a row to `docs/building/_index.md`.
+
+## Post-Commit Checklist
+
+**After every significant commit**, follow `docs/building/COMMIT_CHECKLIST.md`. It has per-scenario checklists (new command, new provider, new downloader, version bump) and grep commands to catch stale references. This is mandatory.
+
+## Documentation Requirements
+
+### Developer docs (`docs/building/`)
+- Every PR or significant change MUST include a building doc update
+- If you changed architecture: update `docs/building/architecture.md`
+- If you added/changed a provider: update `docs/building/providers.md`
+- If you added/changed a downloader: update `docs/building/downloaders.md`
+- If you made a non-trivial decision: write a journal entry explaining why
+
+### User docs (`docs/user/`)
+- If you added/changed a user-facing command or flag: update `docs/user/commands.md`
+- If you changed config options: update `docs/user/configuration.md`
+- If you changed the onboarding flow: update `docs/user/getting-started.md`
+- User docs target semi-technical users new to CLI — explain jargon, show examples, include troubleshooting
+- Every user doc has frontmatter: `summary`, `read_when`, `title`
+
+## Quick Context
+
+- CLI entry point: `src/anyscribe/cli/main.py`
+- Onboarding + provider info: `src/anyscribe/cli/onboard.py`
+- Config/providers commands: `src/anyscribe/cli/config_cmd.py`
+- Download command: `src/anyscribe/cli/download.py`
+- Batch processing: `src/anyscribe/cli/batch.py`
+- Config loading: `src/anyscribe/config/settings.py`
+- Path constants: `src/anyscribe/config/paths.py`
+- Provider ABC + registry: `src/anyscribe/providers/base.py`, `providers/__init__.py`
+- Downloader ABC + registry: `src/anyscribe/downloaders/base.py`, `downloaders/registry.py`
+- Core flow: `src/anyscribe/core/orchestrator.py`
+- Dependency checker: `src/anyscribe/core/deps.py`
+- Update system: `src/anyscribe/core/updater.py`
+- Web UI backend: `src/anyscribe/web/app.py` (FastAPI factory + static serving)
+- Web UI routes: `src/anyscribe/web/routes/` (transcribe, history, config, health, system)
+- Web UI job manager: `src/anyscribe/web/jobs.py` (ThreadPoolExecutor + asyncio bridge)
+- Frontend source: `ui/` (React + TypeScript + Vite, builds to `web/static/`)
+
+## Key Dependencies
+
+- `beaupy` — arrow-key selectors in onboarding wizard
+- `yt-dlp` — YouTube + Instagram downloader (subprocess; cookies via `--cookies-from-browser` for IG)
+- `faster-whisper` — local transcription (optional, only for `local` provider)
+
+## Cross-Platform
+
+All code must work on macOS and Linux. Use `pathlib.Path` everywhere. No platform-specific assumptions.