### Quick start

Source: https://github.com/mindofhenry/pepper/blob/main/README.md

Commands to set up and run the bot.

```bash
python -m venv .venv
.venv\Scripts\activate    # Windows
pip install -r requirements.txt

cp .env.example .env       # then fill it in
python migrate.py          # idempotent; safe to run on every deploy
python bot.py
```

--------------------------------

### One-time setup and running the bot

Source: https://github.com/mindofhenry/pepper/blob/main/CLAUDE.md

Commands for setting up the Python environment, installing dependencies, applying database migrations, and running the bot locally.

```bash
# One-time setup (any machine)
python -m venv .venv
.venv\Scripts\activate    # Windows
pip install -r requirements.txt

# Apply pending DB migrations (idempotent; run on every deploy)
python migrate.py

# Run the bot locally for dev/smoke testing
python bot.py
```

--------------------------------

### Project Dependencies

Source: https://github.com/mindofhenry/pepper/blob/main/requirements.txt

This file lists the Python packages and their versions required for the project.

```text
aiohappyeyeballs==2.6.1
aiohttp==3.13.5
aiosignal==1.4.0
annotated-types==0.7.0
anthropic==0.96.0
anyio==4.13.0
asyncpg==0.31.0
attrs==26.1.0
certifi==2026.2.25
discord.py==2.7.1
distro==1.9.0
docstring_parser==0.18.0
frozenlist==1.8.0
h11==0.16.0
httpcore==1.0.9
httpx==0.28.1
idna==3.11
jiter==0.14.0
multidict==6.7.1
propcache==0.4.1
pydantic==2.13.2
pydantic_core==2.46.2
python-dotenv==1.2.2
sniffio==1.3.1
typing-inspection==0.4.2
typing_extensions==4.15.0
yarl==1.23.0
```

--------------------------------

### Project Layout

Source: https://github.com/mindofhenry/pepper/blob/main/README.md

Directory structure of the Pepper bot project.

```text
bot.py              # Entrypoint. Dynamic cog loader, global error handler.
config.py           # Env loading.
migrate.py          # Migration runner.
cogs/
  admin.py          # /admin reload, /admin health
  book_club/        # /book, /poll, /progress, /section
  media/            # Empty until Phase 12.
services/           # External API wrappers (Google Books, Anthropic).
shared/             # db pool, logging, error helpers.
migrations/         # NNN_*.sql, applied in order by migrate.py.
```

--------------------------------

### Target module layout

Source: https://github.com/mindofhenry/pepper/blob/main/CLAUDE.md

The target module layout for the Pepper project after the MIN-54 refactor.

```text
pepper/
├── bot.py                 # Dynamic cog loader, global error handler
├── config.py              # Env loading
├── cogs/
│   ├── __init__.py
│   ├── book_club/
│   │   ├── __init__.py
│   │   ├── search.py      # /book search, lookup
│   │   ├── polls.py       # /poll
│   │   ├── progress.py    # /progress
│   │   ├── sections.py    # /section new, current, close
│   │   ├── prompts.py     # /section prompts (AI-generated, cached)
│   │   └── meetings.py    # /meeting (Phase 8)
│   ├── media/
│   │   ├── __init__.py
│   │   ├── search.py      # Phase 14
│   │   ├── download.py    # Phase 12
│   │   ├── pipeline.py    # Phase 13
│   │   └── status.py      # Phase 15
│   └── admin.py           # /admin reload <cog>, /admin health
├── services/
│   ├── __init__.py
│   ├── google_books.py
│   ├── anthropic_client.py
│   ├── qbittorrent.py
│   ├── prowlarr.py
│   ├── clamav.py
│   └── jellyfin.py
├── shared/
│   ├── __init__.py
│   ├── db.py
│   ├── logging.py
│   └── errors.py
├── migrations/
│   └── NNN_*.sql
├── requirements.txt
├── .env.example
└── README.md
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.