How phuc-nt/deep-research-agent-python works
Project Type and Purpose
• The project is a full-stack research automation agent that takes research requirements as input and produces detailed research outputs including outlines, analyses, and edited documents.
• Its purpose is to streamline a complete research process by leveraging API endpoints, LLM services (such as OpenAI and Claude), external search services, and storage integrations (both local file system and GitHub).
File Structure
• The top-level “app” directory is divided into clear submodules:
• API layer (app/api): Contains the FastAPI application, routes, and entry point.
• Core utilities (app/core): Manages configuration, exceptions, and the service factory pattern.
• Models (app/models): Pydantic models for handling data structures related to research and (originally) cost monitoring.
• Services (app/services): Implements business logic. Under services, you have:
• Core Services: LLM integrations (app/services/core/llm), Search (app/services/core/search), and Storage (app/services/core/storage). (Omit any logging or cost components.)
• Research Services: Implements phases of research such as preparation, detailed processing, and editing.
• Utilities (app/utils): Helpful functions used across the system.
• Additional configuration files, tests, Docker setups, and documentation confirm a robust full-stack architecture built around research processing.