# Step-by-Step Complete Setup Guide

## Prerequisites

Before starting, ensure you have Python 3.x installed on your system.

## Check Your Python Installation

Open PowerShell or Terminal:

Press Windows + R, type `powershell`, press Enter (on Windows)

Check Python Version:

```bash
python --version
# Should show: Python 3.x.x

# If that doesn't work, try:
python3 --version
# Or on some systems:
py --version
```

## Create Your Project Folder

Organize your files properly from the start.

Open PowerShell, Terminal, or Command Prompt:

Make sure you're not in the Python shell (should see C:\> or PS C:\>).

Navigate to Desktop or Documents:

Let's create a folder on your Desktop for easy access:

```bash
# Go to Desktop (Windows)
cd Document

# Create a new folder for your project
mkdir project_folder

# Go into your new folder
cd project_folder

# Verify you're in the right place
pwd
# Should show: C:\Users\YourName\Desktop\project_folder
# Or use 'ls' to see files (should be empty)
ls
```

**Best Practice:** Keep all related files in one folder for easy management.

## Set Up Virtual Environment (venv)

Isolate project dependencies for clean development.

### Why Virtual Environment?

- Keeps project dependencies separate
- Avoids version conflicts between projects
- Makes sharing and deployment easier

### Create Virtual Environment:

Make sure you're in your [project_folder](file:///Users/home/YandexDisk/TECHNOLYCEUM/ict/Year/2025/ai/ai6/ai6-m3/ai6-m3/jokes_bot/v4.0/database..py#L1-L45), then run:

```bash
# Create virtual environment named 'venv'
python -m venv venv 

# or

python3 -m venv venv

# Check if venv folder was created
ls
# You should see a 'venv' folder in the list
```

### Activate Virtual Environment:

#### On Windows (PowerShell):

```bash
venv\Scripts\Activate.ps1
# If you get an error about execution policy, run this first:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
venv\Scripts\Activate.ps1
```

#### On Windows (Command Prompt):

```cmd
venv\Scripts\activate
```

#### On Mac/Linux:

```bash
source venv/bin/activate
```

**Success Indicator:** You should see `(venv)` at the start of your command line.

## Install Required Libraries

Get the Python packages needed for this project.

First, activate your venv:

Make sure you see `(venv)` before the prompt.

Install required packages:

```bash
# Install the required library
pip install package-name==version.number

# Verify installation
pip show package-name
# Should show the installed version
```

Create Requirements File:

```bash
pip freeze > requirements.txt

# View the requirements file
type requirements.txt
# (Mac/Linux: use 'cat requirements.txt' instead of 'type')
```

**Why this matters:** Anyone can install exact same versions with `pip install -r requirements.txt`

## Using IDLE Editor

To open Python IDLE editor:

### On Windows:

```bash
# Launch IDLE (blank new file)
py -m idlelib.idle

# OR (depending on your Python installation)
python -m idlelib.idle

# Open an existing file
py -m idlelib.idle "C:\path\to\your\file.py"
```

### On Mac:

```bash
# Launch IDLE (blank new file)
python3 -m idlelib.idle

# OR (if installed)
idle3

# Open an existing file
python3 -m idlelib.idle ~/path/to/your/file.py
```

### On Linux:

```bash
# Launch IDLE (blank new file)
python3 -m idlelib.idle

# OR (if installed)
idle3

# Open an existing file
python3 -m idlelib.idle /path/to/your/file.py
```

## Copy Existing Code

Start with our working code and modify it.

### Create main file:

In your [project_folder](file:///Users/home/YandexDisk/TECHNOLYCEUM/ict/Year/2025/ai/ai6/ai6-m3/ai6-m3/jokes_bot/v4.0/database..py#L1-L45), create a new file:

```bash
# Using Python IDLE or any text editor:
notepad app.py
# (Or use VS Code, Sublime Text, or Python's IDLE)
```

### Expected Folder Structure:

```
project_folder/
├── app.py              # Main file
├── requirements.txt    # Python dependencies
└── venv/              # Virtual environment
```

## Final Steps

Once you have completed all the steps above, you'll have a properly configured Python development environment ready for your project. Remember to always activate your virtual environment (`source venv/bin/activate` on Mac/Linux or `venv\Scripts\Activate.ps1` on Windows) before starting work on your project.