Spaces:
Sleeping
Sleeping
add: README.md
Browse files
README.md
ADDED
@@ -0,0 +1,73 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# Stock Inspect
|
2 |
+
|
3 |
+
## Introduction
|
4 |
+
|
5 |
+
Stock Inspect is a Streamlit web application designed for stock analysis. It uses the Language Model (Gemini-pro from google) to provide insights based on user-provided stock names from NSE.
|
6 |
+
|
7 |
+
## Installation
|
8 |
+
|
9 |
+
1. Clone the repository:
|
10 |
+
|
11 |
+
```bash
|
12 |
+
git clone [email protected]:kailashsp/Stock_Inspect.git
|
13 |
+
cd Stock_Inspect
|
14 |
+
```
|
15 |
+
|
16 |
+
2. Install the required dependencies:
|
17 |
+
|
18 |
+
```bash
|
19 |
+
pip install -r requirements.txt
|
20 |
+
```
|
21 |
+
|
22 |
+
3. Setup env file
|
23 |
+
1. Create a `.env` file in the root directory of the project.
|
24 |
+
|
25 |
+
2. Add the following line to your `.env` file, replacing `YOUR_GOOGLE_API_KEY` with your actual Google API key:
|
26 |
+
|
27 |
+
```env
|
28 |
+
GOOGLE_API_KEY=YOUR_GOOGLE_API_KEY
|
29 |
+
```
|
30 |
+
|
31 |
+
|
32 |
+
## Usage
|
33 |
+
|
34 |
+
1. Run the Streamlit app:
|
35 |
+
|
36 |
+
```bash
|
37 |
+
streamlit run app.py
|
38 |
+
```
|
39 |
+
|
40 |
+
2. The web application will open in your default browser.
|
41 |
+
|
42 |
+
3. Enter a stock symbol in the search box to analyze the stock.
|
43 |
+
|
44 |
+
## Components
|
45 |
+
|
46 |
+
### Libraries/Frameworks Used
|
47 |
+
|
48 |
+
- Pandas: Data manipulation and analysis.
|
49 |
+
- JSON: Data interchange format.
|
50 |
+
- Streamlit: Web application framework.
|
51 |
+
- Streamlit Searchbox: Extension for a searchable dropdown.
|
52 |
+
|
53 |
+
### Files
|
54 |
+
|
55 |
+
- `app.py`: Main Streamlit application.
|
56 |
+
- `document_preprocessor.py`: Module for generating stock fundamentals.
|
57 |
+
- `llm.py`: Module for the Language Model (LLM).
|
58 |
+
- `prompt.py`: Module containing the stock analysis prompt.
|
59 |
+
- `MCAP31122023.xlsx`: Excel file containing stock data.
|
60 |
+
|
61 |
+
## Configuration
|
62 |
+
|
63 |
+
- `streamlit_config.toml`: Configuration file for Streamlit settings.
|
64 |
+
|
65 |
+
|
66 |
+
## Acknowledgments
|
67 |
+
|
68 |
+
- Stock data provided by [Finology](https://finology.in/).
|
69 |
+
|
70 |
+
|
71 |
+
## License
|
72 |
+
|
73 |
+
This project is licensed under the [MIT License](LICENSE).
|