Skip to content

Commit 4a8a26a

Browse files
author
KVignesh122
committed
Updated README.md
1 parent 57dbbb6 commit 4a8a26a

File tree

6 files changed

+47
-4
lines changed

6 files changed

+47
-4
lines changed

.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,6 @@ __pycache__/*
88
oai.py
99
main-mine.py
1010
websearch copy.py
11-
*.jpg
1211
plotting.py
1312
sbc.py
13+
*.pyc

README.md

Lines changed: 45 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,32 @@
11
# Asset News Sentiment Analyzer
22

3-
This application provides two sophisticated tools catering to sentimental analysis of financial assets and securities through Google search results and online news articles. You will just need an OpenAI API Key to get started and utilize the power of all the functionalities provided by this package, namely to fetch news articles, analyze their content, and produce insightful reports for investment and trading decisions.
3+
This application provides two sophisticated tools catering to sentiment analysis of financial assets and securities through Google search results and online news articles. You will just need an OpenAI API Key to get started and utilize the power of all the functionalities provided by this package, namely to fetch news articles, analyze their content, and produce insightful reports for investment and trading decisions.
4+
5+
A simple trading strategy involving daily sentiment analysis signals from this package may provide basic market traction of the target asset (We did a sample backtest on commodities over the past 100 market days):
6+
7+
<table>
8+
<tr>
9+
<td align="center">
10+
<strong>Crude Oil 100 Days</strong><br>
11+
<img src="images/Crude Oil.jpg" alt="Crude Oil Sample" width="500" height="300">
12+
</td>
13+
<td align="center">
14+
<strong>Gold 100 Days</strong><br>
15+
<img src="images/Gold.jpg" alt="Gold Sample" width="500" height="300">
16+
</td>
17+
</tr>
18+
</table>
19+
20+
***Disclaimer: All investments and trading involve risk. This package is intended for research/academic purposes, and coding projects. It aids algorithmic/quantitative traders and researchers in their work. The reports and signals generated by this package does not constitute financial advice, and users should perform their own due diligence before making any trading decisions.***
21+
22+
## Contents
23+
24+
- [Two Main Classes](#two-main-classes)
25+
- [SentimentAnalyzer Tool](#1-sentimentanalyzer-tool)
26+
- [WebInteractor Tool](#2-webinteractor-tool)
27+
- [Installation](#installation)
28+
- [Contributing](#contributing)
29+
- [License](#license)
430

531
## Two Main Classes
632

@@ -42,7 +68,7 @@ __Available Methods:__
4268
* `.fetch_news_links()`: Fetches news links from Google Search News tab for the specified asset on the given date. If `news_date` parameter is not assigned, it will retrieve the current day's latests news links. `nlinks` parameter denotes the number of news links to retrieve, default is `4`.
4369
* `.show_news_content(<news_url>)`: Parses and returns main content as string for a given news URL.
4470
* `.get_sentiment()`: Analyzes online results automatically and returns the news sentiment for asset/security on any given date. If `date` parameter is not assigned, it will return the current day's latest sentiment verdict.
45-
* `produce_daily_report()`: Generates a daily report returned as string with insights based on the online Google Search content for any given date. If `date` parameter is not assigned, it will generate report for the current day. The default `max_words` is `100`, but this can be adjusted as preferred.
71+
* `.produce_daily_report()`: Generates a daily report returned as string with insights based on the online Google Search content for any given date. If `date` parameter is not assigned, it will generate report for the current day. The default `max_words` is `100`, but this can be adjusted as preferred.
4672

4773
Note: All dates must be in `MM-dd-YYYY` format or must be passed as a `datetime.datetime` object into the methods.
4874

@@ -112,3 +138,20 @@ Project has been published on pip
112138
```bash
113139
pip install asset-sentiment-analyzer
114140
```
141+
142+
## Contributing
143+
144+
If you would like to contribute to this project, please follow the guidelines below:
145+
146+
- Fork the repository.
147+
- Create a new branch (git checkout -b feature-branch).
148+
- Make your changes.
149+
- Commit your changes (git commit -m 'Add new feature').
150+
- Push to the branch (git push origin feature-branch).
151+
- Open a pull request.
152+
153+
## License
154+
155+
This project is pioneered by SkyBlue Capital (Singapore), and is licensed under the Apache-2.0 License. See the LICENSE file for details.
156+
157+
<img src="images/HBlack.png" alt="SBC Logo" width="190" height="55">

images/Crude Oil.jpg

103 KB
Loading

images/Gold.jpg

97.1 KB
Loading

images/HBlack.png

24.1 KB
Loading

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
setup(
44
name='asset_sentiment_analyzer',
5-
version='0.1.3',
5+
version='0.1.4',
66
description='A sentiment analyzer package for financial assets and securities utilizing GPT models.',
77
long_description=open('README.md').read(),
88
long_description_content_type='text/markdown',

0 commit comments

Comments
 (0)