feat: initial Python SDK setup

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,25 @@
+---
+name: Bug Report
+about: Report a bug in layerv-qurl
+labels: bug
+---
+
+## Description
+
+<!-- What happened? -->
+
+## Expected Behavior
+
+<!-- What did you expect? -->
+
+## Steps to Reproduce
+
+1.
+2.
+3.
+
+## Environment
+
+- Python version:
+- layerv-qurl version:
+- OS:

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,13 @@
+---
+name: Feature Request
+about: Suggest a feature for layerv-qurl
+labels: enhancement
+---
+
+## Description
+
+<!-- What would you like? -->
+
+## Use Case
+
+<!-- Why do you need this? -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,11 @@
+## Summary
+
+<!-- Brief description of what this PR does -->
+
+## Test plan
+
+<!-- How was this tested? -->
+
+- [ ] `ruff check` passes
+- [ ] `mypy src/` passes
+- [ ] `pytest tests/ -v` passes

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly

.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: pip install -e ".[dev,langchain]"
+      - name: Lint
+        run: ruff check
+      - name: Type check
+        if: matrix.python-version == '3.12'
+        run: mypy src/
+      - name: Test
+        run: pytest tests/ -v

.github/workflows/claude-code-review.yml

@@ -0,0 +1,42 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+jobs:
+  claude-review:
+    if: github.actor != 'dependabot[bot]'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        uses: anthropics/claude-code-action@1fc90f3ed982521116d8ff6d85b948c9b12cae3e # v1
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+
+          claude_args: '--model claude-opus-4-6 --allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'

.github/workflows/release-please.yml

@@ -0,0 +1,62 @@
+name: Release Please
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4
+        id: release
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  test:
+    needs: release-please
+    if: needs.release-please.outputs.release_created
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: pip install -e ".[dev,langchain]"
+      - name: Test
+        run: pytest tests/ -v
+
+  publish:
+    needs: [release-please, test]
+    if: needs.release-please.outputs.release_created
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Set up Python
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install build tools
+        run: pip install build
+      - name: Build
+        run: python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@76f52bc884231f62b54a752585ace28ca25210fc # v1.12.4

.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/

.release-please-manifest.json

@@ -0,0 +1 @@
+{".": "0.1.0"}

CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

CLAUDE.md

@@ -0,0 +1,33 @@
+# CLAUDE.md — qurl-python
+
+## Critical Rules
+
+- **NEVER push directly to `main`.** Always create a branch and PR.
+- All commits must be signed.
+
+## Project
+
+Python SDK for the QURL API (`pip install layerv-qurl`). Extracted from `layervai/qurl-integrations`.
+
+## Commands
+
+```bash
+pip install -e ".[dev]"    # Install with dev dependencies
+ruff check                 # Lint
+mypy src/                  # Type check
+pytest tests/ -v           # Test
+```
+
+## Commit Format
+
+```
+<type>: <description>
+
+type: feat | fix | chore | docs | test | refactor | ci
+```
+
+Conventional commits drive Release Please versioning.
+
+## Release
+
+Merging to `main` triggers Release Please. Merging the release PR publishes to PyPI via OIDC.

CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# Contributing
+
+Thanks for your interest in contributing to `layerv-qurl`!
+
+## Development Setup
+
+```bash
+git clone https://github.com/layervai/qurl-python.git
+cd qurl-python
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev,langchain]"
+```
+
+## Running Checks
+
+```bash
+ruff check          # Lint
+mypy src/           # Type check
+pytest tests/ -v    # Tests
+```
+
+All three must pass before submitting a PR.
+
+## Pull Requests
+
+1. Fork the repo and create a branch from `main`
+2. Follow [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `docs:`, etc.)
+3. Add tests for new functionality
+4. Ensure all checks pass
+5. Open a PR — CI runs automatically
+
+## Commit Signing
+
+All commits must be GPG or SSH signed. GitHub will reject unsigned commits.
+
+## Releases
+
+Releases are automated via [Release Please](https://github.com/googleapis/release-please). Conventional commit messages drive version bumps:
+- `feat:` → minor version bump
+- `fix:` → patch version bump
+- `feat!:` or `BREAKING CHANGE:` → major version bump
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LayerV, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.