Merge remote-tracking branch 'origin/main' into codex/otel-traces

Author: tbille

.github/workflows/docs.yaml

@@ -4,18 +4,22 @@ on:
   push:
     branches: [main]
     paths:
-      - mkdocs.yml
       - 'docs/**'
       - 'src/**'
-      - 'scripts/hooks.py'
+      - 'scripts/generate_provider_table.py'
+      - 'scripts/generate_llms_txt.py'
+      - 'scripts/generate_openapi.py'
+      - 'scripts/generate_api_docs.py'
       - '.github/workflows/**'
       - 'pyproject.toml'
   pull_request:
     paths:
-      - mkdocs.yml
       - 'docs/**'
       - 'src/**'
-      - 'scripts/hooks.py'
+      - 'scripts/generate_provider_table.py'
+      - 'scripts/generate_llms_txt.py'
+      - 'scripts/generate_openapi.py'
+      - 'scripts/generate_api_docs.py'
       - '.github/workflows/**'
       - 'pyproject.toml'
   workflow_dispatch:
@@ -24,6 +28,8 @@ jobs:
   docs:
     permissions:
       contents: write
+      pages: write
+      id-token: write
     runs-on: ubuntu-latest
     steps:
       - name: Check out the repository
@@ -37,19 +43,39 @@ jobs:
           python-version: 3.13
           activate-environment: true
 
-      - name: Configure git
-        run: |
-          git config user.name 'github-actions[bot]'
-          git config user.email 'github-actions[bot]@users.noreply.github.com'
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install Python dependencies
+        run: uv sync --group docs --extra all
+
+      - name: Install docs dependencies
+        working-directory: docs
+        run: npm ci
+
+      - name: Generate provider table
+        run: uv run python scripts/generate_provider_table.py
 
-      - name: Install dependencies
-        run: |
-          uv sync --group docs --extra all
+      - name: Generate OpenAPI spec
+        run: uv run python scripts/generate_openapi.py
+
+      - name: Generate API docs
+        run: uv run python scripts/generate_api_docs.py
 
       - name: Build docs
-        if: github.event_name == 'pull_request'
-        run: mkdocs build -s
+        working-directory: docs
+        run: npm run build
+        env:
+          CI: true
+
+      - name: Generate llms.txt
+        run: uv run python scripts/generate_llms_txt.py
 
-      - name: Publish docs
+      - name: Deploy to GitHub Pages
         if: ${{ github.event_name == 'push' || github.event_name == 'workflow_dispatch' }}
-        run: mkdocs gh-deploy
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/dist

.pre-commit-config.yaml

@@ -49,7 +49,7 @@ repos:
     rev: "v2.4.1"
     hooks:
       - id: codespell
-        exclude: CODE_OF_CONDUCT.md|tests/assets
+        exclude: CODE_OF_CONDUCT.md|tests/assets|package-lock\.json
 
   - repo: https://github.com/kynan/nbstripout
     rev: 0.9.1

CONTRIBUTING.md

@@ -141,7 +141,7 @@ Documentation to update:
 - **docs/providers.md** when adding providers
 
 ```bash
-mkdocs serve
+cd docs && npm run dev
 ```
 
 ### 5. Commit Your Changes

README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <picture>
-    <img src="https://raw.githubusercontent.com/mozilla-ai/any-llm/refs/heads/main/docs/images/any-llm-logo-mark.png" width="20%" alt="Project logo"/>
+    <img src="https://raw.githubusercontent.com/mozilla-ai/any-llm/refs/heads/main/docs/public/images/any-llm-logo-mark.png" width="20%" alt="Project logo"/>
   </picture>
 </p>
 

docs/.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+.astro/
+src/content/docs/api/