Merge pull request #15 from acceleratescience/12-add-devcontainer

Add devcontainer

Author: rkdan

.devcontainer/README.md

@@ -0,0 +1,30 @@
+# Dev Container Configuration
+
+This directory contains the development container configuration for the Hands-on LLMs workshop.
+
+## What gets installed
+
+When a user opens this repository in GitHub Codespaces, the following will be automatically set up:
+
+### Base Environment
+- Python 3.11 (Debian Bullseye)
+- Git and GitHub CLI
+
+### VS Code Extensions
+- Python development: Python, Pylance, Black formatter, Ruff linter
+- Jupyter notebooks: Full Jupyter support with renderers and keybindings
+- General development: JSON, YAML, and Markdown support
+
+### Port Forwarding
+- **Port 8501**: Streamlit applications
+- **Port 8888**: Jupyter notebook server
+
+## Usage
+
+Users simply need to:
+1. Fork this repository
+2. Open in GitHub Codespaces
+3. Wait for the automatic setup to complete
+4. Start working with the workshop materials
+
+The environment will be ready to use with all dependencies installed and VS Code properly configured for Python and Jupyter development. 

.devcontainer/devcontainer.json

@@ -0,0 +1,53 @@
+{
+	"name": "Packaging and Publishing Workshop",
+	"image": "mcr.microsoft.com/devcontainers/python:1-3.11-bullseye",
+
+	"features": {
+		"ghcr.io/devcontainers/features/git:1": {},
+		"ghcr.io/devcontainers/features/github-cli:1": {}
+	},
+
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"ms-python.python",
+				"ms-python.vscode-pylance",
+				"ms-toolsai.jupyter",
+				"ms-toolsai.jupyter-keymap",
+				"ms-toolsai.jupyter-renderers",
+				"ms-python.black-formatter",
+				"charliermarsh.ruff",
+				"ms-vscode.vscode-json",
+				"redhat.vscode-yaml",
+				"ms-vscode.vscode-markdown"
+			],
+			"settings": {
+				"python.defaultInterpreterPath": "/usr/local/bin/python",
+				"python.linting.enabled": true,
+				"python.linting.pylintEnabled": false,
+				"python.linting.flake8Enabled": false,
+				"python.formatting.provider": "black",
+				"jupyter.askForKernelRestart": false,
+				"files.associations": {
+					"*.ipynb": "jupyter-notebook"
+				}
+			}
+		}
+	},
+
+	"remoteUser": "vscode",
+
+	"forwardPorts": [8501, 8888],
+
+	"portsAttributes": {
+        "8501": {
+          "label": "Streamlit",
+          "onAutoForward": "notify"
+
+        },
+		"8888": {
+			"label": "Jupyter",
+			"onAutoForward": "notify"
+		}
+	}
+}

.gitignore

@@ -146,4 +146,8 @@ Testing/
 #poetry.lock
 
 # Pylance
-.ipynb_checkpoints/
+.ipynb_checkpoints/
+
+# PyCharm project files
+# These files are machine specific and not useful to developers on VS Code or other editors
+.idea/