https://github.com/amod-ml/dr-agent-aidsl
A simpe deep-research tool for an agentic ai implementaion
https://github.com/amod-ml/dr-agent-aidsl
agno ai aidsl deepresearch openai
Last synced: about 2 months ago
JSON representation
A simpe deep-research tool for an agentic ai implementaion
- Host: GitHub
- URL: https://github.com/amod-ml/dr-agent-aidsl
- Owner: amod-ml
- License: mit
- Created: 2025-11-01T14:29:20.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-12-21T12:55:08.000Z (6 months ago)
- Last Synced: 2025-12-23T02:06:50.353Z (6 months ago)
- Topics: agno, ai, aidsl, deepresearch, openai
- Language: Python
- Homepage:
- Size: 91.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Deep Research Agent
## Overview
The **Deep Research Agent** is an autonomous web research pipeline built with **Agno** and **ExaSearch**. It takes a user query, plans a research strategy, executes parallel web searches, and synthesizes a comprehensive Markdown report.
The system is exposed via a FastAPI endpoint for easy integration.
## 🚀 Setup & Installation
This project uses **[uv](https://github.com/astral-sh/uv)** for fast package management.
### Prerequisites
- Python 3.13+
- `uv` installed
- OpenAI API Key
- Exa API Key
### Installation
1. **Clone the repository:**
```bash
git clone
cd dr-agent-aidsl
```
2. **Set up environment variables:**
Copy `env-example.txt` to `.env` and fill in your keys.
```bash
cp env-example.txt .env
```
Ensure you have:
- `OPENAI_API_KEY`
- `EXA_API_KEY`
3. **Install dependencies:**
```bash
uv sync
```
## 🏃♂️ Running the Server
Start the FastAPI development server:
```bash
uv run fastapi dev api/main.py
```
The server will start at `http://127.0.0.1:8000`.
## 🔌 API Usage
### Deep Research Endpoint
**URL**: `/deep-research`
**Method**: `POST`
**Content-Type**: `multipart/form-data`
#### Parameters
| Name | Type | Required | Description |
|------------------|----------|----------|-------------|
| `original_query` | `string` | Yes | The main question or topic you want to research. |
| `source_mode` | `string` | No | Source filter. Defaults to `"web"`. |
#### Example Request (cURL)
```bash
curl -X POST "http://127.0.0.1:8000/deep-research" \
-F "original_query=What is the current state of Quantum Computing in 2025?" \
-F "source_mode=web"
```
#### Example Response
```json
{
"report": "# Quantum Computing State of the Art 2025\n\n## Summary\nQuantum computing in 2025 has reached..."
}
```
## 🧪 Testing
### Run Tests
To run all unit and integration tests:
```bash
uv run pytest
```
### Verify API (End-to-End)
To run a real query against the running local server:
```bash
uv run python scripts/verify_api_query.py
```
---
*Built with [Agno](https://github.com/agno-agi/agno) and [Exa](https://exa.ai).*