homeassistant-ai
diff --git a/‎.github/workflows/build-binary.yml‎
Lines changed: 187 additions & 0 deletions b/‎.github/workflows/build-binary.yml‎
Lines changed: 187 additions & 0 deletions
diff --git a/‎PRIVACY.md‎
Lines changed: 74 additions & 0 deletions b/‎PRIVACY.md‎
Lines changed: 74 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 28 additions & 0 deletions b/‎README.md‎
Lines changed: 28 additions & 0 deletions
@@ -0,0 +1,187 @@
+name: Build and Release Binaries
+
+on:
+  release:
+    types: [published]
+  pull_request:
+    branches: [master]
+    paths:
+      - 'src/**'
+      - 'packaging/binary/**'
+      - 'packaging/mcpb/**'
+      - '.github/workflows/build-binary.yml'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to build (e.g., 4.7.4)'
+        required: true
+        default: '0.0.0-dev'
+
+# Restrict permissions by default (security best practice)
+permissions:
+  contents: read
+
+jobs:
+  build:
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            artifact_name: ha-mcp-linux
+            binary_ext: ''
+            platform: linux
+            create_mcpb: false
+          - os: windows-latest
+            artifact_name: ha-mcp-windows
+            binary_ext: '.exe'
+            platform: win32
+            create_mcpb: true
+          - os: macos-latest
+            artifact_name: ha-mcp-macos-arm64
+            binary_ext: ''
+            platform: darwin
+            create_mcpb: true
+
+    runs-on: ${{ matrix.os }}
+    name: Build on ${{ matrix.os }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Create virtual environment and install dependencies
+        run: |
+          uv venv .venv
+          uv pip install -e . pyinstaller
+        shell: bash
+
+      - name: Activate venv (Unix)
+        if: runner.os != 'Windows'
+        run: echo "$PWD/.venv/bin" >> $GITHUB_PATH
+
+      - name: Activate venv (Windows)
+        if: runner.os == 'Windows'
+        run: echo "$PWD/.venv/Scripts" >> $env:GITHUB_PATH
+        shell: pwsh
+
+      - name: Build binary
+        run: pyinstaller packaging/binary/ha-mcp.spec
+
+      - name: Run smoke test (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          chmod +x dist/ha-mcp
+          # Run the built-in smoke test to verify all libraries are bundled
+          ./dist/ha-mcp --smoke-test
+
+      - name: Run smoke test (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          # Run the built-in smoke test to verify all libraries are bundled
+          & "dist\ha-mcp.exe" --smoke-test
+          if ($LASTEXITCODE -ne 0) {
+            Write-Host "Smoke test failed with exit code $LASTEXITCODE"
+            exit $LASTEXITCODE
+          }
+
+      - name: Set version
+        id: version
+        shell: bash
+        run: |
+          if [ "${{ github.event_name }}" = "release" ]; then
+            VERSION="${{ github.event.release.tag_name }}"
+            # Remove 'v' prefix if present
+            VERSION="${VERSION#v}"
+          else
+            VERSION="${{ github.event.inputs.version }}"
+          fi
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Rename binary for artifact
+        shell: bash
+        run: |
+          mv dist/ha-mcp${{ matrix.binary_ext }} dist/${{ matrix.artifact_name }}${{ matrix.binary_ext }}
+
+      - name: Create mcpb bundle (Windows/macOS only)
+        if: matrix.create_mcpb
+        shell: bash
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          PLATFORM="${{ matrix.platform }}"
+          BINARY_EXT="${{ matrix.binary_ext }}"
+
+          # Create mcpb directory structure
+          mkdir -p mcpb-bundle
+
+          # Copy binary to bundle
+          cp dist/${{ matrix.artifact_name }}${{ matrix.binary_ext }} mcpb-bundle/ha-mcp${{ matrix.binary_ext }}
+
+          # Copy icon to bundle
+          cp packaging/mcpb/icon.png mcpb-bundle/icon.png
+
+          # Generate manifest.json with auto-discovered tools
+          python packaging/mcpb/generate_manifest.py "$VERSION" "$PLATFORM" "$BINARY_EXT"
+
+          # Create .mcpb file (zip archive)
+          cd mcpb-bundle
+          if [ "${{ runner.os }}" = "Windows" ]; then
+            7z a -tzip "../${{ matrix.artifact_name }}.mcpb" *
+          else
+            zip -r "../${{ matrix.artifact_name }}.mcpb" *
+          fi
+          cd ..
+
+      - name: Upload binary artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact_name }}
+          path: dist/${{ matrix.artifact_name }}${{ matrix.binary_ext }}
+          if-no-files-found: error
+
+      - name: Upload mcpb artifact
+        if: matrix.create_mcpb
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact_name }}-mcpb
+          path: ${{ matrix.artifact_name }}.mcpb
+          if-no-files-found: error
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release'
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: List artifacts
+        run: find artifacts -type f
+
+      - name: Upload binaries to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            artifacts/ha-mcp-linux/ha-mcp-linux
+            artifacts/ha-mcp-windows/ha-mcp-windows.exe
+            artifacts/ha-mcp-macos-arm64/ha-mcp-macos-arm64
+            artifacts/ha-mcp-windows-mcpb/ha-mcp-windows.mcpb
+            artifacts/ha-mcp-macos-arm64-mcpb/ha-mcp-macos-arm64.mcpb
@@ -0,0 +1,74 @@
+# Privacy Policy
+
+**Last updated:** November 2024
+
+## Overview
+
+Home Assistant MCP Server ("ha-mcp") runs entirely on your local machine and communicates only with your own Home Assistant instance. We are committed to transparency about any data collection.
+
+## Data Collection
+
+**Ha-mcp does not collect any data.** The server runs entirely locally on your machine and does not send telemetry, analytics, or any information to external servers.
+
+**We do NOT collect:**
+- Entity names or IDs
+- Home Assistant configuration
+- Personal information
+- Automation or script content
+- Any data from your smart home devices
+- Usage statistics or analytics
+- Error reports (unless you explicitly send them)
+
+## Bug Reports
+
+Ha-mcp may include a bug reporting feature that allows you to send diagnostic information when you encounter issues. Bug reports are:
+
+- **Only sent with your explicit approval** — the AI assistant will ask before sending
+- **Reviewed with you first** — you'll see what information is included
+- **Anonymized** — personal data should be replaced with generic values before submission
+
+You are always in control of whether to send a bug report.
+
+## Your Home Assistant Data
+
+When you use ha-mcp, Claude Desktop accesses data from your Home Assistant instance, including entity states, automations, and device information. This data:
+
+- Is processed locally by Claude Desktop
+- Is subject to [Anthropic's Privacy Policy](https://www.anthropic.com/privacy)
+- Is NOT collected, stored, or transmitted by ha-mcp
+
+## Third-Party Services
+
+Ha-mcp communicates with:
+
+- **Your Home Assistant instance** — via the URL and token you provide
+- **Claude Desktop** — the MCP client that runs ha-mcp
+
+Ha-mcp does not communicate with any other external services.
+
+## Data Security
+
+- Your Home Assistant credentials are stored locally by Claude Desktop
+- Bug reports are only sent when you explicitly approve
+- No data leaves your local network except to your Home Assistant instance
+
+## Changes to This Policy
+
+We may update this privacy policy to reflect changes in our practices. Significant changes will be noted in release notes.
+
+## Contact
+
+For privacy-related questions or concerns:
+
+- **GitHub Issues:** [https://github.com/homeassistant-ai/ha-mcp/issues](https://github.com/homeassistant-ai/ha-mcp/issues)
+- **Email:** github@qc-h.net
+
+## Summary
+
+| Aspect | Status |
+|--------|--------|
+| Telemetry | None |
+| Personal data collected | None |
+| Bug reports | User-approved only |
+| Local processing | Yes |
+| Third-party sharing | None |
@@ -30,6 +30,22 @@
 
 ---
 
+## 💬 What Can You Do With It?
+
+Just talk to Claude naturally. Here are some real examples:
+
+| You Say | What Happens |
+|---------|--------------|
+| *"Turn off all the lights in the living room"* | Finds entities by room using fuzzy search, controls them in bulk |
+| *"Is everything healthy? Any devices offline?"* | Checks system health, finds unavailable entities, reports issues |
+| *"Create an automation that turns on the porch light at sunset"* | Creates the automation with proper triggers and actions |
+| *"The work-from-home automation doesn't work anymore, check what's going on"* | Analyzes execution traces, finds the bug, and auto-fixes it |
+| *"Add milk to my shopping list"* | Finds your shopping list and adds the item |
+
+No YAML editing. No entity ID lookups. Just describe what you want.
+
+---
+
 ## ✨ Features
 
 ### 🔍 Discover, Search and Query
@@ -588,6 +604,18 @@ For future enhancements and planned features, see the [Development Roadmap](http
 
 ---
 
+## 🔒 Privacy
+
+Ha-mcp runs **entirely locally** on your machine. We collect no data, send no telemetry, and have no external dependencies beyond your own Home Assistant instance.
+
+- **No analytics or tracking**
+- **No cloud services**
+- **Your data stays on your network**
+
+For full details, see our [Privacy Policy](PRIVACY.md).
+
+---
+
 ## 📄 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.