hfl 0.1.0__tar.gz

hfl-0.1.0/.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: ggalancs
+custom: https://paypal.me/ggalancs

hfl-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,90 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the form below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: "When I run `hfl pull ...`, the following error occurs..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Run `hfl pull meta-llama/Llama-3.3-70B-Instruct`
+        2. Wait for download to complete
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: hfl Version
+      description: "Output of `hfl version`"
+      placeholder: "hfl v0.1.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - macOS
+        - Linux (Ubuntu/Debian)
+        - Linux (Other)
+        - Windows
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: python
+    attributes:
+      label: Python Version
+      description: "Output of `python --version`"
+      placeholder: "Python 3.12.0"
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error Logs
+      description: Paste any relevant error messages or logs
+      render: shell
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other relevant information (hardware, model being used, etc.)

hfl-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://github.com/ggalancs/hfl#readme
+    about: Check the README for usage instructions
+  - name: Discussions
+    url: https://github.com/ggalancs/hfl/discussions
+    about: Ask questions and discuss features

hfl-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,54 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! Please describe your idea below.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? Is it related to a frustration?
+      placeholder: "I'm always frustrated when..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like
+      placeholder: "It would be great if hfl could..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative solutions or features you've considered
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which part of hfl does this relate to?
+      options:
+        - CLI (commands, flags)
+        - API Server
+        - Model Download/Conversion
+        - Inference Engine
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or examples

hfl-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,47 @@
+## Description
+
+<!-- Describe your changes in detail -->
+
+## Type of Change
+
+<!-- Mark the relevant option with an [x] -->
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+
+## Related Issues
+
+<!-- Link any related issues using #issue_number -->
+
+Closes #
+
+## Checklist
+
+- [ ] I have read the [CONTRIBUTING](CONTRIBUTING.md) guidelines
+- [ ] My code follows the project's code style (ruff)
+- [ ] I have added tests that prove my fix/feature works
+- [ ] All new and existing tests pass (`pytest`)
+- [ ] I have updated documentation if needed
+
+## Compliance Modules
+
+<!-- If your changes affect any of these, explain how they're preserved -->
+
+Per the HRUL license, these modules must maintain their functionality:
+
+- [ ] License Verification - unchanged / updated to maintain functionality
+- [ ] Provenance Tracking - unchanged / updated to maintain functionality
+- [ ] AI Disclaimer - unchanged / updated to maintain functionality
+- [ ] Privacy Protection - unchanged / updated to maintain functionality
+- [ ] Gating Respect - unchanged / updated to maintain functionality
+
+## Screenshots (if applicable)
+
+<!-- Add screenshots to help explain your changes -->
+
+## Additional Notes
+
+<!-- Any additional information reviewers should know -->

hfl-0.1.0/.github/dependabot.yml

@@ -0,0 +1,39 @@
+version: 2
+updates:
+  # Python dependencies
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    reviewers:
+      - "ggalancs"  # Adjust to your GitHub username
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "deps"
+    groups:
+      dev-dependencies:
+        patterns:
+          - "pytest*"
+          - "ruff"
+          - "mypy"
+          - "coverage"
+      ml-dependencies:
+        patterns:
+          - "torch*"
+          - "transformers*"
+          - "llama-cpp*"
+
+  # GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "ci"

hfl-0.1.0/.github/workflows/build-executables.yml

@@ -0,0 +1,147 @@
+name: Build Executables
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version tag (e.g., v0.1.0)'
+        required: false
+        default: 'dev'
+      include_llama:
+        description: 'Include llama-cpp-python (larger binary)'
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            platform: linux
+            artifact_name: hfl-linux-x86_64
+          - os: macos-latest
+            platform: macos
+            artifact_name: hfl-macos-x86_64
+          - os: macos-14
+            platform: macos-arm
+            artifact_name: hfl-macos-arm64
+          - os: windows-latest
+            platform: windows
+            artifact_name: hfl-windows-x86_64
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pyinstaller
+          pip install -e .
+
+      - name: Install llama-cpp-python (optional)
+        if: ${{ inputs.include_llama }}
+        run: |
+          pip install llama-cpp-python
+        env:
+          CMAKE_ARGS: ${{ matrix.platform == 'macos' && '-DGGML_METAL=ON' || matrix.platform == 'macos-arm' && '-DGGML_METAL=ON' || '' }}
+
+      - name: Build executable
+        run: |
+          pyinstaller hfl.spec --clean
+
+      - name: Test executable (Unix)
+        if: matrix.platform != 'windows'
+        run: |
+          chmod +x dist/hfl
+          ./dist/hfl version
+          ./dist/hfl --help
+
+      - name: Test executable (Windows)
+        if: matrix.platform == 'windows'
+        run: |
+          ./dist/hfl.exe version
+          ./dist/hfl.exe --help
+
+      - name: Rename artifact (Unix)
+        if: matrix.platform != 'windows'
+        run: |
+          mv dist/hfl dist/${{ matrix.artifact_name }}
+
+      - name: Rename artifact (Windows)
+        if: matrix.platform == 'windows'
+        run: |
+          mv dist/hfl.exe dist/${{ matrix.artifact_name }}.exe
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact_name }}
+          path: dist/${{ matrix.artifact_name }}${{ matrix.platform == 'windows' && '.exe' || '' }}
+          retention-days: 30
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    if: ${{ inputs.version != 'dev' }}
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Create checksums
+        run: |
+          cd artifacts
+          find . -type f \( -name "hfl-*" \) -exec sha256sum {} \; > checksums.txt
+          cat checksums.txt
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ inputs.version }}
+          name: hfl ${{ inputs.version }}
+          draft: true
+          files: |
+            artifacts/hfl-linux-x86_64/*
+            artifacts/hfl-macos-x86_64/*
+            artifacts/hfl-macos-arm64/*
+            artifacts/hfl-windows-x86_64/*
+            artifacts/checksums.txt
+          body: |
+            ## hfl ${{ inputs.version }}
+
+            ### Downloads
+
+            | Platform | Architecture | File |
+            |----------|-------------|------|
+            | Linux | x86_64 | `hfl-linux-x86_64` |
+            | macOS | x86_64 (Intel) | `hfl-macos-x86_64` |
+            | macOS | arm64 (Apple Silicon) | `hfl-macos-arm64` |
+            | Windows | x86_64 | `hfl-windows-x86_64.exe` |
+
+            ### Installation
+
+            **Linux/macOS:**
+            ```bash
+            chmod +x hfl-*
+            sudo mv hfl-* /usr/local/bin/hfl
+            ```
+
+            **Windows:**
+            Move `hfl-windows-x86_64.exe` to a folder in your PATH, or run directly.
+
+            ### Verify checksums
+            ```bash
+            sha256sum -c checksums.txt
+            ```

hfl-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,90 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:  # Allow manual triggering
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: |
+          pytest tests/ --cov=hfl --cov-report=xml --cov-report=term-missing
+
+      - name: Upload coverage to Codecov
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Run ruff check
+        run: ruff check src/hfl tests/
+
+      - name: Run ruff format check
+        run: ruff format --check src/hfl tests/
+
+  type-check:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run mypy
+        run: |
+          mypy src/hfl/api/ src/hfl/cli/ --ignore-missing-imports

hfl-0.1.0/.github/workflows/license-check.yml

@@ -0,0 +1,41 @@
+# R7 - License Check (Legal Audit)
+# Prevents introduction of copyleft dependencies
+
+name: License Check
+
+on:
+  workflow_dispatch:  # Solo ejecución manual
+
+jobs:
+  check-licenses:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          pip install "pip-licenses>=4.0,<5.0"
+          pip install -e .
+
+      - name: Check for copyleft licenses
+        run: |
+          echo "Checking for GPL/AGPL/LGPL licenses..."
+          pip-licenses -f plain -u --fail-on="GPL;GPLv2;GPLv3;AGPL;AGPLv3;LGPL;LGPLv2;LGPLv3"
+
+      - name: Generate license report
+        if: always()
+        run: |
+          pip-licenses -f markdown -u > license-report.md
+          cat license-report.md
+
+      - name: Upload license report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: license-report
+          path: license-report.md

hfl-0.1.0/.github/workflows/lint.yml

@@ -0,0 +1,43 @@
+name: Lint
+
+on:
+  workflow_dispatch:  # Solo ejecución manual
+
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Run ruff check
+        run: ruff check src/ tests/
+
+      - name: Run ruff format check
+        run: ruff format --check src/ tests/
+
+  mypy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+          pip install mypy
+
+      - name: Run mypy
+        run: mypy src/hfl --ignore-missing-imports
+        continue-on-error: true  # Gradual typing adoption

hfl-0.1.0/.github/workflows/pages.yml

@@ -0,0 +1,50 @@
+# GitHub Pages deployment workflow
+name: Deploy Documentation to GitHub Pages
+
+on:
+  push:
+    branches: ["main"]
+    paths:
+      - "docs/**"
+      - "README.md"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Create site directory
+        run: |
+          mkdir -p _site
+          cp docs/hfl-architecture-complete.html _site/index.html
+          cp docs/hfl-arquitectura-completa.html _site/arquitectura.html
+          cp README.md _site/README.md
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

hfl-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,81 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'  # Run on version tags like v0.1.0
+
+jobs:
+  build:
+    name: Build Distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  test:
+    name: Test Installation
+    needs: build
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.12"]
+
+    steps:
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Download distribution
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Install from wheel
+        run: pip install dist/*.whl
+
+      - name: Test CLI
+        run: |
+          hfl --help
+          hfl --version || true
+
+  publish:
+    name: Publish to PyPI
+    needs: [build, test]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/hfl/
+
+    permissions:
+      id-token: write  # Required for trusted publishing
+
+    steps:
+      - name: Download distribution
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # Uses trusted publishing - no API token needed