Skip to content

About

Autonomous Financial Research Agent built using Python, ReAct architecture, financial data APIs, memory management, and automated investment report generation.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Autonomous Financial Research Agent using Agentic AI

Python Status Project License OOP Agentic AI


πŸ“– Overview

The Autonomous Financial Research Agent is an Agentic AI system developed as part of the ZeTheta Remote Live Project Work Experience Program.

The system autonomously performs financial research by collecting data from multiple financial sources, analyzing company fundamentals, evaluating financial risk, storing research memory, and generating structured investment research reports.

The architecture follows the Plan β†’ Reason β†’ Act β†’ Analyze β†’ Report workflow inspired by modern autonomous AI agents.


πŸ“‘ Table of Contents

  • Overview
  • Features
  • System Architecture
  • Agent Workflow
  • Project Structure
  • Technologies Used
  • Installation
  • Usage
  • Sample Output
  • Modules
  • Financial Data Sources
  • Future Improvements
  • Screenshots
  • Author
  • GitHub Statistics
  • License

✨ Features

βœ… Company Profile Lookup

βœ… SEC EDGAR Filing Retrieval

βœ… Live Stock Price Analysis

βœ… Financial Statements Analysis

βœ… Financial Ratio Calculation

βœ… Company Risk Assessment

βœ… Earnings Transcript Summary

βœ… Financial News Collection

βœ… Web Search Integration

βœ… ReAct Reasoning Engine

βœ… Planner Module

βœ… Tool Registry

βœ… Memory Management

βœ… Investment Research Report Generation


πŸ—οΈ System Architecture

                    User Query
                         β”‚
                         β–Ό
                β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                β”‚     Planner     β”‚
                β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚
                         β–Ό
                β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                β”‚  ReAct Engine   β”‚
                β”‚ Thought β†’ Actionβ”‚
                β”‚ Observation     β”‚
                β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚
                         β–Ό
                β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                β”‚  Tool Registry  β”‚
                β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚
     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
     β–Ό                   β–Ό                    β–Ό
Company Profile     Financial APIs      SEC EDGAR
     β”‚                   β”‚                    β”‚
     β–Ό                   β–Ό                    β–Ό
Stock Price      Financial Statements     Filings
     β”‚                   β”‚
     β–Ό                   β–Ό
Financial Ratios     Risk Analysis
     β”‚                   β”‚
     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”˜
                    β–Ό
           Earnings Transcript
                    β”‚
                    β–Ό
              News & Web Search
                    β”‚
                    β–Ό
             Memory Management
                    β”‚
                    β–Ό
           Investment Report

πŸ€– Agent Workflow

User Query
      β”‚
      β–Ό
Planner
      β”‚
      β–Ό
ReAct Reasoning
      β”‚
      β–Ό
Tool Selection
      β”‚
      β–Ό
Financial Data Collection
      β”‚
      β–Ό
Financial Analysis
      β”‚
      β–Ό
Memory Storage
      β”‚
      β–Ό
Investment Report

πŸ“‚ Project Structure

app/
β”‚
β”œβ”€β”€ agent/
β”‚   β”œβ”€β”€ controller.py
β”‚   └── react_engine.py
β”‚
β”œβ”€β”€ planner/
β”‚   └── planner.py
β”‚
β”œβ”€β”€ memory/
β”‚   └── memory_manager.py
β”‚
β”œβ”€β”€ report/
β”‚   └── report_generator.py
β”‚
β”œβ”€β”€ tools/
β”‚   β”œβ”€β”€ company_lookup_tool.py
β”‚   β”œβ”€β”€ company_profile_tool.py
β”‚   β”œβ”€β”€ financial_statements_tool.py
β”‚   β”œβ”€β”€ stock_price_tool.py
β”‚   β”œβ”€β”€ ratio_calculator_tool.py
β”‚   β”œβ”€β”€ risk_analyzer_tool.py
β”‚   β”œβ”€β”€ earnings_tool.py
β”‚   β”œβ”€β”€ news_tool.py
β”‚   β”œβ”€β”€ web_search_tool.py
β”‚   β”œβ”€β”€ sec_edgar_tool.py
β”‚   └── tool_registry.py
β”‚
β”œβ”€β”€ outputs/
β”œβ”€β”€ reports/
└── main.py

πŸ› οΈ Technologies Used

Technology Purpose
Python Core Programming
OOP Modular Architecture
yfinance Stock Market Data
SEC EDGAR API SEC Filings
Requests API Calls
JSON Data Handling
dotenv Environment Variables

βš™οΈ Installation

Clone Repository

git clone https://github.com/prudhvirajbanikela/Autonomous-Financial-Research-Agent.git

Move into project

cd Autonomous-Financial-Research-Agent

Create Virtual Environment

python -m venv venv

Activate Environment

Windows

venv\Scripts\activate

Linux / Mac

source venv/bin/activate

Install Dependencies

pip install -r requirements.txt

▢️ Run Project

python app/main.py

πŸ’‘ Example Query

Analyze Apple

or

Investment analysis of NVIDIA

πŸ“Š Sample Output

The agent automatically performs:

  • Company Profile
  • Live Stock Price
  • Financial Statements
  • Financial Ratios
  • Risk Analysis
  • SEC Filings
  • Earnings Transcript
  • Latest News
  • Web Search
  • Investment Report

🧠 Modules

πŸ“Œ Planner

Creates the execution strategy.


πŸ€– ReAct Engine

Implements

Thought
↓
Action
↓
Observation

reasoning methodology.


πŸ›  Tool Registry

Manages all available financial tools dynamically.


🧠 Memory Manager

Supports

  • Short-Term Memory
  • Long-Term Memory
  • Episodic Memory

πŸ“„ Report Generator

Produces structured investment research reports.


🌍 Financial Data Sources

  • SEC EDGAR
  • Yahoo Finance
  • Public Financial APIs

πŸ“ˆ Future Improvements

  • LangGraph Integration
  • LangChain Agent
  • Groq LLM
  • ChromaDB Memory
  • Pinecone Vector Database
  • NewsAPI Integration
  • PDF Report Generation
  • Streamlit Dashboard
  • Interactive Charts
  • Portfolio Recommendation Engine

πŸ‘¨β€πŸ’» Author

Prudhvi Raj Banikela

Artificial Intelligence & Data Science Undergraduate

Developed as part of the ZeTheta Remote Live Project Work Experience Program


🌐 Connect with Me


πŸ“ˆ GitHub Statistics


⭐ If you found this project useful

Please consider giving the repository a ⭐ on GitHub.


πŸ“„ License

This project was developed for educational, research, and portfolio purposes as part of the ZeTheta Remote Live Project Work Experience Program.

About

Autonomous Financial Research Agent built using Python, ReAct architecture, financial data APIs, memory management, and automated investment report generation.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages