Devday Bangalore workshop

This repo contains all the codes that would ber taught during the workshop of devday bangalore

Setup the required project

Step 1: Clone the project into your directory

git clone git@github.com:spcCodes/devday_blr.git

Step 2: Enter the project directory

cd devday_blr

Step 3: Install uv ( if not installed)

For Mac/Linux users

pip install uv 

or 

brew install uv (mac)

Using uv (recommended) The recommended way is to use the package manager uv as it's fast, efficient, and makes the whole process much easier! If using uv, we can create a virtual environment in the project directory and install the required packages with two commands.

Step 4: install the packages using the following command

uv venv
uv sync

Step 5 : Set up the .env file

Rename or copy the .env.sample file to .env file

We will fill in the required environment variables in the next steps.

Step 6 : Set up the OpenAI API key , Tavily Search api key and Weather api key

For OPENAI api keys

Create an OpenAI account at platform.openai.com and open up API key page
https://platform.openai.com/settings/organization/api-keys

Create an api key and paste in .env file

For Tavily api keys

Create an Tavily account and open up API key page
Link:
https://app.tavily.com/home

Create an api key and paste in .env file

For Weather.com api keys

Create an Weather API account and create an api key
Link:
https://www.weatherapi.com/my/

Create an api key and paste in .env file

🧰 Setting up uv on Windows

---

Prerequisites

• Python 3.10 or higher installed
• Command Prompt or PowerShell access

---

Installation

Step 1: Navigate to Your Project Folder

Open Command Prompt (cmd.exe) or PowerShell and navigate to your project directory

Step 2: Install uv

PowerShell (official installer):

powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"

After install, restart your terminal so the updated PATH takes effect.

Alternatively (pip):

pip install uv

---

Configuration

Add uv to PATH (if needed)

If the uv command is not recognized, add it to your PATH using:

• Temporary (current session only):

  set PATH=%LOCALAPPDATA%\Programs\uv;%PATH%

• Persistent (survives restarts):

  setx PATH "%LOCALAPPDATA%\Programs\uv;%PATH%"

After using setx, close and reopen your terminal.

Verify Installation

Test that uv is accessible:

uv --version

🎉 You're all set if you see a version printed.

---

Usage

Sync Project Dependencies

In your project root (where pyproject.toml or requirements.txt exists), run:

uv sync

This will install all required dependencies in a virtual environment.

Create and use a virtual environment

Create a .venv in the project directory:

uv venv

Activate the environment (choose one):

• PowerShell:

  .\.venv\Scripts\Activate.ps1

  If PowerShell blocks the activation script, allow scripts for this session only and try again:

  Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
  .\.venv\Scripts\Activate.ps1

  You can also use RemoteSigned instead of Bypass if preferred.

• Command Prompt (cmd.exe):

  .\.venv\Scripts\activate.bat

• Directly use the interpreter without activating (as requested):

  .\.venv\Scripts\python.exe --version

---

Troubleshooting

Common Error: Python Version Incompatibility

Error message:

error: Distribution `onnxruntime==1.23.1` can't be installed because it doesn't have a wheel for CPython 3.14
hint: You're using CPython 3.14 (`cp314`), but `onnxruntime` (v1.23.1) only has wheels for: cp311, cp312, cp313, cp313t

Cause: Your system Python version is too new, and the package doesn't have compatible binaries yet.

Solution: Pin to a Compatible Python Version

Use uv to install and pin a compatible Python version (e.g., 3.13):

uv python install 3.13
uv python pin 3.13
uv sync

What this does:

1. Downloads and installs Python 3.13 (if not already available)
2. Pins your project to use Python 3.13
3. Creates a virtual environment with the correct Python version
4. Syncs all dependencies successfully

---

Quick Reference (Windows)

Windows PowerShell Quick Install

# From your project directory
# Install uv via official script
powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"

# If uv isn't found, add to PATH temporarily
set PATH=%LOCALAPPDATA%\Programs\uv;%PATH%

# For persistent PATH (restart terminal afterward)
setx PATH "%LOCALAPPDATA%\Programs\uv;%PATH%"

# Check uv version
uv --version

# Create and use a venv
uv venv
# PowerShell activation
.\.venv\Scripts\Activate.ps1
# If activation is blocked in PowerShell (current session only)
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1
# Or run the interpreter directly without activating
.\.venv\Scripts\python.exe --version

# Sync dependencies
uv sync

# In your IDE, select the Python interpreter from .venv

---

IDE Kernel/Interpreter

• VS Code: Run Python: Select Interpreter and pick the one from .venv.
• Jupyter: Choose the kernel whose path points to .venv\Scripts\python.exe.