An open API service indexing awesome lists of open source software.

https://github.com/yllvar/yfinance-agent

📊 YFinance Agent: An intelligent financial analysis chat Agent that leverages of yfinance data provide deep insights into stock market data. This is Your Quant Intern Researcher
https://github.com/yllvar/yfinance-agent

aiagent quantitative-finance yfinance

Last synced: 5 months ago
JSON representation

📊 YFinance Agent: An intelligent financial analysis chat Agent that leverages of yfinance data provide deep insights into stock market data. This is Your Quant Intern Researcher

Awesome Lists containing this project

README

          

# 📊 YFinance Agent - AI-Powered Stock Analysis Intern
___

🤖 An intelligent financial analysis tool that leverages AI to provide deep insights into stock market data using yfinance and OpenAI's GPT models.

---

Screenshot 2025-02-02 at 03 31 03

---

## ✨ Features

- 📈 Real-time stock data analysis using yfinance
- 🧠 AI-powered insights with OpenAI's GPT models
- 🔍 Smart stock symbol lookup
- 📱 Clean and intuitive user interface
- 🚀 Fast and responsive performance

## 🛠️ Prerequisites

Make sure you have:
- 📦 **Node.js** (v14 or later)
- 🔑 **OpenAI API key**

## 🚀 Getting Started

### 1️⃣ Clone the repository
```bash
git clone https://github.com/yllvar/yfinance-agent.git
cd yfinance-agent
```

### 2️⃣ Install dependencies
```bash
npm install
# or
yarn install
```

### 3️⃣ Set up environment variables
Create a `.env` file and add your OpenAI API key:
```plaintext
OPENAI_API_KEY=your_api_key_here
```

### 4️⃣ Start the development server
```bash
npm run dev
# or
yarn dev
```

Visit 🌐 **http://localhost:3000** to see your app.

![download-5](https://github.com/user-attachments/assets/b4f19066-48de-45d3-b0a6-4dd91353bc45)

## 🌟 Usage

1. 🔑 Enter your OpenAI API key
2. 🔍 Search for a stock symbol (e.g., **AAPL, MSFT**)
3. 📊 View detailed analysis and AI-generated insights
4. 📈 Explore historical data and trends

## 🤝 Contributing

Contributions are welcome! Feel free to:

- 🐛 Report bugs
- 💡 Suggest features
- 🔧 Submit pull requests

## 📝 License

This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgements

- 📊 **yfinance** for stock data
- 🤖 **OpenAI** for GPT models
- ⚡ **Vercel** for hosting

## 📞 Contact

👨‍💻 **Created by me
🌐 **GitHub:** [@yllvar](https://github.com/yllvar)

⭐ **Don't forget to star this repo if you find it helpful!**