Files added Deep Researcher using LinkUp

Multi-Agent Deep Researcher/.gitignore

@@ -0,0 +1,11 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.env

Multi-Agent Deep Researcher/.python-version

@@ -0,0 +1 @@
+3.11

Multi-Agent Deep Researcher/README.md

@@ -0,0 +1,38 @@
+# Agentic Deep Researcher
+
+Agentic Deep Researcher is a cutting-edge project designed to explore and implement advanced research methodologies using artificial intelligence. This project aims to assist researchers in automating complex tasks, generating insights, and enhancing productivity.
+
+We use:
+
+- LinkUp (Search Tool)
+- CrewAI (Agentic design)
+- Deepseek V3 (LLM)
+- Streamlit to wrap the logic in an interactive UI
+
+### SetUp
+
+Run these commands in project root
+
+```
+uv venv  # creates a virtual environment (if not yet)
+source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows
+uv pip install -e .  # installs the project in editable mode
+```
+
+### Run the Application
+
+Run the application with:
+
+```bash
+streamlit run app.py
+```
+
+## 📬 Stay Updated with Our Newsletter!
+
+**Get a FREE Data Science eBook** 📖 with 150+ essential lessons in Data Science when you subscribe to our newsletter! Stay in the loop with the latest tutorials, insights, and exclusive resources. [Subscribe now!](https://join.dailydoseofds.com)
+
+[![Daily Dose of Data Science Newsletter](https://github.com/patchy631/ai-engineering/blob/main/resources/join_ddods.png)](https://join.dailydoseofds.com)
+
+## Contribution
+
+Contributions are welcome! Feel free to fork this repository and submit pull requests with your improvements.

Multi-Agent Deep Researcher/agents.py

@@ -0,0 +1,137 @@
+import os
+from typing import Type
+from dotenv import load_dotenv
+from pydantic import BaseModel, Field
+from linkup import LinkupClient
+from crewai import Agent, Task, Crew, Process, LLM
+from crewai.tools import BaseTool
+
+# Load environment variables (for non-LinkUp settings)
+load_dotenv()
+
+
+def get_llm_client():
+    """Initialize and return the LLM client"""
+    return LLM(
+        model="openrouter/deepseek/deepseek-chat:free",
+        base_url="https://openrouter.ai/api/v1",
+        api_key=os.getenv("OPENROUTER_API_KEY")
+    )
+
+# Define LinkUp Search Tool
+
+
+class LinkUpSearchInput(BaseModel):
+    """Input schema for LinkUp Search Tool."""
+    query: str = Field(description="The search query to perform")
+    depth: str = Field(default="standard",
+                       description="Depth of search: 'standard' or 'deep'")
+    output_type: str = Field(
+        default="searchResults", description="Output type: 'searchResults', 'sourcedAnswer', or 'structured'")
+
+
+class LinkUpSearchTool(BaseTool):
+    name: str = "LinkUp Search"
+    description: str = "Search the web for information using LinkUp and return comprehensive results"
+    args_schema: Type[BaseModel] = LinkUpSearchInput
+
+    def __init__(self):
+        super().__init__()
+
+    def _run(self, query: str, depth: str = "standard", output_type: str = "searchResults") -> str:
+        """Execute LinkUp search and return results."""
+        try:
+            # Initialize LinkUp client with API key from environment variables
+            linkup_client = LinkupClient(api_key=os.getenv("LINKUP_API_KEY"))
+
+            # Perform search
+            search_response = linkup_client.search(
+                query=query,
+                depth=depth,
+                output_type=output_type
+            )
+
+            return str(search_response)
+        except Exception as e:
+            return f"Error occurred while searching: {str(e)}"
+
+
+def create_research_crew(query: str):
+    """Create and configure the research crew with all agents and tasks"""
+    # Initialize tools
+    linkup_search_tool = LinkUpSearchTool()
+
+    # Get LLM client
+    client = get_llm_client()
+
+    web_searcher = Agent(
+        role="Web Searcher",
+        goal="Find the most relevant information on the web, along with source links (urls).",
+        backstory="An expert at formulating search queries and retrieving relevant information. Passes the results to the 'Research Analyst' only.",
+        verbose=True,
+        allow_delegation=True,
+        tools=[linkup_search_tool],
+        llm=client,
+    )
+
+    # Define the research analyst
+    research_analyst = Agent(
+        role="Research Analyst",
+        goal="Analyze and synthesize raw information into structured insights, along with source links (urls).",
+        backstory="An expert at analyzing information, identifying patterns, and extracting key insights. If required, can delagate the task of fact checking/verification to 'Web Searcher' only. Passes the final results to the 'Technical Writer' only.",
+        verbose=True,
+        allow_delegation=True,
+        llm=client,
+    )
+
+    # Define the technical writer
+    technical_writer = Agent(
+        role="Technical Writer",
+        goal="Create well-structured, clear, and comprehensive responses, along with source links (urls).",
+        backstory="An expert at communicating complex information in an accessible way.",
+        verbose=True,
+        allow_delegation=False,
+        llm=client,
+    )
+
+    # Define tasks
+    search_task = Task(
+        description=f"Search for comprehensive information about: {query}.",
+        agent=web_searcher,
+        expected_output="Detailed raw search results including sources (urls).",
+        tools=[linkup_search_tool]
+    )
+
+    analysis_task = Task(
+        description="Analyze the raw search results, identify key information, verify facts and prepare a structured analysis.",
+        agent=research_analyst,
+        expected_output="A structured analysis of the information with verified facts and key insights, along with source links",
+        context=[search_task]
+    )
+
+    writing_task = Task(
+        description="Create a comprehensive, well-organized response based on the research analysis.",
+        agent=technical_writer,
+        expected_output="A clear, comprehensive response that directly answers the query with proper citations/source links (urls).",
+        context=[analysis_task]
+    )
+
+    # Create the crew
+    crew = Crew(
+        agents=[web_searcher, research_analyst, technical_writer],
+        tasks=[search_task, analysis_task, writing_task],
+        verbose=True,
+        process=Process.sequential
+    )
+
+    return crew
+
+
+def run_research(query: str):
+    """Run the research process and return results"""
+    try:
+        crew = create_research_crew(query)
+        result = crew.kickoff()
+        return result.raw
+    except Exception as e:
+        return f"Error: {str(e)}"

Multi-Agent Deep Researcher/app.py

@@ -0,0 +1,83 @@
+import streamlit as st
+from agents import run_research
+import os
+
+# Set up page configuration
+st.set_page_config(page_title="🔍 Agentic Deep Researcher", layout="wide")
+
+# Initialize session state variables
+if "linkup_api_key" not in st.session_state:
+    st.session_state.linkup_api_key = ""
+if "messages" not in st.session_state:
+    st.session_state.messages = []
+
+def reset_chat():
+    st.session_state.messages = []
+
+# Sidebar: Linkup Configuration with updated logo link
+with st.sidebar:
+    col1, col2 = st.columns([1, 3])
+    with col1:
+        st.write("")
+        st.image(
+            "https://avatars.githubusercontent.com/u/175112039?s=200&v=4", width=65)
+    with col2:
+        st.header("Linkup Configuration")
+        st.write("Deep Web Search")
+
+    st.markdown("[Get your API key](https://app.linkup.so/sign-up)",
+                unsafe_allow_html=True)
+
+    linkup_api_key = st.text_input(
+        "Enter your Linkup API Key", type="password")
+    if linkup_api_key:
+        st.session_state.linkup_api_key = linkup_api_key
+        # Update the environment variable
+        os.environ["LINKUP_API_KEY"] = linkup_api_key
+        st.success("API Key stored successfully!")
+
+# Main Chat Interface Header with powered by logos from original code links
+col1, col2 = st.columns([6, 1])
+with col1:
+    st.markdown("<h2 style='color: #0066cc;'>🔍 Agentic Deep Researcher</h2>",
+                unsafe_allow_html=True)
+    powered_by_html = """
+    <div style='display: flex; align-items: center; gap: 10px; margin-top: 5px;'>
+        <span style='font-size: 20px; color: #666;'>Powered by</span>
+        <img src="https://cdn.prod.website-files.com/66cf2bfc3ed15b02da0ca770/66d07240057721394308addd_Logo%20(1).svg" width="80"> 
+        <span style='font-size: 20px; color: #666;'>and</span>
+        <img src="https://framerusercontent.com/images/wLLGrlJoyqYr9WvgZwzlw91A8U.png?scale-down-to=512" width="100">
+    </div>
+    """
+    st.markdown(powered_by_html, unsafe_allow_html=True)
+with col2:
+    st.button("Clear ↺", on_click=reset_chat)
+
+# Add spacing between header and chat history
+st.markdown("<div style='height: 30px;'></div>", unsafe_allow_html=True)
+
+# Display chat history
+for message in st.session_state.messages:
+    with st.chat_message(message["role"]):
+        st.markdown(message["content"])
+
+# Accept user input and process the research query
+if prompt := st.chat_input("Ask a question about your documents..."):
+    st.session_state.messages.append({"role": "user", "content": prompt})
+    with st.chat_message("user"):
+        st.markdown(prompt)
+
+    if not st.session_state.linkup_api_key:
+        response = "Please enter your Linkup API Key in the sidebar."
+    else:
+        with st.spinner("Researching... This may take a moment..."):
+            try:
+                result = run_research(prompt)
+                response = result
+            except Exception as e:
+                response = f"An error occurred: {str(e)}"
+
+    with st.chat_message("assistant"):
+        st.markdown(response)
+    st.session_state.messages.append(
+        {"role": "assistant", "content": response})

Multi-Agent Deep Researcher/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "agentic-deep-researcher"
+version = "0.1.0"
+description = "Deep Research Agent using Crew AI and LinkUp API"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "crewai>=0.114.0",
+    "linkup-sdk>=0.2.4",
+    "openai>=1.75.0",
+    "python-dotenv>=1.1.0",
+    "streamlit>=1.44.1",
+    "streamlit-crewai-process-output>=0.1.1",
+]