Skip to content

resonatehq-examples/example-openai-deep-research-agent-py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Deep Research Assistant

A distributed, recursive Deep Research Agent powered by Resonate and OpenAI. This example demonstrates how complex, distributed agentic applications can be implemented with simple code.

Use Case

Given a topic, the Deep Research Agent decomposes the topic into subtopics, and recursively invokes itself (via OpenAI parallel tool calling) on each subtopic.


Installation & Usage

To run this project you need an OpenAI API Key

1. Clone the repository

git clone https://github.com/resonatehq-examples/example-openai-deep-research-agent-py.git
cd example-openai-deep-research-agent-py

2. Set your OpenAI API Key

export OPENAI_API_KEY="sk-..."

3. Run the Agent

This example uses uv

uv run research.py

Trouble Shooting

The Deep Research Agent depends on OpenAI and the OpenAI Python SDK. If you are having trouble, verify that your OpenAI credentials are configured correctly and the model is accessible by running the following command in the project's directory:

uv run python -c 'import os; from openai import OpenAI; client = OpenAI(api_key=os.environ["OPENAI_API_KEY"]); print(client.chat.completions.create(model="gpt-5", messages=[{"role": "user", "content": "knock knock"}]))'

If everything is configured correctly, you will see a response from OpenAI such as:

ChatCompletion(choices=[message=ChatCompletionMessage(content='Who’s there?', ...), ...], ...)

If you are still having trouble, please open an issue on the GitHub repository.

About

A recursive Deep Research Assistant powered by OpenAI and Resonate's Distributed Async Await.

Topics

Resources

Stars

Watchers

Forks

Languages