---
name: py-intro
description: Slidev presentation for teaching Python with interactive code execution.
---

# Python Zero To Hero Slides

A Slidev presentation for teaching Python fundamentals with interactive code execution.

## Tech Stack

- **Framework**: Slidev (Vue-based)
- **Feature**: Python Runner addon for live code demos
- **Addons**: slidev-addon-python-runner, slidev-addon-rabbit
- **Themes**: apple-basic, bricks, penguin
- **Package Manager**: pnpm
- **Output**: `dist` directory

## Setup

### 1. Clone the Template

```bash
git clone --depth 1 https://github.com/Eng0AI/py-intro-template.git .
```

If the directory is not empty:

```bash
git clone --depth 1 https://github.com/Eng0AI/py-intro-template.git _temp_template
mv _temp_template/* _temp_template/.* . 2>/dev/null || true
rm -rf _temp_template
```

### 2. Remove Git History (Optional)

```bash
rm -rf .git
git init
```

### 3. Install Dependencies

```bash
pnpm install
```

## Build

```bash
pnpm build
```

## Deploy

### Vercel (Recommended)

```bash
vercel pull --yes -t $VERCEL_TOKEN
vercel build --prod -t $VERCEL_TOKEN
vercel deploy --prebuilt --prod --yes -t $VERCEL_TOKEN
```

### Netlify

```bash
netlify deploy --prod --dir=dist
```

## Development

```bash
pnpm dev
```

Starts the Slidev server and opens the presentation in your browser. Edit slides in `slides.md`.

## Special Features

- Interactive Python code execution in slides
- Multiple theme options