Free Open-source Stock Research Agent – DeepAgents

DeepAgent Stock Research Assistant is a free, open-source, AI-powered investment analysis tool built on LangChain’s DeepAgent framework.

It uses specialized AI sub-agents to analyze stocks from multiple perspectives and delivers detailed reports that combine fundamental analysis, technical indicators, and risk assessment.

The system works through a master orchestrator that coordinates specialized sub-agents, each focused on fundamental analysis, technical analysis, or risk assessment, while pulling real-time data from Yahoo Finance and other market sources.

It doesn’t just provide data points but synthesizes them into coherent investment recommendations with price targets and specific risk assessments.

Features

• Multi-Perspective Analysis: Combines fundamental, technical, and risk analysis through specialized sub-agents that examine different aspects of stock performance and market conditions.
• Real-Time Financial Data Integration: Accesses live stock prices, financial statements, and technical indicators through Yahoo Finance APIs and other market data sources.
• Systematic Research Workflow: Follows a structured methodology that mirrors professional analyst practices.
• Professional Investment Reports: Generates detailed analysis reports with specific buy/sell/hold recommendations, price targets, and supporting rationale.
• Web-Based Interface: Features a user-friendly Gradio interface that requires no technical setup beyond installation.
• Specialized Sub-Agent Architecture: Employs dedicated agents for fundamental analysis, technical analysis, and risk assessment.
• Customizable Analysis Scope: Accommodates different investment horizons and research depths based on user requirements and market conditions.

See It In Action

Use Cases

• Individual Stock Analysis: Generate comprehensive research reports on specific companies, including financial health assessment, technical chart analysis, and investment recommendations with price targets.
• Portfolio Comparison: Evaluate multiple stocks simultaneously to determine optimal portfolio allocation across different securities within the same sector or investment theme.
• Sector Research: Analyze entire industry segments to identify trends, growth opportunities, and potential risks affecting multiple companies within specific market sectors.
• Risk Assessment Projects: Conduct detailed risk analysis for individual positions or portfolio holdings, identifying potential downside scenarios and risk mitigation strategies.
• Technical Trading Analysis: Generate detailed technical analysis with specific entry and exit points, support and resistance levels, and momentum indicators for short-term trading decisions.

How To Use It

1. Clone the project’s repository from GitHub.

https://github.com/sagar-n/deepagents.git.
cd deepagent-stock-research

2. Create a requirements.txt and Install Dependencies:

# requirements.txt
deepagents
langchain-ollama
langchain-core
yfinance
gradio
pandas
numpy

pip install -r requirements.txt

3. This tool uses Ollama to run the language model locally. If you don’t have it, install it by running:

curl -fsSL https://ollama.ai/install.sh | sh.

4. Pull an LLM for it to use:

ollama pull gpt-oss

5. Start the application:

 python researchagent.py

6. Open a web browser and go to http://localhost:7860.

7. Input your analysis request using natural language queries. For example, you might ask for an analysis of Apple Inc. for a six-month investment horizon, including current financial performance, technical analysis with trading signals, and risk assessment with investment recommendations.

8. The AI will orchestrate its specialized sub-agents to gather real-time data, perform analysis, and generate a structured report. Review the output, which includes executive summary, detailed fundamental metrics, technical indicators, and specific investment recommendations with price targets.

Pros

• Runs Locally: Your data and queries remain private since the entire process runs on your machine.
• Customizable: You can add your own custom analysis tools or even new specialized sub-agents, for example, one that focuses on ESG (Environmental, Social, and Governance) factors.
• Open-Source: The tool is free to use and modify, and it’s built on top of the popular LangChain framework.
• Detailed Analysis: It goes beyond simple data retrieval, offering synthesized insights that mimic a human analyst’s report.
• No API Key Costs for LLM: Since it uses a local model via Ollama, you don’t have to worry about paying for API calls to services like OpenAI.

Cons

• Requires Technical Setup: You need to be comfortable with the command line, Python, and installing software like Ollama. It’s not a simple web-based tool you can just sign up for.
• Dependent on Data Sources: The quality of the analysis is tied to the data it can access, which is primarily Yahoo Finance. For more obscure stocks or deeper data, this might be a limitation.
• Local Machine Performance: Running large language models can be resource-intensive. You’ll need a reasonably powerful computer for it to run smoothly and quickly.
• Not Financial Advice: The tool provides educational and research output. It’s a powerful assistant, but it’s not a substitute for a qualified financial advisor.

Related Resources

• LangChain DeepAgents Documentation: Official framework documentation explaining agent architecture, tool integration, and advanced implementation techniques for building sophisticated AI systems.
• Ollama Installation Guide: Setup instructions and model management for local language model hosting, including performance optimization and troubleshooting.
• Yahoo Finance API Documentation: Technical reference for accessing financial data programmatically, including available endpoints and data formatting specifications.
• Gradio Interface Development: Framework documentation for building custom web interfaces and extending the user experience beyond the default implementation.

FAQs

Q: Can this tool provide real financial advice for my investment decisions?
A: The tool provides research and analysis but explicitly states it is for educational purposes only and does not constitute professional financial advice. Always consult qualified financial advisors before making investment decisions, as past performance does not guarantee future results.

Q: What types of stocks and markets does the system analyze?
A: The system can analyze any publicly traded stocks available through Yahoo Finance APIs, which includes most major global exchanges. However, analysis quality may vary for smaller or less liquid securities with limited financial data availability.

Q: Is DeepAgent really free?
A: Yes, the software itself is open-source and free to use. You will need your own computer to run it, but you won’t have to pay for any subscription fees or API access for the core functionalities described.