- Python: Make sure you have Python 3.10 or higher installed. IDLE comes bundled with Python.
- pip: Ensure you have
pipavailable for installing packages.
-
Clone the repository
git clone <REPO_URL> cd <REPO_DIRECTORY>
-
Create a Python virtual environment (optional, but recommended)
python3 -m venv env source env/bin/activate # On Windows: env\\Scripts\\activate
-
Install required packages
pip install --upgrade pip pip install ipykernel google-genai
-
Start Jupyter Notebook
jupyter-notebook
-
In the browser window that opens, navigate to the cloned repository and open the desired notebook files.
- Before making any changes, create a development branch named after you:
git checkout -b <YourName>-dev
- Commit your changes to this branch.
- Push the branch to the remote repository:
git push origin <YourName>-dev
- Open a pull request against
main(or the default branch) when ready for review.
- Work exclusively on your
<YourName>-devbranch. - Follow existing coding styles and notebook conventions.
- Ensure all notebooks run without errors before committing.
Feel free to customize this README as your project evolves.