Merge branch 'main' of github.com:DefangLabs/samples

Author: raphaeltm

.github/workflows/build-samples-json.yml

@@ -1,18 +1,100 @@
 name: Trigger Docs Samples Rebuild
+permissions:
+  contents: read
+  pull-requests: read
 
 on:
-  push:
-    branches: main
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches:
+      - "**"
     paths:
-      - 'samples/**'
+      - "samples/**"
 
 jobs:
+  # python-lint:
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - name: Checkout code
+  #       uses: actions/checkout@v4
+
+  #     - name: Get list of changed files
+  #       id: changed
+  #       run: |
+  #         files=$(git diff --name-only origin/${{ github.base_ref }}...${{ github.head_ref }} | grep '\.py$' || true)
+  #         echo "files=$files" >> "$GITHUB_OUTPUT"
+
+  #     - name: Run Ruff linter
+  #       uses: astral-sh/ruff-action@v1
+  #       with:
+  #         args: check
+  #         src: ${{ steps.changed.outputs.files }}
+
+  #     - name: Run Ruff formatter check
+  #       uses: astral-sh/ruff-action@v1
+  #       with:
+  #         args: "format --check"
+  #         src: ${{ steps.changed.outputs.files }}
+
+  js-ts-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Get list of changed JS/TS files
+        id: changed_js
+        run: |
+          files=$(git diff --name-only origin/${{ github.base_ref }}...${{ github.head_ref }} | grep -E '\.(js|ts|jsx|tsx)$' || true)
+          echo "files=$files" >> "$GITHUB_OUTPUT"
+
+      - name: Run ESLint (JS/TS only)
+        run: |
+          if [ -n "${{ steps.changed_js.outputs.files }}" ]; then
+            npx eslint ${{ steps.changed_js.outputs.files }}
+          else
+            echo "No JS/TS files to lint."
+          fi
+
+      - name: Run Prettier check (JS/TS only)
+        run: |
+          if [ -n "${{ steps.changed_js.outputs.files }}" ]; then
+            npx prettier --check ${{ steps.changed_js.outputs.files }}
+          else
+            echo "No JS/TS files to format check."
+          fi
+
+  # go-lint:
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - name: Checkout code
+  #       uses: actions/checkout@v4
+
+  #     - name: Set up Golang
+  #       uses: actions/setup-go@v5
+  #       with:
+  #         go-version: stable
+
+  #     - name: Run golangci-lint
+  #       uses: golangci/golangci-lint-action@v8
+  #       with:
+  #         args: --enable gofmt --enable goimports
+  #         only-new-issues: true
+  #         version: latest
+
   build-json:
     runs-on: ubuntu-latest
+    # needs: [python-lint, js-ts-lint, go-lint]
+    needs: [js-ts-lint]
     steps:
-        - name: Trigger CLI Autodoc
-          uses: peter-evans/repository-dispatch@v1
-          with:
-            token: ${{ secrets.DOCS_ACTION_TRIGGER_TOKEN }}
-            repository: DefangLabs/defang-docs
-            event-type: sample-update
+      - name: Trigger CLI Autodoc
+        uses: peter-evans/repository-dispatch@v1
+        with:
+          token: ${{ secrets.DOCS_ACTION_TRIGGER_TOKEN }}
+          repository: DefangLabs/defang-docs
+          event-type: sample-update

.github/workflows/deploy-changed-samples.yml

@@ -3,7 +3,7 @@ name: Deploy Changed Samples
 on:
   pull_request:
     paths:
-      - 'samples/**'
+      - "samples/**"
 
 permissions:
   contents: read
@@ -82,6 +82,8 @@ jobs:
           TEST_MB_DB_PASS: ${{ secrets.TEST_MB_DB_PASS }}
           TEST_MB_DB_PORT: ${{ secrets.TEST_MB_DB_PORT }}
           TEST_MB_DB_USER: ${{ secrets.TEST_MB_DB_USER }}
+          TEST_MISTRAL_API_KEY: ${{ secrets.TEST_MISTRAL_API_KEY }}
+          TEST_MODEL: ${{ secrets.TEST_MODEL }}
           TEST_MONGO_INITDB_ROOT_USERNAME: ${{ secrets.TEST_MONGO_INITDB_ROOT_USERNAME }}
           TEST_MONGO_INITDB_ROOT_PASSWORD: ${{ secrets.TEST_MONGO_INITDB_ROOT_PASSWORD }}
           TEST_NC_DB: ${{ secrets.TEST_NC_DB }}
@@ -100,6 +102,7 @@ jobs:
           TEST_SLACK_CHANNEL_ID: ${{ secrets.TEST_SLACK_CHANNEL_ID }}
           TEST_SLACK_TOKEN: ${{ secrets.TEST_SLACK_TOKEN }}
           TEST_SHARED_SECRETS: ${{ secrets.TEST_SHARED_SECRETS}}
+          TEST_TAVILY_API_KEY: ${{ secrets.TEST_TAVILY_API_KEY }}
           TEST_ALLOWED_HOSTS: ${{ secrets.TEST_ALLOWED_HOSTS }}
         run: |
           SAMPLES=$(sed 's|^samples/||' changed_samples.txt | paste -s -d ',' -)

samples/agentic-autogen/.devcontainer/Dockerfile

@@ -0,0 +1,2 @@
+
+FROM mcr.microsoft.com/devcontainers/python:3.13-bookworm

samples/agentic-autogen/.devcontainer/devcontainer.json

@@ -0,0 +1,11 @@
+{
+  "build": {
+    "dockerfile": "Dockerfile",
+    "context": ".."
+  },
+  "features": {
+    "ghcr.io/defanglabs/devcontainer-feature/defang-cli:1.0.4": {},
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {},
+    "ghcr.io/devcontainers/features/aws-cli:1": {}
+  }
+}

samples/agentic-autogen/.github/workflows/deploy.yaml

@@ -0,0 +1,25 @@
+name: Deploy
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    environment: playground
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+    - name: Checkout Repo
+      uses: actions/checkout@v4
+
+    - name: Deploy
+      uses: DefangLabs/[email protected]
+      with:
+        config-env-vars: MISTRAL_API_KEY
+      env:
+        MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}

samples/agentic-autogen/.gitignore

@@ -0,0 +1,30 @@
+# Environment variables
+.env
+.env.local
+.env.production
+
+# Python
+__pycache__/
+/myenv
+
+# Node.js
+node_modules/
+npm-debug.log*
+.pnpm-debug.log*
+
+# Frontend build
+frontend/dist/
+frontend/build/
+
+# IDE
+.vscode/
+.idea/
+*~
+
+# OS
+.DS_Store
+._*
+Thumbs.db
+
+# Optional npm cache directory
+.npm

samples/agentic-autogen/README.md

@@ -0,0 +1,57 @@
+# Agentic Autogen
+
+[![1-click-deploy](https://raw.githubusercontent.com/DefangLabs/defang-assets/main/Logos/Buttons/SVG/deploy-with-defang.svg)](https://portal.defang.dev/redirect?url=https%3A%2F%2Fgithub.com%2Fnew%3Ftemplate_name%3Dsample-agentic-autogen-template%26template_owner%3DDefangSamples)
+
+This sample shows an agentic Autogen application using Mistral and FastAPI, deployed with Defang. For demonstration purposes, it will require a [Mistral AI](https://mistral.ai/) API key (see [Configuration](#configuration) for more details). However, you are free to modify it to use a different LLM, say the [Defang OpenAI Access Gateway](https://github.com/DefangLabs/openai-access-gateway/) service, as an alternative. Note that the Vite React frontend is served through the FastAPI backend so that they can be treated as one service in production.
+ 
+## Prerequisites
+
+1. Download [Defang CLI](https://github.com/DefangLabs/defang)
+2. (Optional) If you are using [Defang BYOC](https://docs.defang.io/docs/concepts/defang-byoc) authenticate with your cloud provider account
+3. (Optional for local development) [Docker CLI](https://docs.docker.com/engine/install/)
+
+## Development
+
+To run the application locally, you can use the following command:
+
+```bash
+docker compose up --build
+```
+
+## Configuration
+
+For this sample, you will need to provide the following [configuration](https://docs.defang.io/docs/concepts/configuration): 
+
+> Note that if you are using the 1-click deploy option, you can set these values as secrets in your GitHub repository and the action will automatically deploy them for you.
+
+### `MISTRAL_API_KEY`
+An API key to access the [Mistral AI API](https://mistral.ai/).
+```bash
+defang config set MISTRAL_API_KEY
+```
+
+## Deployment
+
+> [!NOTE]
+> Download [Defang CLI](https://github.com/DefangLabs/defang)
+
+### Defang Playground
+
+Deploy your application to the Defang Playground by opening up your terminal and typing:
+```bash
+defang compose up
+```
+
+### BYOC
+
+If you want to deploy to your own cloud account, you can [use Defang BYOC](https://docs.defang.io/docs/tutorials/deploy-to-your-cloud).
+
+---
+
+Title: Agentic Autogen
+
+Short Description: An Autogen agent application using Mistral and FastAPI, deployed with Defang.
+
+Tags: Agent, Autogen, Mistral, FastAPI, Vite, React, Python, JavaScript, AI
+
+Languages: Python, JavaScript

samples/agentic-autogen/compose.yaml

@@ -0,0 +1,16 @@
+
+services:
+  autogen:
+    build:
+      context: ./src
+      dockerfile: Dockerfile
+    ports:
+      - "3000:3000"
+    environment:
+      - MISTRAL_API_KEY=${MISTRAL_API_KEY}
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3

samples/agentic-autogen/src/.dockerignore

@@ -0,0 +1,27 @@
+# Default .dockerignore file for Defang
+**/__pycache__
+**/.direnv
+**/.DS_Store
+**/.envrc
+**/.git
+**/.github
+**/.idea
+**/.next
+**/.vscode
+**/compose.*.yaml
+**/compose.*.yml
+**/compose.yaml
+**/compose.yml
+**/docker-compose.*.yaml
+**/docker-compose.*.yml
+**/docker-compose.yaml
+**/docker-compose.yml
+**/node_modules
+**/Thumbs.db
+# Dockerfile
+# *.Dockerfile
+# Ignore our own binary, but only in the root to avoid ignoring subfolders
+defang
+defang.exe
+# Ignore our project-level state
+.defang

samples/agentic-autogen/src/Dockerfile

@@ -0,0 +1,40 @@
+# ------------ FRONTEND BUILD STAGE ------------ #
+FROM node:22-alpine AS frontend-build
+
+WORKDIR /frontend
+
+# Copy only package files first (cache optimization)
+COPY frontend/package*.json ./
+RUN npm ci
+
+# Copy rest of the frontend source
+COPY frontend/ ./
+RUN npm run build
+
+
+# ------------ BACKEND STAGE ------------ #
+FROM python:3.13-slim AS backend
+
+WORKDIR /app
+
+# Install build dependencies for Python packages
+RUN apt-get update && apt-get install -y \
+    gcc \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install dependencies
+COPY backend/requirements.txt ./
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy backend code
+COPY backend/ ./
+
+# Copy built frontend into backend's static folder
+COPY --from=frontend-build /frontend/dist ./static
+
+# Optionally expose the same port for both backend and frontend
+EXPOSE 3000
+
+# Start the backend server (which serves both API + frontend files)
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "3000"]