investing-algorithm-framework 6.2.1__tar.gz → 6.3.1__tar.gz

{investing_algorithm_framework-6.2.1 → investing_algorithm_framework-6.3.1}/PKG-INFO

@@ -1,15 +1,14 @@
 Metadata-Version: 2.1
 Name: investing-algorithm-framework
-Version: 6.2.1
+Version: 6.3.1
 Summary: A framework for creating trading bots
 Author: MDUYN
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: Flask (>=2.3.2)
+Requires-Dist: Flask (>=3.1.0)
 Requires-Dist: Flask-Cors (>=3.0.9,<5.0.0)
 Requires-Dist: Flask-Migrate (>=2.6.0)
 Requires-Dist: SQLAlchemy (>=2.0.18)
@@ -31,17 +30,16 @@ Requires-Dist: tqdm (>=4.66.1)
 Requires-Dist: wrapt (>=1.16.0)
 Description-Content-Type: text/markdown
 
-<a href=https://investing-algorithm-framework.com><img src="https://img.shields.io/badge/docs-website-brightgreen"></a>
-[![Build](https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/publish.yml/badge.svg)](https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/publish.yml)
-[![Tests](https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml)
-[![Downloads](https://pepy.tech/badge/investing-algorithm-framework)](https://pepy.tech/badge/investing-algorithm-framework)
-[![Current Version](https://img.shields.io/pypi/v/investing_algorithm_framework.svg)](https://img.shields.io/pypi/v/investing_algorithm_framework.svg)
-<a href="https://www.reddit.com/r/InvestingBots/"><img src="https://img.shields.io/reddit/subreddit-subscribers/investingbots?style=social"></a> <br/>
-[![GitHub stars](https://img.shields.io/github/stars/coding-kitties/investing-algorithm-framework.svg?style=social&label=Star&maxAge=1)](https://github.com/SeaQL/sea-orm/stargazers/) If you like what we do, consider starring, sharing and contributing!
+<div align="center"> <h1><a href="https://investing-algorithm-framework.com" target="_blank">Investing Algorithm Framework</a></h1> <p><b>Rapidly build, backtest, and deploy quantitative strategies and trading bots</b></p> <a target="_blank" href="https://investing-algorithm-framework.com">📖 View Documentation</a> | <a href="https://investing-algorithm-framework.com/Getting%20Started/installation">🚀 Getting Started</a> </div>
 
-# [Investing Algorithm Framework](https://github.com/coding-kitties/investing-algorithm-framework)
+---
 
-The Investing Algorithm Framework is a Python framework that enables swift and elegant development of trading bots.
+<div align="center"> <a href="https://investing-algorithm-framework.com">
+<a target="_blank" href="https://discord.gg/dQsRmGZP"><img src="https://img.shields.io/discord/1345358169777635410.svg?color=7289da&label=TradeBotLab%20Discord&logo=discord&style=flat"></a>
+<img src="https://img.shields.io/badge/docs-website-brightgreen"></a> <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/publish.yml"><img src="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/publish.yml/badge.svg"></a> <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml"><img src="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml/badge.svg"></a> <a href="https://pepy.tech/project/investing-algorithm-framework"><img src="https://pepy.tech/badge/investing-algorithm-framework"></a> <a href="https://pypi.org/project/investing-algorithm-framework/"><img src="https://img.shields.io/pypi/v/investing-algorithm-framework.svg"></a> <a href="https://www.reddit.com/r/InvestingBots/"><img src="https://img.shields.io/reddit/subreddit-subscribers/investingbots?style=social"></a> <a href="https://github.com/coding-kitties/investing-algorithm-framework/stargazers"><img src="https://img.shields.io/github/stars/coding-kitties/investing-algorithm-framework.svg?style=social&label=Star"></a>
+ </div>
+
+> If you like what we do, consider starring, sharing and contributing!
 
 ## Sponsors
 
@@ -53,34 +51,54 @@ The Investing Algorithm Framework is a Python framework that enables swift and e
     </picture>
 </a>
 
-## Features and planned features:
-
-- [x] **Based on Python 3.9+**: Windows, macOS and Linux.
-- [x] **Documentation**: [Documentation](https://investing-algorithm-framework.com)
-- [x] **Persistence of portfolios, orders, positions and trades**: Persistence is achieved through sqlite.
-- [x] **Limit orders**: Create limit orders for buying and selling.
-- [x] **Trade models**: Models and functionality for trades, trades stop losses (fixed and trailing) and take profits (fixed and trailing).
-- [x] **Market data sources**: Market data sources for OHLCV data and ticker data, and extendible with custom data and events.
-- [x] **Polars and Pandas dataframes support** Out of the box dataframes support for fast data processing ([pola.rs](https://pola.rs/), [pandas](https://pandas.pydata.org/)).
-- [x] **Azure Functions support**: Stateless running for cloud function deployments in Azure.
-- [x] **Live trading**: Live trading.
-- [x] **Backtesting and performance analysis reports** [example](./examples/backtest_example)
-- [x] **Backtesting multiple algorithms with different backtest date ranges** [example](./examples/backtests_example)
-- [x] **Backtest comparison and experiments**: Compare multiple backtests and run experiments.
-- [x] **Order execution**: Currently support for a wide range of crypto exchanges through [ccxt](https://github.com/ccxt/ccxt) (Support for traditional asset brokers is planned).
-- [x] **Web API**: Rest API for interacting with your deployed trading bot
-- [x] **PyIndicators**: Works natively with [PyIndicators](https://github.com/coding-kitties/PyIndicators) for technical analysis on your Pandas and Polars dataframes.
-- [ ] **Builtin WebUI (Planned)**: Builtin web UI to manage your bot and evaluate your backtests.
-- [ ] **Manageable via Telegram (Planned)**: Manage the bot with Telegram.
-- [ ] **Performance status report via Web UI and telegram(Planned)**: Provide a performance status of your current trades.
-- [ ] **CI/CD integration (Planned)**: Tools for continuous integration and deployment (version tracking, comparison of backtests, automatic deployments).
-- [ ] **Tracing and replaying of strategies in backtests (Planned)**: Tracing and replaying of strategies in backtests for specific dates and date ranges so you can evaluate your strategy step by step.
-- [ ] **AWS Lambda support (Planned)**: Stateless running for cloud function deployments in AWS.
-- [ ] **Azure App services support (Planned)**: deployments in Azure app services with Web UI.
-
-## Example implementation
-
-The following algorithm connects to binance and buys BTC every 2 hours.
+
+## 🌟 Features
+
+- [x] Python 3.10+: Cross-platform support for Windows, macOS, and Linux.
+- [x] Backtesting: Simulate strategies with detailed performance reports.
+- [x] Live Trading: Execute trades in real-time with support for multiple exchanges via ccxt.
+- [x] Portfolio Management: Manage portfolios, trades, and positions with persistence via SQLite.
+- [x] Market Data Sources: Fetch OHLCV, ticker, and custom data with support for Polars and Pandas.
+- [x] Azure Functions Support: Deploy stateless trading bots to Azure.
+- [x] Web API: Interact with your bot via REST API.
+- [x] PyIndicators Integration: Perform technical analysis directly on your dataframes.
+- [x] Extensibility: Add custom strategies, data providers, order executors so you can connect your trading bot to your favorite exchange or broker.
+
+## 🚀 Quickstart
+
+Installation
+Install the framework via [PyPI](https://pypi.org/project/investing-algorithm-framework/):
+
+1. First install the framework using `pip`. The Investing Algorithm Framework is hosted on [PyPi].
+
+```bash
+pip install investing-algorithm-framework
+```
+
+Run the following command to set up your project:
+
+```bash
+investing-algorithm-framewor init
+```
+
+For a web-enabled version:
+
+```bash
+investing-algorithm-framework init --web
+```
+
+This will create:
+
+* app.py: The entry point for your bot.
+* strategy.py: A sample strategy file to get started.
+
+> Note: Keep the app.py file as is. You can modify strategy.py and add additional files to build your bot.
+> You can always change the app to the web version by changing the `app.py` file.
+
+---
+
+## 📈 Example: A Simple Trading Bot
+The following example connects to Binance and buys BTC every 2 hours.
 
 ```python
 import logging.config
@@ -144,7 +162,7 @@ if __name__ == "__main__":
 
 > You can find more examples [here](./examples) folder.
 
-## Backtesting and experiments
+## 🔍 Backtesting
 
 The framework also supports backtesting and performing backtest experiments. After a backtest, you can print a report that shows the performance of your trading bot.
 
@@ -257,53 +275,38 @@ Take profits overview
 ╰────────────────────┴───────────────┴──────────┴──────────┴─────────────────────────────────────┴──────────────┴────────────────┴─────────────────────────────────┴──────────────┴─────────────┴───────────────╯
 ```
 
-### Backtest experiments
+## 🌐 Deployment to Azure
 
-The framework also supports backtest experiments. Backtest experiments allows you to
-compare multiple algorithms and evaluate their performance. Ideally,
-you would do this by parameterizing your strategy and creating a factory function that
-creates the algorithm with the different parameters. You can find an example of this
-in the [backtest experiments example](./examples/backtest_experiment).
+Prerequisites
 
-## Broker/Exchange configuration
+Ensure Azure Functions Core Tools are installed:
 
-The framework has by default support for [ccxt](https://github.com/ccxt/ccxt).
-This should allow you to connect to a lot of brokers/exchanges.
+```bash
+npm install -g azure-functions-core-tools@4 --unsafe-perm true
+```
+Deploying to Azure
+Use the provided deployment script:
 
-```python
-from investing_algorithm_framework import PortfolioConfiguration, \
-    MarketCredential, create_app
-app = create_app()
-app.add_market_credential(
-    MarketCredential(
-        market="<your market>",
-        api_key="<your api key>",
-        secret_key="<your secret key>",
-    )
-)
-app.add_portfolio_configuration(
-    PortfolioConfiguration(
-        market="<your market>",
-        initial_balance=400,
-        trading_symbol="EUR"
-    )
-)
+This script:
+
+```
+investing-algorithm-framework deploy
 ```
 
-## Performance
+This script:
 
-We are continuously working on improving the performance of the framework. If
-you have any suggestions, please let us know.
+* Creates Azure resources (e.g., storage accounts, function apps).
+* Sets environment variables for the Azure Function.
+* Deploys your bot to Azure.
 
-## How to install
+## 📚 Documentation
+Comprehensive documentation is available at [investing-algorithm-framework.com](https://investing-algorithm-framework.com).
 
-You can download the framework with pypi.
+## 🛠️ Development
 
-```bash
-pip install investing-algorithm-framework
-```
+Local Development
 
-## Installation for local development
+Clone the repository and install dependencies using Poetry:
 
 The framework is built with poetry. To install the framework for local development, you can run the following commands:
 
@@ -324,11 +327,11 @@ To run the tests, you can run the following command:
 python -m unittest discover -s tests
 ```
 
-## Disclaimer
+## ⚠️ Disclaimer
+
 
 If you use this framework for your investments, do not risk money
-which you are afraid to lose, until you have clear understanding how
-the framework works. We can't stress this enough:
+which you are afraid to lose, until you have clear understanding how the framework works. We can't stress this enough:
 
 BEFORE YOU START USING MONEY WITH THE FRAMEWORK, MAKE SURE THAT YOU TESTED
 YOUR COMPONENTS THOROUGHLY. USE THE SOFTWARE AT YOUR OWN RISK.
@@ -337,6 +340,8 @@ THE AUTHORS AND ALL AFFILIATES ASSUME NO RESPONSIBILITY FOR YOUR INVESTMENT RESU
 Also, make sure that you read the source code of any plugin you use or
 implementation of an algorithm made with this framework.
 
+We welcome contributions! Check out the project board and issues to get started.
+
 ## Documentation
 
 All the documentation can be found online
@@ -349,17 +354,7 @@ contributing page at the website.
 If you'd like to chat with investing-algorithm-framework users
 and developers, [join us on Slack](https://inv-algo-framework.slack.com) or [join us on reddit](https://www.reddit.com/r/InvestingBots/)
 
-## Acknowledgements
-
-We want to thank all contributors to this project. A full list of all the people that contributed to the project can be
-found [here](https://github.com/investing-algorithms/investing-algorithm-framework/blob/master/AUTHORS.md)
-
-### [Bugs / Issues](https://github.com/investing-algorithms/investing-algorithm-framework/issues?q=is%3Aissue)
-
-If you discover a bug in the framework, please [search our issue tracker](https://github.com/investing-algorithms/investing-algorithm-framework/issues?q=is%3Aissue)
-first. If it hasn't been reported, please [create a new issue](https://github.com/investing-algorithms/investing-algorithm-framework/issues/new).
-
-### Contributing
+## 🤝 Contributing
 
 The investing algorithm framework is a community driven project.
 We welcome you to participate, contribute and together help build the future trading bots developed in python.
@@ -372,3 +367,20 @@ You can pick up a task by assigning yourself to it.
 This will ensure that interested parties can give valuable feedback on the feature, and let others know that you are working on it.
 
 **Important:** Always create your feature or hotfix against the `develop` branch, not `main`.
+
+## 📬 Support
+
+* Slack Community
+* Reddit Community
+
+
+## 🏆 Acknowledgements
+
+We want to thank all contributors to this project. A full list of all the people that contributed to the project can be
+found [here](https://github.com/investing-algorithms/investing-algorithm-framework/blob/master/AUTHORS.md)
+
+### [Bugs / Issues](https://github.com/investing-algorithms/investing-algorithm-framework/issues?q=is%3Aissue)
+
+If you discover a bug in the framework, please [search our issue tracker](https://github.com/investing-algorithms/investing-algorithm-framework/issues?q=is%3Aissue)
+first. If it hasn't been reported, please [create a new issue](https://github.com/investing-algorithms/investing-algorithm-framework/issues/new).
+

{investing_algorithm_framework-6.2.1 → investing_algorithm_framework-6.3.1}/README.md

@@ -1,14 +1,13 @@
-<a href=https://investing-algorithm-framework.com><img src="https://img.shields.io/badge/docs-website-brightgreen"></a>
-[![Build](https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/publish.yml/badge.svg)](https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/publish.yml)
-[![Tests](https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml)
-[![Downloads](https://pepy.tech/badge/investing-algorithm-framework)](https://pepy.tech/badge/investing-algorithm-framework)
-[![Current Version](https://img.shields.io/pypi/v/investing_algorithm_framework.svg)](https://img.shields.io/pypi/v/investing_algorithm_framework.svg)
-<a href="https://www.reddit.com/r/InvestingBots/"><img src="https://img.shields.io/reddit/subreddit-subscribers/investingbots?style=social"></a> <br/>
-[![GitHub stars](https://img.shields.io/github/stars/coding-kitties/investing-algorithm-framework.svg?style=social&label=Star&maxAge=1)](https://github.com/SeaQL/sea-orm/stargazers/) If you like what we do, consider starring, sharing and contributing!
+<div align="center"> <h1><a href="https://investing-algorithm-framework.com" target="_blank">Investing Algorithm Framework</a></h1> <p><b>Rapidly build, backtest, and deploy quantitative strategies and trading bots</b></p> <a target="_blank" href="https://investing-algorithm-framework.com">📖 View Documentation</a> | <a href="https://investing-algorithm-framework.com/Getting%20Started/installation">🚀 Getting Started</a> </div>
 
-# [Investing Algorithm Framework](https://github.com/coding-kitties/investing-algorithm-framework)
+---
 
-The Investing Algorithm Framework is a Python framework that enables swift and elegant development of trading bots.
+<div align="center"> <a href="https://investing-algorithm-framework.com">
+<a target="_blank" href="https://discord.gg/dQsRmGZP"><img src="https://img.shields.io/discord/1345358169777635410.svg?color=7289da&label=TradeBotLab%20Discord&logo=discord&style=flat"></a>
+<img src="https://img.shields.io/badge/docs-website-brightgreen"></a> <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/publish.yml"><img src="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/publish.yml/badge.svg"></a> <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml"><img src="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml/badge.svg"></a> <a href="https://pepy.tech/project/investing-algorithm-framework"><img src="https://pepy.tech/badge/investing-algorithm-framework"></a> <a href="https://pypi.org/project/investing-algorithm-framework/"><img src="https://img.shields.io/pypi/v/investing-algorithm-framework.svg"></a> <a href="https://www.reddit.com/r/InvestingBots/"><img src="https://img.shields.io/reddit/subreddit-subscribers/investingbots?style=social"></a> <a href="https://github.com/coding-kitties/investing-algorithm-framework/stargazers"><img src="https://img.shields.io/github/stars/coding-kitties/investing-algorithm-framework.svg?style=social&label=Star"></a>
+ </div>
+
+> If you like what we do, consider starring, sharing and contributing!
 
 ## Sponsors
 
@@ -20,34 +19,54 @@ The Investing Algorithm Framework is a Python framework that enables swift and e
     </picture>
 </a>
 
-## Features and planned features:
-
-- [x] **Based on Python 3.9+**: Windows, macOS and Linux.
-- [x] **Documentation**: [Documentation](https://investing-algorithm-framework.com)
-- [x] **Persistence of portfolios, orders, positions and trades**: Persistence is achieved through sqlite.
-- [x] **Limit orders**: Create limit orders for buying and selling.
-- [x] **Trade models**: Models and functionality for trades, trades stop losses (fixed and trailing) and take profits (fixed and trailing).
-- [x] **Market data sources**: Market data sources for OHLCV data and ticker data, and extendible with custom data and events.
-- [x] **Polars and Pandas dataframes support** Out of the box dataframes support for fast data processing ([pola.rs](https://pola.rs/), [pandas](https://pandas.pydata.org/)).
-- [x] **Azure Functions support**: Stateless running for cloud function deployments in Azure.
-- [x] **Live trading**: Live trading.
-- [x] **Backtesting and performance analysis reports** [example](./examples/backtest_example)
-- [x] **Backtesting multiple algorithms with different backtest date ranges** [example](./examples/backtests_example)
-- [x] **Backtest comparison and experiments**: Compare multiple backtests and run experiments.
-- [x] **Order execution**: Currently support for a wide range of crypto exchanges through [ccxt](https://github.com/ccxt/ccxt) (Support for traditional asset brokers is planned).
-- [x] **Web API**: Rest API for interacting with your deployed trading bot
-- [x] **PyIndicators**: Works natively with [PyIndicators](https://github.com/coding-kitties/PyIndicators) for technical analysis on your Pandas and Polars dataframes.
-- [ ] **Builtin WebUI (Planned)**: Builtin web UI to manage your bot and evaluate your backtests.
-- [ ] **Manageable via Telegram (Planned)**: Manage the bot with Telegram.
-- [ ] **Performance status report via Web UI and telegram(Planned)**: Provide a performance status of your current trades.
-- [ ] **CI/CD integration (Planned)**: Tools for continuous integration and deployment (version tracking, comparison of backtests, automatic deployments).
-- [ ] **Tracing and replaying of strategies in backtests (Planned)**: Tracing and replaying of strategies in backtests for specific dates and date ranges so you can evaluate your strategy step by step.
-- [ ] **AWS Lambda support (Planned)**: Stateless running for cloud function deployments in AWS.
-- [ ] **Azure App services support (Planned)**: deployments in Azure app services with Web UI.
-
-## Example implementation
-
-The following algorithm connects to binance and buys BTC every 2 hours.
+
+## 🌟 Features
+
+- [x] Python 3.10+: Cross-platform support for Windows, macOS, and Linux.
+- [x] Backtesting: Simulate strategies with detailed performance reports.
+- [x] Live Trading: Execute trades in real-time with support for multiple exchanges via ccxt.
+- [x] Portfolio Management: Manage portfolios, trades, and positions with persistence via SQLite.
+- [x] Market Data Sources: Fetch OHLCV, ticker, and custom data with support for Polars and Pandas.
+- [x] Azure Functions Support: Deploy stateless trading bots to Azure.
+- [x] Web API: Interact with your bot via REST API.
+- [x] PyIndicators Integration: Perform technical analysis directly on your dataframes.
+- [x] Extensibility: Add custom strategies, data providers, order executors so you can connect your trading bot to your favorite exchange or broker.
+
+## 🚀 Quickstart
+
+Installation
+Install the framework via [PyPI](https://pypi.org/project/investing-algorithm-framework/):
+
+1. First install the framework using `pip`. The Investing Algorithm Framework is hosted on [PyPi].
+
+```bash
+pip install investing-algorithm-framework
+```
+
+Run the following command to set up your project:
+
+```bash
+investing-algorithm-framewor init
+```
+
+For a web-enabled version:
+
+```bash
+investing-algorithm-framework init --web
+```
+
+This will create:
+
+* app.py: The entry point for your bot.
+* strategy.py: A sample strategy file to get started.
+
+> Note: Keep the app.py file as is. You can modify strategy.py and add additional files to build your bot.
+> You can always change the app to the web version by changing the `app.py` file.
+
+---
+
+## 📈 Example: A Simple Trading Bot
+The following example connects to Binance and buys BTC every 2 hours.
 
 ```python
 import logging.config
@@ -111,7 +130,7 @@ if __name__ == "__main__":
 
 > You can find more examples [here](./examples) folder.
 
-## Backtesting and experiments
+## 🔍 Backtesting
 
 The framework also supports backtesting and performing backtest experiments. After a backtest, you can print a report that shows the performance of your trading bot.
 
@@ -224,53 +243,38 @@ Take profits overview
 ╰────────────────────┴───────────────┴──────────┴──────────┴─────────────────────────────────────┴──────────────┴────────────────┴─────────────────────────────────┴──────────────┴─────────────┴───────────────╯
 ```
 
-### Backtest experiments
+## 🌐 Deployment to Azure
 
-The framework also supports backtest experiments. Backtest experiments allows you to
-compare multiple algorithms and evaluate their performance. Ideally,
-you would do this by parameterizing your strategy and creating a factory function that
-creates the algorithm with the different parameters. You can find an example of this
-in the [backtest experiments example](./examples/backtest_experiment).
+Prerequisites
 
-## Broker/Exchange configuration
+Ensure Azure Functions Core Tools are installed:
 
-The framework has by default support for [ccxt](https://github.com/ccxt/ccxt).
-This should allow you to connect to a lot of brokers/exchanges.
+```bash
+npm install -g azure-functions-core-tools@4 --unsafe-perm true
+```
+Deploying to Azure
+Use the provided deployment script:
 
-```python
-from investing_algorithm_framework import PortfolioConfiguration, \
-    MarketCredential, create_app
-app = create_app()
-app.add_market_credential(
-    MarketCredential(
-        market="<your market>",
-        api_key="<your api key>",
-        secret_key="<your secret key>",
-    )
-)
-app.add_portfolio_configuration(
-    PortfolioConfiguration(
-        market="<your market>",
-        initial_balance=400,
-        trading_symbol="EUR"
-    )
-)
+This script:
+
+```
+investing-algorithm-framework deploy
 ```
 
-## Performance
+This script:
 
-We are continuously working on improving the performance of the framework. If
-you have any suggestions, please let us know.
+* Creates Azure resources (e.g., storage accounts, function apps).
+* Sets environment variables for the Azure Function.
+* Deploys your bot to Azure.
 
-## How to install
+## 📚 Documentation
+Comprehensive documentation is available at [investing-algorithm-framework.com](https://investing-algorithm-framework.com).
 
-You can download the framework with pypi.
+## 🛠️ Development
 
-```bash
-pip install investing-algorithm-framework
-```
+Local Development
 
-## Installation for local development
+Clone the repository and install dependencies using Poetry:
 
 The framework is built with poetry. To install the framework for local development, you can run the following commands:
 
@@ -291,11 +295,11 @@ To run the tests, you can run the following command:
 python -m unittest discover -s tests
 ```
 
-## Disclaimer
+## ⚠️ Disclaimer
+
 
 If you use this framework for your investments, do not risk money
-which you are afraid to lose, until you have clear understanding how
-the framework works. We can't stress this enough:
+which you are afraid to lose, until you have clear understanding how the framework works. We can't stress this enough:
 
 BEFORE YOU START USING MONEY WITH THE FRAMEWORK, MAKE SURE THAT YOU TESTED
 YOUR COMPONENTS THOROUGHLY. USE THE SOFTWARE AT YOUR OWN RISK.
@@ -304,6 +308,8 @@ THE AUTHORS AND ALL AFFILIATES ASSUME NO RESPONSIBILITY FOR YOUR INVESTMENT RESU
 Also, make sure that you read the source code of any plugin you use or
 implementation of an algorithm made with this framework.
 
+We welcome contributions! Check out the project board and issues to get started.
+
 ## Documentation
 
 All the documentation can be found online
@@ -316,17 +322,7 @@ contributing page at the website.
 If you'd like to chat with investing-algorithm-framework users
 and developers, [join us on Slack](https://inv-algo-framework.slack.com) or [join us on reddit](https://www.reddit.com/r/InvestingBots/)
 
-## Acknowledgements
-
-We want to thank all contributors to this project. A full list of all the people that contributed to the project can be
-found [here](https://github.com/investing-algorithms/investing-algorithm-framework/blob/master/AUTHORS.md)
-
-### [Bugs / Issues](https://github.com/investing-algorithms/investing-algorithm-framework/issues?q=is%3Aissue)
-
-If you discover a bug in the framework, please [search our issue tracker](https://github.com/investing-algorithms/investing-algorithm-framework/issues?q=is%3Aissue)
-first. If it hasn't been reported, please [create a new issue](https://github.com/investing-algorithms/investing-algorithm-framework/issues/new).
-
-### Contributing
+## 🤝 Contributing
 
 The investing algorithm framework is a community driven project.
 We welcome you to participate, contribute and together help build the future trading bots developed in python.
@@ -338,4 +334,20 @@ You can pick up a task by assigning yourself to it.
 **Note** before starting any major new feature work, *please open an issue describing what you are planning to do*.
 This will ensure that interested parties can give valuable feedback on the feature, and let others know that you are working on it.
 
-**Important:** Always create your feature or hotfix against the `develop` branch, not `main`.
+**Important:** Always create your feature or hotfix against the `develop` branch, not `main`.
+
+## 📬 Support
+
+* Slack Community
+* Reddit Community
+
+
+## 🏆 Acknowledgements
+
+We want to thank all contributors to this project. A full list of all the people that contributed to the project can be
+found [here](https://github.com/investing-algorithms/investing-algorithm-framework/blob/master/AUTHORS.md)
+
+### [Bugs / Issues](https://github.com/investing-algorithms/investing-algorithm-framework/issues?q=is%3Aissue)
+
+If you discover a bug in the framework, please [search our issue tracker](https://github.com/investing-algorithms/investing-algorithm-framework/issues?q=is%3Aissue)
+first. If it hasn't been reported, please [create a new issue](https://github.com/investing-algorithms/investing-algorithm-framework/issues/new).

{investing_algorithm_framework-6.2.1 → investing_algorithm_framework-6.3.1}/investing_algorithm_framework/__init__.py

@@ -11,12 +11,14 @@ from investing_algorithm_framework.domain import ApiException, \
     RESERVED_BALANCES, APP_MODE, AppMode, DATETIME_FORMAT, \
     load_backtest_report, BacktestDateRange, convert_polars_to_pandas, \
     DateRange, get_backtest_report, DEFAULT_LOGGING_CONFIG, \
-    BacktestReport, TradeStatus, MarketDataType, TradeRiskType
+    BacktestReport, TradeStatus, MarketDataType, TradeRiskType, \
+    APPLICATION_DIRECTORY
 from investing_algorithm_framework.infrastructure import \
     CCXTOrderBookMarketDataSource, CCXTOHLCVMarketDataSource, \
     CCXTTickerMarketDataSource, CSVOHLCVMarketDataSource, \
     CSVTickerMarketDataSource, AzureBlobStorageStateHandler
 from .create_app import create_app
+from .download_data import download
 
 __all__ = [
     "Algorithm",
@@ -73,5 +75,7 @@ __all__ = [
     "TradeStatus",
     "MarketDataType",
     "TradeRiskType",
-    "Context"
+    "Context",
+    "APPLICATION_DIRECTORY",
+    "download"
 ]

{investing_algorithm_framework-6.2.1 → investing_algorithm_framework-6.3.1}/investing_algorithm_framework/app/algorithm.py

@@ -22,7 +22,7 @@ class Algorithm:
     them in the correct order.
 
     Args:
-        name (str): The name of the algorithm
+        name (str): (Optional) The name of the algorithm
         description (str): The description of the algorithm
         context (dict): The context of the algorithm, for backtest
           references