fast-crewai 0.1.0__tar.gz

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

@@ -0,0 +1,102 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Test on ${{ matrix.os }} - Python ${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        enable-cache: true
+        cache-dependency-glob: "pyproject.toml"
+
+    - name: Set up Python ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
+
+    - name: Set up Rust
+      uses: actions-rust-lang/setup-rust-toolchain@v1
+      with:
+        toolchain: stable
+
+    - name: Cache Rust build
+      uses: actions/cache@v4
+      with:
+        path: |
+          ~/.cargo/registry
+          ~/.cargo/git
+          target
+        key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-cargo-
+
+    - name: Install dependencies
+      run: uv sync --dev
+
+    - name: Build Rust extension
+      run: uv run maturin develop
+      continue-on-error: true
+
+    - name: Run fast tests
+      run: uv run pytest -m "not slow and not integration and not performance" -v --tb=short
+
+    - name: Run all tests with coverage
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
+      run: uv run pytest --cov=fast_crewai --cov-report=xml --cov-report=html --cov-report=term -v
+
+    - name: Upload coverage to Codecov
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
+      uses: codecov/codecov-action@v4
+      with:
+        file: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false
+
+  lint:
+    name: Lint and Format Check
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        enable-cache: true
+        cache-dependency-glob: "pyproject.toml"
+
+    - name: Set up Python
+      run: uv python install 3.11
+
+    - name: Install dependencies
+      run: uv sync --dev
+
+    - name: Check formatting with black
+      run: uv run black --check fast_crewai tests
+
+    - name: Check import sorting with isort
+      run: uv run isort --check-only fast_crewai tests
+
+    - name: Lint with flake8
+      run: uv run flake8 fast_crewai tests --max-line-length=100 --extend-ignore=E203,W503
+
+    - name: Type check with mypy
+      run: uv run mypy fast_crewai --ignore-missing-imports
+      continue-on-error: true

fast_crewai-0.1.0/.github/workflows/compatibility-tests.yml

@@ -0,0 +1,145 @@
+name: CrewAI Compatibility Tests
+
+permissions:
+  contents: write
+
+on:
+  # Run on pushes to main
+  push:
+    branches: [ main ]
+
+  # Allow manual trigger
+  workflow_dispatch:
+
+  # Run weekly to catch CrewAI changes
+  schedule:
+    - cron: '0 0 * * 0'  # Every Sunday at midnight
+
+jobs:
+  compatibility-test:
+    name: Test with CrewAI (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+
+    steps:
+    - name: Checkout Fast-CrewAI
+      uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        enable-cache: true
+        cache-dependency-glob: "pyproject.toml"
+
+    - name: Set up Python ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
+
+    - name: Set up Rust
+      uses: actions-rust-lang/setup-rust-toolchain@v1
+      with:
+        toolchain: stable
+
+    - name: Cache Rust build
+      uses: actions/cache@v4
+      with:
+        path: |
+          ~/.cargo/registry
+          ~/.cargo/git
+          target
+        key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-cargo-
+
+    - name: Install system dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y build-essential
+
+    - name: Install dependencies
+      run: uv sync --dev
+
+    - name: Run Compatibility Tests
+      run: |
+        # Run tests that don't require OPENAI_API_KEY
+        uv run python scripts/test_crewai_compatibility.py \
+          --crewai-branch main \
+          --keep-env \
+          --verbose \
+          --no-api-key \
+          --report-output COMPATIBILITY.md
+
+    - name: Upload compatibility report
+      uses: actions/upload-artifact@v4
+      with:
+        name: compatibility-report-py${{ matrix.python-version }}
+        path: COMPATIBILITY.md
+        retention-days: 30
+
+    - name: Upload test results
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: test-results-py${{ matrix.python-version }}
+        path: |
+          test_compatibility/pytest_results.json
+          COMPATIBILITY.md
+        retention-days: 30
+
+  update-compatibility-report:
+    name: Update COMPATIBILITY.md
+    needs: compatibility-test
+    runs-on: ubuntu-latest
+    # Only run on push to main or scheduled runs, not on PRs
+    if: github.event_name == 'push' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+
+    steps:
+    - name: Checkout Fast-CrewAI
+      uses: actions/checkout@v4
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Download compatibility report
+      uses: actions/download-artifact@v4
+      with:
+        # Use Python 3.12 report as the canonical one
+        name: compatibility-report-py3.12
+        path: .
+
+    - name: Check for changes
+      id: check_changes
+      run: |
+        if git diff --quiet COMPATIBILITY.md 2>/dev/null; then
+          echo "changed=false" >> $GITHUB_OUTPUT
+        else
+          echo "changed=true" >> $GITHUB_OUTPUT
+        fi
+
+    - name: Commit and push COMPATIBILITY.md
+      if: steps.check_changes.outputs.changed == 'true'
+      run: |
+        git config --local user.email "github-actions[bot]@users.noreply.github.com"
+        git config --local user.name "github-actions[bot]"
+        git add COMPATIBILITY.md
+        git commit -m "Update COMPATIBILITY.md [skip ci]"
+        git push
+
+  compatibility-test-summary:
+    name: Compatibility Test Summary
+    needs: compatibility-test
+    runs-on: ubuntu-latest
+    if: always()
+
+    steps:
+    - name: Check test results
+      run: |
+        if [ "${{ needs.compatibility-test.result }}" == "success" ]; then
+          echo "✅ All compatibility tests passed!"
+          exit 0
+        else
+          echo "❌ Some compatibility tests failed"
+          exit 1
+        fi

fast_crewai-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,169 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Dry run (build but do not publish)'
+        required: false
+        default: 'true'
+        type: choice
+        options:
+          - 'true'
+          - 'false'
+
+permissions:
+  contents: read
+
+jobs:
+  build-linux:
+    name: Build Linux wheels
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          # Explicitly specify Python versions to avoid building for unsupported versions
+          # PyO3 0.23.x supports up to Python 3.13 (not 3.14 yet)
+          args: --release --out dist -i python3.9 -i python3.10 -i python3.11 -i python3.12 -i python3.13
+          sccache: 'true'
+          manylinux: auto
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-linux-${{ matrix.target }}
+          path: dist
+
+  build-macos:
+    name: Build macOS wheels
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      matrix:
+        include:
+          - runner: macos-15
+            target: x86_64
+          - runner: macos-15
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          # Explicitly specify Python versions to avoid building for unsupported versions
+          # PyO3 0.23.x supports up to Python 3.13 (not 3.14 yet)
+          args: --release --out dist -i python3.9 -i python3.10 -i python3.11 -i python3.12 -i python3.13
+          sccache: 'true'
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: dist
+
+  build-windows:
+    name: Build Windows wheels
+    runs-on: windows-latest
+    strategy:
+      matrix:
+        target: [x64]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          # Explicitly specify Python versions to avoid building for unsupported versions
+          # PyO3 0.23.x supports up to Python 3.13 (not 3.14 yet)
+          args: --release --out dist -i python3.9 -i python3.10 -i python3.11 -i python3.12 -i python3.13
+          sccache: 'true'
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows-${{ matrix.target }}
+          path: dist
+
+  build-sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+
+  publish:
+    name: Publish to PyPI
+    needs: [build-linux, build-macos, build-windows, build-sdist]
+    runs-on: ubuntu-latest
+    if: (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')) || (github.event_name == 'workflow_dispatch' && github.event.inputs.dry_run == 'false')
+    environment:
+      name: pypi
+      url: https://pypi.org/project/fast-crewai/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+          pattern: wheels-*
+          merge-multiple: true
+
+      - name: List built wheels
+        run: ls -la dist/
+
+      - name: Publish to PyPI
+        uses: PyO3/maturin-action@v1
+        with:
+          command: upload
+          args: --non-interactive --skip-existing dist/*
+
+  publish-testpypi:
+    name: Publish to TestPyPI (dry run)
+    needs: [build-linux, build-macos, build-windows, build-sdist]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.dry_run == 'true'
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/fast-crewai/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+          pattern: wheels-*
+          merge-multiple: true
+
+      - name: List built wheels
+        run: ls -la dist/
+
+      - name: Publish to TestPyPI
+        uses: PyO3/maturin-action@v1
+        with:
+          command: upload
+          args: --non-interactive --skip-existing --repository testpypi dist/*

fast_crewai-0.1.0/.gitignore

@@ -0,0 +1,120 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyc
+
+# C extensions
+*.so
+*.dylib
+*.dll
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Rust/Maturin build artifacts
+/target/
+**/*.rs.bk
+*.so
+*.dylib
+*.dll
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+test_results/
+*.log
+
+# Fast-CrewAI specific test artifacts
+test_compatibility/
+test_results.log
+*.db
+*.db-journal
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+
+# Temporary files
+*.tmp
+*.temp
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# Documentation build
+docs/_build/
+/site
+
+# uv
+uv.lock

fast_crewai-0.1.0/BENCHMARK.md

@@ -0,0 +1,92 @@
+# Fast-CrewAI Benchmark Report
+
+> Generated: 2025-12-10 00:16:33 UTC
+
+## Summary
+
+| Metric | Value |
+|--------|-------|
+| Rust Acceleration | ✅ Available |
+| Iterations | 300 |
+| Average Improvement | 🚀 13.43x |
+
+## Performance Improvements
+
+| Component | Improvement |
+|-----------|-------------|
+| Memory Storage | 🚀 1.00x faster |
+| Tool Execution | 🚀 17.34x faster |
+| Serialization | 🚀 34.51x faster |
+| Database | ⚠️ 1.16x slower |
+
+## Memory Usage
+
+| Component | Python | Rust | Savings |
+|-----------|--------|------|---------|
+| Memory Storage | 0.1 MB | 0.1 MB | ➡️ Same |
+| Tool Execution | 1.2 MB | 0.0 MB | 🚀 99.2% less |
+| Serialization | 8.0 MB | 3.4 MB | 🚀 57.7% less |
+| Database | 0.1 MB | 0.1 MB | 🚀 30.8% less |
+
+## Environment
+
+| Component | Version |
+|-----------|---------|
+| Python | 3.12.3 |
+| Platform | Linux-6.14.0-36-generic-x86_64-with-glibc2.39 |
+| Fast-CrewAI | 0.1.0 |
+| Rust Extension | available |
+
+## Detailed Results
+
+### Memory Storage
+
+| Metric | Performance |
+|--------|-------------|
+| Save | Python: 541,201 ops/s | Rust: 541,666 ops/s |
+| Search | Python: 667,584 ops/s | Rust: 674,161 ops/s |
+| Memory | Python: 0.1 MB | Rust: 0.1 MB |
+
+### Tool Execution
+
+| Metric | Performance |
+|--------|-------------|
+| Execute | Python: 670 ops/s | Rust: 11,616 ops/s |
+| Memory | Python: 1.2 MB | Rust: 0.0 MB |
+
+### Serialization
+
+| Metric | Performance |
+|--------|-------------|
+| Serialize | Python: 2,333 ops/s | Rust: 80,525 ops/s |
+| Deserialize | Python: 3,531 ops/s | Rust: 51,525 ops/s |
+| Memory | Python: 8.0 MB | Rust: 3.4 MB |
+
+### Database Operations
+
+| Metric | Performance |
+|--------|-------------|
+| Insert | Python: 484 ops/s | Rust: 416 ops/s |
+| Query | Python: 1,262 ops/s | Rust: 1,586 ops/s |
+| FTS Search | Python: 913 ops/s | Rust: 10,206 ops/s |
+| Memory | Python: 0.1 MB | Rust: 0.1 MB |
+
+## How to Reproduce
+
+```bash
+# Run benchmarks locally
+uv run python scripts/test_benchmarking.py \
+    --iterations 300 \
+    --report-output BENCHMARK.md
+```
+
+## Notes
+
+- Benchmarks compare Python implementations with Rust-accelerated implementations
+- Higher improvement numbers indicate better Rust performance
+- Results may vary based on hardware and system load
+- The Rust extension must be built for acceleration to be available
+
+---
+
+*This report was automatically generated by the Fast-CrewAI benchmark suite.*