Add initial project structure with Docker setup, environment configurations, and workshop materials

- Created .dockerignore and .gitignore files to manage ignored files for Docker and Git.
- Added Dockerfile for building a Quarto + Python environment.
- Introduced docker-compose configuration for running the workshop slides service.
- Included environment.yml and requirements.txt for dependency management.
- Added Quarto configuration and theme files for slide presentations.
- Created initial workshop content and data files for the "Colab and Chill" workshop series.
- Added LICENSE files for MIT and CC BY 4.0 licenses.
- Included README and LOCAL.md for project documentation and local setup instructions.

Author: alptezbasaran

.dockerignore

@@ -0,0 +1,13 @@
+.git
+.gitignore
+**/.venv
+**/__pycache__
+**/.ipynb_checkpoints
+node_modules
+.DS_Store
+*.log
+*.tmp
+*.local
+**/.quarto/
+.quarto-cache
+site

.github/workflows/deploy-page.yml

@@ -0,0 +1,76 @@
+name: Deploy slides to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "config/**"
+      - "workshops/**"
+      - "assets/**"
+      - "README.md"
+      - "LOCAL.md"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      QUARTO_CACHE_DIR: ${{ github.workspace }}/.quarto-cache
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Cache Quarto cache and libs
+        uses: actions/cache@v4
+        with:
+          path: |
+            .quarto-cache
+            ~/.cache/quarto
+          key: ${{ runner.os }}-quarto-${{ hashFiles('config/_quarto.yml', 'config/slides/index.qmd', 'workshops/colab-and-chill/index.qmd', 'config/slides/theme/**') }}
+          restore-keys: |
+            ${{ runner.os }}-quarto-
+
+      - name: Setup Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+        with:
+          version: 1.6.40
+
+      - name: Render slides
+        run: |
+          cd config
+          quarto render slides/index.qmd
+          quarto render ../workshops/colab-and-chill/index.qmd --to revealjs
+
+      - name: Assemble Pages site
+        run: |
+          rm -rf site
+          mkdir -p site
+          cp config/slides/index.html site/index.html
+          rsync -av config/slides/index_files/ site/index_files/ 2>/dev/null || true
+          rsync -av assets/ site/assets/
+          rsync -av workshops/colab-and-chill/ site/colab-and-chill/ --exclude "*.ipynb" --exclude "*.qmd"
+
+      - name: Upload Pages artifact (site root)
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,50 @@
+# ---- OS / Editor ----
+.DS_Store
+.idea/
+.vscode/
+
+# macOS system files
+.DS_Store
+
+# Windows system files
+Thumbs.db
+Desktop.ini
+
+# ---- Jupyter / IPython ----
+.ipynb_checkpoints/
+jupyter_notebook_config.py
+
+# ---- Virtual Environments ----
+.env
+.env.*
+env/
+ENV/
+venv/
+.venv/
+.conda/
+.mamba/
+conda-bld/
+conda-meta/
+
+# ---- Static type / linters ----
+.mypy_cache/
+.ruff_cache/
+
+# ---- Logs ----
+*.log
+
+# ---- Colab ----
+sample_data/
+
+/.quarto/
+.quarto-cache/
+
+# ---- Quarto render artifacts (do not commit built slides) ----
+_site/
+site/
+slides/*.html
+slides/*_files/
+config/slides/*.html
+config/slides/*_files/
+workshops/*/*.html
+workshops/*/*_files/

Dockerfile

@@ -0,0 +1,21 @@
+# Quarto + Python base
+FROM ghcr.io/quarto-dev/quarto:1.5.57
+
+# Add Python + Jupyter support
+RUN apt-get update -y && apt-get install -y --no-install-recommends \
+    python3 python3-pip python3-venv \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /project
+
+COPY requirements.txt requirements.txt
+RUN python3 -m venv .venv \
+    && . .venv/bin/activate \
+    && pip install --upgrade pip \
+    && pip install -r requirements.txt || true
+
+COPY . .
+
+EXPOSE 4000
+
+CMD ["bash", "-lc", "cd config && quarto preview slides/index.qmd --host 0.0.0.0 --port 4000 --no-browser"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NCSU Libraries
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSE-CC-BY-4.0.md

@@ -0,0 +1,30 @@
+# Creative Commons Attribution 4.0 International (CC BY 4.0)
+
+This slide deck content (text, images, and slides) is licensed under the
+Creative Commons Attribution 4.0 International License.
+
+You are free to:
+
+- Share - copy and redistribute the material in any medium or format
+- Adapt - remix, transform, and build upon the material for any purpose, even commercially
+
+Under the following terms:
+
+- Attribution - You must give appropriate credit, provide a link to the license,
+  and indicate if changes were made. You may do so in any reasonable manner,
+  but not in any way that suggests the licensor endorses you or your use.
+
+No additional restrictions - You may not apply legal terms or technological measures
+that legally restrict others from doing anything the license permits.
+
+Full license text:
+
+- Human-readable summary: https://creativecommons.org/licenses/by/4.0/
+- Legal code (full text): https://creativecommons.org/licenses/by/4.0/legalcode
+
+Notes:
+
+- This license applies to the slide content. Code (e.g., build scripts, workflows)
+  may be licensed separately (e.g., MIT) in `LICENSE`.
+- Logos, trademarks, and third-party images are excluded from this license and
+  remain the property of their respective owners.

LOCAL.md

@@ -0,0 +1,49 @@
+<div align="center">
+
+<h2>Run Locally (AI Workshops)</h2>
+
+</div>
+
+## Micromamba environment (recommended)
+
+1. Create and activate the environment:
+```bash
+micromamba create -y -f config/environment.yml
+micromamba activate ai-workshops
+```
+
+2. Launch Jupyter and run the notebooks:
+```bash
+jupyter notebook
+# or
+jupyter lab
+```
+
+3. Execute a notebook headlessly (optional):
+```bash
+python -m nbconvert --to notebook --execute workshops/colab-and-chill/colab-and-chill.ipynb --output executed_colab_and_chill.ipynb
+```
+
+## Python .venv alternative
+
+1. Create and activate a virtual environment in this folder:
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+2. Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+3. Run notebooks:
+```bash
+jupyter notebook
+```
+
+## Notes
+
+- Python 3.10-3.12 is supported.
+- If you add packages, update both `config/environment.yml` and `requirements.txt`.
+- The first workshop is intentionally lightweight so it can run cleanly in Colab or locally.

README.md

@@ -0,0 +1,72 @@
+<div align="center">
+
+<a href="https://www.lib.ncsu.edu/" aria-label="nc state university libraries logo"><img src="assets/lib_logo_whiteBG.svg" width="400" alt="NC State University Libraries Logo" /></a>
+
+<h2>NC State University Libraries AI Workshops</h2>
+
+<a href="https://www.lib.ncsu.edu/workshops"><img alt="NC State Libraries Workshops" src="https://img.shields.io/badge/NC%20State%20Libraries-Workshops-red"></a>
+<a href="https://www.lib.ncsu.edu/staff/department/data-science-services"><img alt="Data Science Services" src="https://img.shields.io/badge/Data%20Science%20Services-Libraries-red"></a>
+<a href="https://go.ncsu.edu/getdatahelp"><img alt="GetDataHelp" src="https://img.shields.io/badge/Get%20Data%20Help-go.ncsu.edu%2Fgetdatahelp-red"></a>
+<a href="mailto:getdatahelp@ncsu.edu"><img alt="Email: getdatahelp@ncsu.edu" src="https://img.shields.io/badge/Email-getdatahelp%40ncsu.edu-red"></a>
+<a href="https://github.com/NCSU-Libraries/ai-workshops/actions/workflows/deploy-page.yml"><img alt="Deploy slides to GitHub Pages" src="https://github.com/NCSU-Libraries/ai-workshops/actions/workflows/deploy-page.yml/badge.svg"></a>
+<br/>
+
+</div>
+
+## AI Workshop Series
+
+### Colab and Chill <a href="https://colab.research.google.com/github/NCSU-Libraries/ai-workshops/blob/main/workshops/colab-and-chill/colab-and-chill.ipynb"><img alt="Open in Colab - Colab and Chill" src="https://colab.research.google.com/assets/colab-badge.svg"></a></p>
+
+These materials are used in NC State University Libraries' Data Science Services workshops covering practical AI workflows in Google Colab.
+
+[Register for the workshop](https://www.lib.ncsu.edu/workshops/colab-and-chill-vibe-coding-approach-exploratory-data-analysis-using-ai/2026-03-12)
+
+---
+
+## Quick start
+
+1. Click the workshop badge above to open in Colab.
+2. If you want to save your work, use "Copy to Drive".
+3. Run cells top-to-bottom.
+4. Use the solutions notebook after attempting the learner notebook.
+
+## Included notebooks
+
+- Colab and Chill - Emergency Room Wait Time Data Analysis content in the `workshops/colab-and-chill/` path.
+
+## Learning objectives
+
+- Navigate the AI landscape by distinguishing between "Knower" tools and "Doer" tools for different stages of analysis.
+- Apply the PARTS framework: Persona, Aim, Recipients, Theme, Structure.
+- Use Google Colab AI workflows to support exploratory analysis through inspectable code and iterative prompting.
+- Reduce hallucination risk by asking AI to generate code you can review and rerun.
+
+## Solutions
+
+- Colab and Chill - Solutions
+  <a href="https://colab.research.google.com/github/NCSU-Libraries/ai-workshops/blob/main/workshops/colab-and-chill/colab-and-chill-solutions.ipynb"><img alt="Open in Colab - Solutions: Colab and Chill" src="https://colab.research.google.com/assets/colab-badge.svg"></a>
+
+## Use on Google Colab
+
+This repository is designed to run directly in Google Colab. No software installation is needed for the workshop itself.
+
+### Open in Colab
+
+1. Click a badge above to open directly in Colab.
+2. Prefer to run locally? See the [LOCAL.md](LOCAL.md) guide.
+
+Alternatively, in Colab: File -> Open Notebook -> GitHub tab -> paste the repo URL `https://github.com/NCSU-Libraries/ai-workshops`.
+
+### Run the notebooks
+
+After the notebook opens:
+
+1. Review the workshop goals and setup notes.
+2. Run the cells in order.
+3. Duplicate the notebook to your Drive if you want to keep changes.
+
+### Troubleshooting
+
+- If a notebook opens read-only, use "Copy to Drive" before editing.
+- If a browser extension blocks some Colab UI, try a private or incognito window.
+- If a workshop analysis cell fails because a dataset file is missing, place the required files under `workshops/colab-and-chill/data/`.

assets/.gitkeep

@@ -0,0 +1 @@
+