Skip to content

Modernize, refine, and standardize the notebook collection#219

Open
sis0k0 wants to merge 16 commits into
mainfrom
update-agents-notebooks
Open

Modernize, refine, and standardize the notebook collection#219
sis0k0 wants to merge 16 commits into
mainfrom
update-agents-notebooks

Conversation

@sis0k0

@sis0k0 sis0k0 commented Jul 22, 2026

Copy link
Copy Markdown
Member

Overview

This PR is a broad maintenance and quality pass over the notebook collection, focused on notebooks/agents/. It normalizes install commands, cleans up cell outputs, adds "Open in Colab" buttons, standardizes environment-variable handling, migrates notebooks to the current Atlas vector index syntax, fixes dead links, and substantively refines several individual agent notebooks. 35 files changed.

Deeply refined notebooks

Substantive content and narrative rewrites, not just mechanical edits:

Standardized environment-variable handling

The five modernized notebooks now load secrets consistently:

  • Add python-dotenv to the install cell and call load_dotenv() so variables defined in a local .env file are read automatically.
  • Introduce a shared get_or_prompt_env(var_name, prompt_text) helper that returns the value from the environment (.env or already-set) when present, and otherwise falls back to a getpass prompt, raising a clear EnvironmentError if left empty.
  • Keys such as OPENAI_API_KEY, FIREWORKS_API_KEY, and MONGODB_URI are resolved through this helper instead of being hardcoded or prompted ad hoc, so the notebooks run non-interactively when a .env file is present and prompt gracefully when it is not.

Other standardized conventions

Applied consistently across the agent notebooks:

  • Install commands: Replaced !pip with %pip, then normalized all installs to %pip install -U -q for quiet, up-to-date installs.
  • Cell outputs: Cleared noisy pip-install outputs.
  • Open in Colab: Added launch buttons to all notebooks across agents/, rag/, evals/, and partners/.
  • Intro sections: Added consistent titles and problem statements to ~15 agent notebooks.

Modernization

Housekeeping

@sis0k0
sis0k0 requested a review from a team as a code owner July 22, 2026 11:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant