Deep Research Using OpenAI Agent SDK

• plan web searches
• execute searches
• write a detailed markdown report
• send the report by email

Project Structure

• app.py - Gradio UI entrypoint
• src/research_manager.py - workflow orchestration
• src/agents/ - planner, search, writer, and email agents
• src/config.py - environment-backed settings loader
• src/prompts.py - centralized prompt/instruction constants

Required Environment Variables

Setup and Run (Using uv)

1. Install uv (if needed):
   • Install uv
2. Create and sync the environment from pyproject.toml:

1. Run the app:

Setup and Run (Using pip)

1. Create and activate a virtual environment:

1. Install dependencies:

1. Run the app:

Notes

• If email sending fails, verify SENDGRID_API_KEY, SENDER_EMAIL, and recipient settings.
• Keep secrets in .env only; do not commit credentials to git.