{"id":14964883,"url":"https://github.com/pravincoder/Stock_Analysis_Investment","last_synced_at":"2025-09-25T14:30:23.668Z","repository":{"id":252103237,"uuid":"839437783","full_name":"pravincoder/Stock_Analysis_Investment","owner":"pravincoder","description":"This project is a robust and scalable multi-agent stock investment and analysis platform built using a Flask backend and a Next.js frontend, leveraging CrewAI for sophisticated multi-agent interactions. ","archived":false,"fork":false,"pushed_at":"2024-12-10T17:23:44.000Z","size":6207,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-01T22:51:26.855Z","etag":null,"topics":["crewai","exa","flask","flask-cors","groq-api","javascript","nextjs","ollama","openai-api","python","serpapi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pravincoder.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-07T15:54:26.000Z","updated_at":"2024-12-10T17:23:48.000Z","dependencies_parsed_at":"2024-09-22T19:03:13.331Z","dependency_job_id":"e4dfc3eb-a015-4fa0-86d1-b2fcaab86fb4","html_url":"https://github.com/pravincoder/Stock_Analysis_Investment","commit_stats":{"total_commits":21,"total_committers":2,"mean_commits":10.5,"dds":"0.38095238095238093","last_synced_commit":"b9796e349673b3ac4a72726fa0854794ef2c69e8"},"previous_names":["pravincoder/stock_investment_analysis_agent","pravincoder/stock_investment_analysis_crew","pravincoder/stock_analysis_investment"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pravincoder%2FStock_Analysis_Investment","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pravincoder%2FStock_Analysis_Investment/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pravincoder%2FStock_Analysis_Investment/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pravincoder%2FStock_Analysis_Investment/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pravincoder","download_url":"https://codeload.github.com/pravincoder/Stock_Analysis_Investment/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234170676,"owners_count":18790524,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crewai","exa","flask","flask-cors","groq-api","javascript","nextjs","ollama","openai-api","python","serpapi"],"created_at":"2024-09-24T13:33:53.937Z","updated_at":"2025-09-25T14:30:22.973Z","avatar_url":"https://github.com/pravincoder.png","language":"Python","readme":"\n# Project Name: Multi-Agent Stock Investment and Analysis Platform\n\n### Output(Working Demo)\n\nOnce you have sucessfully done every step mentioned below.  \nYou can also Play around .\n\n\nhttps://github.com/user-attachments/assets/26c7ec92-955e-4a6e-98af-ac9a8404d9f3\n\n## Overview\n\nThis project is a robust and scalable multi-agent stock investment and analysis platform built using a **Flask** backend and a **Next.js** frontend, leveraging **CrewAI** for sophisticated multi-agent interactions. The platform is designed to provide detailed insights and recommendations for stock investments by utilizing a multi-agent approach, enabling users to make informed decisions even with limited prior knowledge of stocks and market analysis.\n\n## Table of Contents\n\n- [Features](#features)\n- [Tech Stack](#tech-stack)\n- [Installation](#installation)\n   - [Fast Installation](#fast-installation-via-docker)\n   - [Normal Installation](#normal-installation)\n- [Usage](#usage)\n- [API Endpoints](#api-endpoints)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Features\n\n- **Multi-Agent Analysis**: Utilizes CrewAI to deploy multiple agents for in-depth stock analysis and investment recommendations.\n- **User-Friendly Interface**: Intuitive and responsive interface built with Next.js to enhance user experience.\n- **Real-Time Data**: Provides real-time stock data and insights to aid in decision-making.\n- **Secure and Scalable**: Flask backend ensures the platform is secure and can scale as needed.\n\n## Tech Stack\n\n- **Backend**: Flask\n- **Frontend**: Next.js\n- **AI/ML Integration**: CrewAI,LangChain\n- **Database**: None (For Now)\n- **APIs**: YahooFinance Api using yfinance Package\n- **Env**:Conda\n\n## Installation\n###  Fast Installation (Via Docker)\n\n#### Prerequisites\n- **Docker**: Make sure Docker is installed on your system. You can download it from the [official Docker website](https://www.docker.com/get-started).\n### Steps to Run Using Docker\n1. Clone the repository: See [Backend Setup Step 1 Command](#backend-setup) \n2. Setup Environments : See [Env Setup](#environment-variable-setup)\n3. Change Directory to Stock_Analyzer:- \n ```bash \n   cd Stock_investment_Analysis_Crew/Stock_Analyzer\n  ```\n4.Docker Build Both Frontend and Backend with Compose (Can even build Frontend and Backend Seperately using *docker build Dockerfile*)\n```bash \n   docker-compose build\n  ``` \n5.Docker Run build (replace 'up' with 'down' before recreating build)\n```bash \n   docker-compose up\n  ```\n\n## Normal Installation\n### Prerequisites\n\n- Python 3.10+\n- Node.js 14+\n- npm or yarn\n- Conda 20+\n\n### Backend Setup\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/pravincoder/Stock_investment_Analysis_Agent.git\n   ```\n2. Navigate to the Main directory:\n   ```bash\n   cd Stock_investment_Analysis_Agent/Stock_Analyzer\n   ```\n3. Create  a conda environment:\n   ```bash\n   conda env create -f environment.yml\n   ```\n4. Activate the Conda Environment:\n   ```bash\n   conda activate stock_guru\n   ```\n5. Run the Flask development server:\n   ```bash\n   python app.py\n   ```\n\n### Frontend Setup\n\n1. Navigate to the frontend directory:\n   ```bash\n   cd nextjs_app\n   ```\n2. Install the dependencies:\n   ```bash\n   npx create-next-app@latest --js --tailwind --eslint\n   ```\n   Keep every option default while setting up the app.\n3. Run the Next.js development server:\n   ```bash\n   npm run dev\n   ```\nNote:- You need to execute both the backend Flask app and the Frontend as we are using cross connection with flask-cors.\n\n## Environment Variable Setup\n### `.env` File Setup \nCreate  a .env file and add the below code :- (Make sure to add the api keys from the specified platforms)\n#### *Note:- Use .sample.env by renaming as .env and add your Keys.* \n```dotenv\n# API Key for GROQ\nGROQ_API_KEY=your_groq_api_key_here\n\n# API Key for OpenAI\nOPENAI_API_KEY=your_openai_api_key_here\n\n# Base URL for OpenAI API (default for local setup)\nOPENAI_API_BASE=http://localhost:11434/v1\n\n# Model name for OpenAI (adjust based on available models)\nOPENAI_MODEL_NAME=mistral:latest\n\n# Optional: API Key for LangChain\nLANGCHAIN_API_KEY=your_langchain_api_key_here\n\n# Optional: Enable LangChain tracing\nLANGCHAIN_TRACING_V2=true\n```\n\n### (Optional) Using Local LLM with Ollama\n- Use the  files in the setup folder to create a LLama3 , Mistral8b ... or your own LLM model \n\n- Commands/steps to setup ollama llm comming soon!\n\n## Usage\n\nOnce the servers are running, you can access the application in your browser by navigating to `http://localhost:3000`. \n\n- **Dashboard**: Begin by exploring the dashboard for a quick overview of stock market trends.\n- **Stock Analysis**: Use the analysis tools to select specific stocks and view detailed insights provided by the AI agents.\n- **Recommendations**: Get tailored investment recommendations based on your portfolio and risk profile.\n\n## API Endpoints\n\nThe Flask backend exposes several API endpoints that can be used for data retrieval and interaction:\n\n\n- `POST /analyze-stock`: Analyze a stock and return Analysis and Investment reports in Markdown format.\n\n\n  \n(Detailed documentation for each endpoint can be provided here. In near future we might make a seperate api endpoints for both reports.)\n\n## Contributing\n\nWe welcome contributions! To get started:\n\n1. Fork the repository.\n2. Create a new feature branch (`git checkout -b feature-name`).\n3. Commit your changes (`git commit -m 'Add some feature'`).\n4. Push to the branch (`git push origin feature-name`).\n5. Open a pull request.\n\nPlease ensure your code adheres to the project's coding standards and passes all tests.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contact\n\nFor any questions, issues, or suggestions, please contact:\n\n- **Project Maintainer**: [Pravin Maurya](mailto:pravincoder@gmail.com)\n- **GitHub**: [PravinCoder](https://github.com/pravincoder)\n\n---\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpravincoder%2FStock_Analysis_Investment","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpravincoder%2FStock_Analysis_Investment","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpravincoder%2FStock_Analysis_Investment/lists"}