ableton-ai 2.1.0__tar.gz

ableton_ai-2.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,70 @@
+name: Bug Report
+description: Report a bug or issue
+labels: ["bug"]
+body:
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which part of AbletonMCP is affected?
+      options:
+        - Remote Script (Ableton control surface)
+        - MCP Server (Claude Desktop / Cursor)
+        - REST API Server
+        - Max for Live Device
+        - Documentation
+    validations:
+      required: true
+
+  - type: input
+    id: ableton-version
+    attributes:
+      label: Ableton Live Version
+      placeholder: "e.g. 12.1, 11.3.4"
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      placeholder: "e.g. macOS 15.2, Windows 11"
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Describe the bug. What did you expect to happen vs what actually happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: How can we reproduce this issue?
+      placeholder: |
+        1. Load the Remote Script
+        2. Send command X
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error logs
+      description: Paste any relevant error messages or logs (check Ableton's Log.txt or Max Console)
+      render: shell
+    validations:
+      required: false
+
+  - type: input
+    id: command
+    attributes:
+      label: Command that failed (if applicable)
+      placeholder: "e.g. set_clip_automation, freeze_track"
+    validations:
+      required: false

ableton_ai-2.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,42 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which part of AbletonMCP would this affect?
+      options:
+        - Remote Script (new Ableton command)
+        - MCP Server
+        - REST API Server
+        - Max for Live Device
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What would you like?
+      description: Describe the feature or improvement you'd like to see
+    validations:
+      required: true
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use case
+      description: How would you use this feature in your workflow?
+    validations:
+      required: false
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Have you tried any workarounds?
+    validations:
+      required: false

ableton_ai-2.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,29 @@
+## What does this PR do?
+
+<!-- Brief description of the changes -->
+
+## Component
+
+<!-- Check the relevant boxes -->
+
+- [ ] Remote Script
+- [ ] MCP Server
+- [ ] REST API Server
+- [ ] Max for Live Device
+- [ ] Documentation
+- [ ] Tests
+
+## Testing
+
+<!-- How did you test these changes? -->
+
+- [ ] Tested in Ableton Live (version: )
+- [ ] Ran existing tests
+- [ ] Added new tests
+
+## Checklist
+
+- [ ] Code follows existing style
+- [ ] Updated ALLOWED_COMMANDS in rest_api_server.py (if adding new commands)
+- [ ] Updated command routing in Remote Script _process_command (if adding new commands)
+- [ ] No secrets or credentials in code

ableton_ai-2.1.0/.github/workflows/fix-code-style.yml

@@ -0,0 +1,36 @@
+# The equivalent of Spatie's fix-php-code-style-issues workflow.
+# Instead of failing a PR over formatting, it fixes it and pushes the fix back.
+name: fix code style
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "**.py"
+      - "pyproject.toml"
+
+permissions:
+  contents: write
+
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    name: ruff fix
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.head_ref }}
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Fix and format
+        run: |
+          uvx ruff check --fix src tests
+          uvx ruff format src tests
+
+      - name: Commit anything that changed
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "Fix code style with ruff"

ableton_ai-2.1.0/.github/workflows/lint.yml

@@ -0,0 +1,32 @@
+name: lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    name: ruff
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv sync --all-extras
+      - name: Check formatting
+        run: uv run ruff format --check src tests
+      - name: Lint
+        run: uv run ruff check src tests
+
+  mypy:
+    runs-on: ubuntu-latest
+    name: mypy
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv sync --all-extras
+      - run: uv run mypy

ableton_ai-2.1.0/.github/workflows/tests.yml

@@ -0,0 +1,34 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    name: ${{ matrix.os }} / python ${{ matrix.python-version }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests
+        run: uv run pytest --cov --cov-report=term-missing -m "not integration"

ableton_ai-2.1.0/.gitignore

@@ -0,0 +1,19 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.DS_Store
+
+# Coverage
+.coverage
+.coverage.*
+htmlcov/
+
+# bundled at build time via force-include; source-tree copy for local dev only
+src/ableton_mcp/_remote_script/

ableton_ai-2.1.0/.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+# Install once with: uv run pre-commit install
+# Run against everything with: uv run pre-commit run --all-files
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.2
+    hooks:
+      # Autofix first, then format. Order matters: fixes can change formatting.
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: debug-statements
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.18.2
+    hooks:
+      - id: mypy
+        files: ^src/
+        additional_dependencies: [types-requests]

ableton_ai-2.1.0/.python-version

@@ -0,0 +1 @@
+3.13