pfund 0.0.1.dev3__tar.gz → 0.0.1.dev5__tar.gz

{pfund-0.0.1.dev3 → pfund-0.0.1.dev5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pfund
-Version: 0.0.1.dev3
+Version: 0.0.1.dev5
 Summary: A Complete Algo-Trading Framework for Machine Learning, enabling trading across TradFi, CeFi and DeFi. Supports Vectorized and Event-Driven Backtesting, Paper and Live Trading
 Home-page: https://pfund.ai
 License: Apache-2.0
@@ -13,9 +13,8 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Requires-Dist: click (>=8.1.7,<9.0.0)
-Requires-Dist: orjson (>=3.9.12,<4.0.0)
-Requires-Dist: pandas (>=2.2.0,<3.0.0)
-Requires-Dist: pfeed (>=0.0.1.dev3,<0.0.2)
+Requires-Dist: orjson (>=3.9.14,<4.0.0)
+Requires-Dist: pfeed (>=0.0.1.dev5,<0.0.2)
 Requires-Dist: platformdirs (>=4.2.0,<5.0.0)
 Requires-Dist: psutil (>=5.9.8,<6.0.0)
 Requires-Dist: python-telegram-bot (>=20.7,<21.0)
@@ -23,34 +22,52 @@ Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
 Requires-Dist: pyzmq (>=25.1.2,<26.0.0)
 Requires-Dist: rich (>=13.7.0,<14.0.0)
 Requires-Dist: schedule (>=1.2.1,<2.0.0)
-Requires-Dist: scikit-learn (>=1.4.0,<2.0.0)
 Requires-Dist: ta (>=0.11.0,<0.12.0)
-Requires-Dist: torch (>=2.1.2,<3.0.0)
 Requires-Dist: websocket-client (>=1.7.0,<2.0.0)
-Project-URL: Documentation, https://pfund.ai/docs
+Project-URL: Documentation, https://pfund-docs.pfund.ai
 Project-URL: Repository, https://github.com/PFund-Software-Ltd/pfund
 Description-Content-Type: text/markdown
 
 # PFund: Algo-Trading Framework for Machine Learning, TradFi, CeFi and DeFi ready.
 
-[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
+![GitHub stars](https://img.shields.io/github/stars/PFund-Software-Ltd/pfund?style=social)
+![PyPI downloads](https://img.shields.io/pypi/dm/pfund)
 [![PyPI](https://img.shields.io/pypi/v/pfund.svg)](https://pypi.org/project/pfund)
 ![PyPI - Support Python Versions](https://img.shields.io/pypi/pyversions/pfund)
+[![Jupyter Book Badge](https://raw.githubusercontent.com/PFund-Software-Ltd/pfund/main/docs/images/jupyterbook.svg
+)](https://jupyterbook.org)
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
 
-PFund (/piː fʌnd/), which stands for "Personal Fund", is an algo-trading framework designed for using machine learning models to trade across TradFi (Traditional Finance, e.g. Interactive Brokers), CeFi (Centralized Finance, e.g. Binance) and DeFi (Decentralized Finance, e.g. [dYdX](https://dydx.exchange)), or in simple terms, **Stocks** and **Cryptos**.
+[TradFi]: https://www.techopedia.com/definition/traditional-finance-tradfi
+[CeFi]: https://www.techopedia.com/definition/centralized-finance-cefi
+[DeFi]: https://www.coinbase.com/learn/crypto-basics/what-is-defi
+[pytrade.org]: https://pytrade.org
+[dYdX]: https://dydx.exchange
+[polars]: https://pola.rs/
+[PFund.ai]: https://pfund.ai
+[PFeed]: https://github.com/PFund-Software-Ltd/pfeed
+[Bybit]: https://bybit.com/
+[PyTorch]: https://pytorch.org/
+[Poetry]: https://python-poetry.org
+[Futu]: https://www.futunn.com
+[FirstRate Data]: https://firstratedata.com
+[Mantine UI]: https://ui.mantine.dev/
+
+PFund (/piː fʌnd/), which stands for "**Personal Fund**", is an **algo-trading framework** designed for using **machine learning** models to trade across [TradFi] (Traditional Finance, e.g. **Interactive Brokers**), [CeFi] (Centralized Finance, e.g. Binance) and [DeFi] (Decentralized Finance, e.g. [dYdX]), or in simple terms, **Stocks** and **Cryptos**.
 
 PFund allows traders to:
 - perform vectorized or event-driven backtesting with
   - different resolutions of data, e.g. orderbook data, tick data, bar data etc.
-  - different data tools, e.g. pandas, [polars](https://pola.rs/) etc.
+  - different data tools, e.g. pandas, [polars] etc.
 - train machine learning models using their favorite frameworks, i.e. PFund is **ML-framework agnostic**
 - tune strategy (hyper)parameters by splitting data into training sets, development sets and test sets
 - go from backtesting to live trading by just changing **ONE line of code!!**
+- execute trades manually/semi-manually via a trading app (frontend+backend)
 
-It is created to enable trading for [PFund.ai](https://pfund.ai) - a trading platform that bridges algo-trading and manual trading using AI (LLM).
+It is created to enable trading for [PFund.ai] - a trading platform that bridges algo-trading and manual trading using AI (LLM).
 
 Since PFund's sole purpose is for trading only, for all the data work, there is a separate library to handle that: \
-[PFeed](https://github.com/PFund-Software-Ltd/pfeed) - Data pipeline for algo-trading, helping traders in getting real-time and historical data, and storing them in a local data lake for quantitative research.
+[PFeed] - Data pipeline for algo-trading, helping traders in getting real-time and historical data, and storing them in a local data lake for quantitative research.
 
 
 <details>
@@ -77,12 +94,12 @@ Since PFund's sole purpose is for trading only, for all the data work, there is
 **_Caution: PFund is at a VERY EARLY stage, use it at your own risk._**
 
 PFund is currently under active development, the framework design will be prioritized first over
-stability and scalability. 
+stability and scalability.
 
 Please note that the available version is a *dev* version, not a *stable* one. \
 You are encouraged to play with the *dev* version, but only use it when a *stable* version is released.
 
-> PFund for the time being **_only supports vectorized backtesting_** using [Bybit](https://bybit.com/) and Yahoo Finance data for testing purpose.
+> PFund for the time being **_only supports vectorized backtesting_** using [Bybit] and Yahoo Finance data for testing purpose.
 
 
 ## Mission
@@ -98,7 +115,7 @@ As an algo-trader, if you aim to quickly try out some trading ideas to see if th
 
 This overview already omits some intricate steps, such as data handling and API integration.
 
-> PFund's mission is to **_enable traders to concentrate solely on strategy formulation_** while the framework manages the rest. With PFund serving as the core trade engine, it empowers retail traders to have a fund management experience on [PFund.ai](https://pfund.ai) as if they are operating their personal hedge fund, hence the name *PFund*.
+> PFund's mission is to **_enable traders to concentrate solely on strategy formulation_** while the framework manages the rest. With PFund serving as the core trade engine, it empowers retail traders to have a fund management experience on [PFund.ai] as if they are operating their personal hedge fund, hence the name *PFund*.
 
 
 ## Core Features
@@ -109,20 +126,36 @@ This overview already omits some intricate steps, such as data handling and API
 - [x] Streamlines the algo-trading flow, from vectorized backtesting for strategy prototyping and event-driven backtesting for strategy development, to live trading for strategy deployment
 - [x] Enables parallel data processing, e.g. Interactive Brokers and Binance each have their own process for receiving data feeds
 - [ ] Allows choosing your preferred data tool, e.g. pandas, polars, pyspark etc.
-- [ ] Features a modern frontend using [Mantine UI](https://ui.mantine.dev/) and TradingView's Charts library
-
+- [ ] Features a modern frontend using [Mantine UI] and TradingView's Charts library
+- [ ] Supports manual/semi-manual trading using the frontend
 
 
 ## Installation
-### Using [Poetry](https://python-poetry.org) (Recommended)
+> Python 3.12 is not supported until [PyTorch]supports it
+
+### Using [Poetry] (Recommended)
 ```bash
 poetry add pfund
+
+# update to the latest version:
+poetry update pfund
 ```
 
 
 ### Using Pip
 ```bash
 pip install pfund
+
+# install the latest version:
+pip install -U pfund
+```
+
+
+### Checking your installation
+```bash
+$ pfund --version
+
+pfund, version 0.0.1.dev4
 ```
 
 
@@ -138,10 +171,18 @@ class YourStrategy(pf.Strategy):
         # write your trading logic here
         pass
 
-engine = pf.BacktestEngine(...)
-strategy = engine.add_strategy(YourStrategy())
-strategy.add_data(...)
-strategy.add_model(...)
+
+engine = pf.BacktestEngine(mode='vectorized')
+strategy = engine.add_strategy(YourStrategy(), name='your_strategy')
+strategy.add_data(
+  'IB', 'AAPL', 'USD', 'STK', resolutions=['1d'],
+  backtest={
+    # NOTE: since IB does not provide any historical data for backtesting purpose, use data from 'YAHOO_FINANCE'
+    'data_source': 'YAHOO_FINANCE',
+    'start_date': '2024-01-01',
+    'end_date': '2024-02-01',
+  }
+)
 engine.run()
 ```
 
@@ -152,9 +193,17 @@ engine.run()
 import pfund as pf
 
 engine = pf.TradeEngine(env='LIVE')
-strategy = engine.add_strategy(YourStrategy())
-strategy.add_data(...)
-strategy.add_model(...)
+strategy = engine.add_strategy(YourStrategy(), name='your_strategy')
+strategy.add_data(
+  'IB', 'AAPL', 'USD', 'STK', resolutions=['1d'],
+  # for convenience, you can keep the kwarg `backtest`, `TradeEngine` will ignore it
+  backtest={
+    # NOTE: since IB does not provide any historical data for backtesting purpose, use data from 'YAHOO_FINANCE'
+    'data_source': 'YAHOO_FINANCE',
+    'start_date': '2024-01-01',
+    'end_date': '2024-02-01',
+  }
+)
 engine.run()
 ```
 
@@ -192,28 +241,29 @@ engine.run()
 ## Model Hub
 Imagine a space where algo-traders can share their machine learning models with one another.
 Strategy and model development could be so much faster since you can build on top of an existing working model.
-> Model Hub is coming soon in [PFund.ai](https://pfund.ai), Stay Tuned!
+> Model Hub is coming soon on [PFund.ai], Stay Tuned!
 
 
 ## Supported Trading Venues
-| Trading Venue                   | Vectorized Backtesting | Event-Driven Backtesting | Paper Trading | Live Trading |
-| ------------------------------- | ---------------------- | ------------------------ | ------------- | ------------ |
-| Bybit                           | 🟢                     | 🟡                       | 🟡            | 🟡           |
-| *Interactive Brokers (IB)       | 🟡                     | 🟡                       | 🟡            | 🟡           |
-| Binance                         | 🔴                     | 🔴                       | 🔴            | 🔴           |
-| OKX                             | 🔴                     | 🔴                       | 🔴            | 🔴           |
-| *Alpaca                         | 🔴                     | 🔴                       | 🔴            | 🔴           |
-| *[Futu](https://www.futunn.com) | 🔴                     | 🔴                       | 🔴            | 🔴           |
-| dYdX                            | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| Trading Venue             | Vectorized Backtesting | Event-Driven Backtesting | Paper Trading | Live Trading |
+| ------------------------- | ---------------------- | ------------------------ | ------------- | ------------ |
+| Bybit                     | 🟢                     | 🟡                       | 🟡            | 🟡           |
+| *Interactive Brokers (IB) | 🟡                     | 🟡                       | 🟡            | 🟡           |
+| Binance                   | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| OKX                       | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| *Alpaca                   | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| *[Futu]                   | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| dYdX                      | 🔴                     | 🔴                       | 🔴            | 🔴           |
 
 🟢 = finished \
 🟡 = in progress \
 🔴 = todo \
-\* = use a **_separate data source_** (e.g. [FirstRate Data](https://firstratedata.com)) for backtesting
+\* = use a **_separate data source_** (e.g. [FirstRate Data]) for backtesting
 
 
 ## Related Projects
-- [PFeed](https://github.com/PFund-Software-Ltd/pfeed) — Data pipeline for algo-trading, helping traders in getting real-time and historical data, and storing them in a local data lake for quantitative research.
+- [PFeed] — Data pipeline for algo-trading, helping traders in getting real-time and historical data, and storing them in a local data lake for quantitative research.
+- [PyTrade.org] - A curated list of Python libraries and resources for algorithmic trading.
 
 
 ## Disclaimer
@@ -222,4 +272,3 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 This algo-trading framework is intended for educational and research purposes only. It should not be used for real trading without understanding the risks involved. Trading in financial markets involves significant risk, and there is always the potential for loss. Your trading results may vary. No representation is being made that any account will or is likely to achieve profits or losses similar to those discussed on this platform.
 
 The developers of this framework are not responsible for any financial losses incurred from using this software. Users should conduct their due diligence and consult with a professional financial advisor before engaging in real trading activities.
-

{pfund-0.0.1.dev3 → pfund-0.0.1.dev5}/README.md

@@ -1,23 +1,43 @@
 # PFund: Algo-Trading Framework for Machine Learning, TradFi, CeFi and DeFi ready.
 
-[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
+![GitHub stars](https://img.shields.io/github/stars/PFund-Software-Ltd/pfund?style=social)
+![PyPI downloads](https://img.shields.io/pypi/dm/pfund)
 [![PyPI](https://img.shields.io/pypi/v/pfund.svg)](https://pypi.org/project/pfund)
 ![PyPI - Support Python Versions](https://img.shields.io/pypi/pyversions/pfund)
+[![Jupyter Book Badge](https://raw.githubusercontent.com/PFund-Software-Ltd/pfund/main/docs/images/jupyterbook.svg
+)](https://jupyterbook.org)
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
 
-PFund (/piː fʌnd/), which stands for "Personal Fund", is an algo-trading framework designed for using machine learning models to trade across TradFi (Traditional Finance, e.g. Interactive Brokers), CeFi (Centralized Finance, e.g. Binance) and DeFi (Decentralized Finance, e.g. [dYdX](https://dydx.exchange)), or in simple terms, **Stocks** and **Cryptos**.
+[TradFi]: https://www.techopedia.com/definition/traditional-finance-tradfi
+[CeFi]: https://www.techopedia.com/definition/centralized-finance-cefi
+[DeFi]: https://www.coinbase.com/learn/crypto-basics/what-is-defi
+[pytrade.org]: https://pytrade.org
+[dYdX]: https://dydx.exchange
+[polars]: https://pola.rs/
+[PFund.ai]: https://pfund.ai
+[PFeed]: https://github.com/PFund-Software-Ltd/pfeed
+[Bybit]: https://bybit.com/
+[PyTorch]: https://pytorch.org/
+[Poetry]: https://python-poetry.org
+[Futu]: https://www.futunn.com
+[FirstRate Data]: https://firstratedata.com
+[Mantine UI]: https://ui.mantine.dev/
+
+PFund (/piː fʌnd/), which stands for "**Personal Fund**", is an **algo-trading framework** designed for using **machine learning** models to trade across [TradFi] (Traditional Finance, e.g. **Interactive Brokers**), [CeFi] (Centralized Finance, e.g. Binance) and [DeFi] (Decentralized Finance, e.g. [dYdX]), or in simple terms, **Stocks** and **Cryptos**.
 
 PFund allows traders to:
 - perform vectorized or event-driven backtesting with
   - different resolutions of data, e.g. orderbook data, tick data, bar data etc.
-  - different data tools, e.g. pandas, [polars](https://pola.rs/) etc.
+  - different data tools, e.g. pandas, [polars] etc.
 - train machine learning models using their favorite frameworks, i.e. PFund is **ML-framework agnostic**
 - tune strategy (hyper)parameters by splitting data into training sets, development sets and test sets
 - go from backtesting to live trading by just changing **ONE line of code!!**
+- execute trades manually/semi-manually via a trading app (frontend+backend)
 
-It is created to enable trading for [PFund.ai](https://pfund.ai) - a trading platform that bridges algo-trading and manual trading using AI (LLM).
+It is created to enable trading for [PFund.ai] - a trading platform that bridges algo-trading and manual trading using AI (LLM).
 
 Since PFund's sole purpose is for trading only, for all the data work, there is a separate library to handle that: \
-[PFeed](https://github.com/PFund-Software-Ltd/pfeed) - Data pipeline for algo-trading, helping traders in getting real-time and historical data, and storing them in a local data lake for quantitative research.
+[PFeed] - Data pipeline for algo-trading, helping traders in getting real-time and historical data, and storing them in a local data lake for quantitative research.
 
 
 <details>
@@ -44,12 +64,12 @@ Since PFund's sole purpose is for trading only, for all the data work, there is
 **_Caution: PFund is at a VERY EARLY stage, use it at your own risk._**
 
 PFund is currently under active development, the framework design will be prioritized first over
-stability and scalability. 
+stability and scalability.
 
 Please note that the available version is a *dev* version, not a *stable* one. \
 You are encouraged to play with the *dev* version, but only use it when a *stable* version is released.
 
-> PFund for the time being **_only supports vectorized backtesting_** using [Bybit](https://bybit.com/) and Yahoo Finance data for testing purpose.
+> PFund for the time being **_only supports vectorized backtesting_** using [Bybit] and Yahoo Finance data for testing purpose.
 
 
 ## Mission
@@ -65,7 +85,7 @@ As an algo-trader, if you aim to quickly try out some trading ideas to see if th
 
 This overview already omits some intricate steps, such as data handling and API integration.
 
-> PFund's mission is to **_enable traders to concentrate solely on strategy formulation_** while the framework manages the rest. With PFund serving as the core trade engine, it empowers retail traders to have a fund management experience on [PFund.ai](https://pfund.ai) as if they are operating their personal hedge fund, hence the name *PFund*.
+> PFund's mission is to **_enable traders to concentrate solely on strategy formulation_** while the framework manages the rest. With PFund serving as the core trade engine, it empowers retail traders to have a fund management experience on [PFund.ai] as if they are operating their personal hedge fund, hence the name *PFund*.
 
 
 ## Core Features
@@ -76,20 +96,36 @@ This overview already omits some intricate steps, such as data handling and API
 - [x] Streamlines the algo-trading flow, from vectorized backtesting for strategy prototyping and event-driven backtesting for strategy development, to live trading for strategy deployment
 - [x] Enables parallel data processing, e.g. Interactive Brokers and Binance each have their own process for receiving data feeds
 - [ ] Allows choosing your preferred data tool, e.g. pandas, polars, pyspark etc.
-- [ ] Features a modern frontend using [Mantine UI](https://ui.mantine.dev/) and TradingView's Charts library
-
+- [ ] Features a modern frontend using [Mantine UI] and TradingView's Charts library
+- [ ] Supports manual/semi-manual trading using the frontend
 
 
 ## Installation
-### Using [Poetry](https://python-poetry.org) (Recommended)
+> Python 3.12 is not supported until [PyTorch]supports it
+
+### Using [Poetry] (Recommended)
 ```bash
 poetry add pfund
+
+# update to the latest version:
+poetry update pfund
 ```
 
 
 ### Using Pip
 ```bash
 pip install pfund
+
+# install the latest version:
+pip install -U pfund
+```
+
+
+### Checking your installation
+```bash
+$ pfund --version
+
+pfund, version 0.0.1.dev4
 ```
 
 
@@ -105,10 +141,18 @@ class YourStrategy(pf.Strategy):
         # write your trading logic here
         pass
 
-engine = pf.BacktestEngine(...)
-strategy = engine.add_strategy(YourStrategy())
-strategy.add_data(...)
-strategy.add_model(...)
+
+engine = pf.BacktestEngine(mode='vectorized')
+strategy = engine.add_strategy(YourStrategy(), name='your_strategy')
+strategy.add_data(
+  'IB', 'AAPL', 'USD', 'STK', resolutions=['1d'],
+  backtest={
+    # NOTE: since IB does not provide any historical data for backtesting purpose, use data from 'YAHOO_FINANCE'
+    'data_source': 'YAHOO_FINANCE',
+    'start_date': '2024-01-01',
+    'end_date': '2024-02-01',
+  }
+)
 engine.run()
 ```
 
@@ -119,9 +163,17 @@ engine.run()
 import pfund as pf
 
 engine = pf.TradeEngine(env='LIVE')
-strategy = engine.add_strategy(YourStrategy())
-strategy.add_data(...)
-strategy.add_model(...)
+strategy = engine.add_strategy(YourStrategy(), name='your_strategy')
+strategy.add_data(
+  'IB', 'AAPL', 'USD', 'STK', resolutions=['1d'],
+  # for convenience, you can keep the kwarg `backtest`, `TradeEngine` will ignore it
+  backtest={
+    # NOTE: since IB does not provide any historical data for backtesting purpose, use data from 'YAHOO_FINANCE'
+    'data_source': 'YAHOO_FINANCE',
+    'start_date': '2024-01-01',
+    'end_date': '2024-02-01',
+  }
+)
 engine.run()
 ```
 
@@ -159,28 +211,29 @@ engine.run()
 ## Model Hub
 Imagine a space where algo-traders can share their machine learning models with one another.
 Strategy and model development could be so much faster since you can build on top of an existing working model.
-> Model Hub is coming soon in [PFund.ai](https://pfund.ai), Stay Tuned!
+> Model Hub is coming soon on [PFund.ai], Stay Tuned!
 
 
 ## Supported Trading Venues
-| Trading Venue                   | Vectorized Backtesting | Event-Driven Backtesting | Paper Trading | Live Trading |
-| ------------------------------- | ---------------------- | ------------------------ | ------------- | ------------ |
-| Bybit                           | 🟢                     | 🟡                       | 🟡            | 🟡           |
-| *Interactive Brokers (IB)       | 🟡                     | 🟡                       | 🟡            | 🟡           |
-| Binance                         | 🔴                     | 🔴                       | 🔴            | 🔴           |
-| OKX                             | 🔴                     | 🔴                       | 🔴            | 🔴           |
-| *Alpaca                         | 🔴                     | 🔴                       | 🔴            | 🔴           |
-| *[Futu](https://www.futunn.com) | 🔴                     | 🔴                       | 🔴            | 🔴           |
-| dYdX                            | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| Trading Venue             | Vectorized Backtesting | Event-Driven Backtesting | Paper Trading | Live Trading |
+| ------------------------- | ---------------------- | ------------------------ | ------------- | ------------ |
+| Bybit                     | 🟢                     | 🟡                       | 🟡            | 🟡           |
+| *Interactive Brokers (IB) | 🟡                     | 🟡                       | 🟡            | 🟡           |
+| Binance                   | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| OKX                       | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| *Alpaca                   | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| *[Futu]                   | 🔴                     | 🔴                       | 🔴            | 🔴           |
+| dYdX                      | 🔴                     | 🔴                       | 🔴            | 🔴           |
 
 🟢 = finished \
 🟡 = in progress \
 🔴 = todo \
-\* = use a **_separate data source_** (e.g. [FirstRate Data](https://firstratedata.com)) for backtesting
+\* = use a **_separate data source_** (e.g. [FirstRate Data]) for backtesting
 
 
 ## Related Projects
-- [PFeed](https://github.com/PFund-Software-Ltd/pfeed) — Data pipeline for algo-trading, helping traders in getting real-time and historical data, and storing them in a local data lake for quantitative research.
+- [PFeed] — Data pipeline for algo-trading, helping traders in getting real-time and historical data, and storing them in a local data lake for quantitative research.
+- [PyTrade.org] - A curated list of Python libraries and resources for algorithmic trading.
 
 
 ## Disclaimer
@@ -188,4 +241,4 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 This algo-trading framework is intended for educational and research purposes only. It should not be used for real trading without understanding the risks involved. Trading in financial markets involves significant risk, and there is always the potential for loss. Your trading results may vary. No representation is being made that any account will or is likely to achieve profits or losses similar to those discussed on this platform.
 
-The developers of this framework are not responsible for any financial losses incurred from using this software. Users should conduct their due diligence and consult with a professional financial advisor before engaging in real trading activities.
+The developers of this framework are not responsible for any financial losses incurred from using this software. Users should conduct their due diligence and consult with a professional financial advisor before engaging in real trading activities.

pfund-0.0.1.dev5/pfund/CONTRIBUTING.md

@@ -0,0 +1,16 @@
+## Installation
+```bash
+poetry add pfund --with dev,doc
+```
+
+## Build Documentation using [jupyterbook](https://jupyterbook.org/)
+```bash
+# at the root directory, run:
+jb build docs/ [--all]
+```
+
+## Update submodules
+```bash
+# run this to see if the version a submodule is using has been changed.
+git submodule update
+```

{pfund-0.0.1.dev3 → pfund-0.0.1.dev5}/pfund/__init__.py

@@ -1,7 +1,14 @@
+import sys
+from importlib.metadata import version
+
+from pfund.const.paths import PROJ_PATH
+# add python path so that for files like "ibapi" (official python code from IB) can find their modules
+sys.path.append(f'{PROJ_PATH}/externals')
 from pfund.config_handler import configure
 from pfund.engines import BacktestEngine, TrainEngine, TestEngine, TradeEngine
 from pfund.strategies import Strategy
 from pfund.models import Feature, Model
+from pfund.utils.aliases import ALIASES
 try:
     from pfund.models import PyTorchModel
 except ImportError:
@@ -11,7 +18,6 @@ try:
 except ImportError:
     pass
 from pfund.indicators import TAIndicator, TALibIndicator
-from importlib.metadata import version
 
 
 __version__ = version('pfund')
@@ -19,8 +25,8 @@ __version__ = version('pfund')
 
 __all__ = (
     '__version__',
-    'configure',
+    'configure', 'ALIASES',
     'BacktestEngine', 'TrainEngine', 'TestEngine', 'TradeEngine',
     'Strategy', 'Model', 'PyTorchModel', 'SKLearnModel',
     'Feature', 'TAIndicator', 'TALibIndicator',
-)
+)

{pfund-0.0.1.dev3 → pfund-0.0.1.dev5}/pfund/adapter.py

@@ -25,7 +25,7 @@ class Adapter:
         return pdt
 
     def load_pdt_matchings(self):
-        file_path = f'{PROJ_CONFIG_PATH}/{self._trading_venue}'
+        file_path = f'{PROJ_CONFIG_PATH}/{self._trading_venue.lower()}'
         config_name = 'pdt_matchings'
         for file_name in os.listdir(file_path):
             if not file_name.startswith(config_name):

{pfund-0.0.1.dev3 → pfund-0.0.1.dev5}/pfund/cli/commands/config.py

@@ -9,15 +9,10 @@ from pfund.const.paths import USER_CONFIG_FILE_PATH
 from pfund.config_handler import ConfigHandler
 
 
-def load_config(config_file_path: str | Path):
-    config_file_path = Path(config_file_path)
-    if config_file_path.is_file():
-        with open(config_file_path, 'r') as f:
-            return yaml.safe_load(f) or {}
-    return {}
-
-
 def save_config(config: ConfigHandler, config_file_path: str | Path):
+    if type(config_file_path) is str:
+        config_file_path = Path(config_file_path)
+    config_file_path.parent.mkdir(parents=True, exist_ok=True)
     with open(config_file_path, 'w') as f:
         yaml.dump(config.__dict__, f, default_flow_style=False)
         
@@ -48,14 +43,16 @@ def config(ctx, **kwargs):
     if kwargs.get('list'):  # Check if --list was used
         del provided_options['list']
         assert not provided_options, "No options should be provided with --list"
-        click.echo(f"PFund's config:\n{pformat(config.__dict__)}")
+        config_dict = config.__dict__
+        config_dict.update({'config_file_path': USER_CONFIG_FILE_PATH})
+        click.echo(f"PFund's config:\n{pformat(config_dict)}")
         return
 
     if kwargs.get('reset'): # Check if --reset was used
         del provided_options['reset']
         assert not provided_options, "No options should be provided with --reset"
         remove_config(USER_CONFIG_FILE_PATH)
-        click.echo("PFund;s config successfully reset.")
+        click.echo("PFund's config successfully reset.")
         return
     
     # prints out current config if no options are provided

{pfund-0.0.1.dev3 → pfund-0.0.1.dev5}/pfund/cli/commands/docker_compose.py

@@ -18,9 +18,11 @@ from pfund.const.paths import PROJ_NAME
 def docker_compose(ctx, env_file_path, docker_file_path):
     """Forwards commands to docker-compose with the package's docker-compose.yml file if not specified."""
     if not env_file_path:
-        env_file_path = find_dotenv(usecwd=True, raise_error_if_not_found=True)
-        click.echo(f'.env file path is not specified, using env file in "{env_file_path}"')
-    load_dotenv(env_file_path)
+        if env_file_path := find_dotenv(usecwd=True, raise_error_if_not_found=False):
+            click.echo(f'.env file path is not specified, using env file in "{env_file_path}"')
+        else:
+            click.echo('.env file is not found')
+    load_dotenv(env_file_path, override=True)
     if not docker_file_path:
         package_dir = Path(importlib.resources.files(PROJ_NAME)).resolve().parents[0]
         docker_file_path = package_dir / 'docker-compose.yml'

{pfund-0.0.1.dev3 → pfund-0.0.1.dev5}/pfund/cli/main.py

@@ -1,9 +1,8 @@
 import click
 
 from pfund.config_handler import ConfigHandler
-from pfund.const.paths import USER_CONFIG_FILE_PATH
 from pfund.cli.commands.docker_compose import docker_compose
-from pfund.cli.commands.config import config, load_config
+from pfund.cli.commands.config import config
 
 
 @click.group(context_settings={"help_option_names": ["-h", "--help"]})
@@ -12,8 +11,7 @@ from pfund.cli.commands.config import config, load_config
 def pfund_group(ctx):
     """pfund's CLI"""
     ctx.ensure_object(dict)
-    config: dict = load_config(USER_CONFIG_FILE_PATH)
-    ctx.obj['config'] = ConfigHandler(**config)
+    ctx.obj['config'] = ConfigHandler.load_config()
 
 
 pfund_group.add_command(docker_compose)

{pfund-0.0.1.dev3 → pfund-0.0.1.dev5}/pfund/config/bybit/config.yml

@@ -65,7 +65,7 @@ adapter:
     CF--: 'Filled'
     C-C-: 'Cancelled'
   offset: {}
-  px_directions: {
+  price_directions: {
     # internal definitions:
     # PlusTick: ...,
     # ZeroPlusTick: ...,

{pfund-0.0.1.dev3 → pfund-0.0.1.dev5}/pfund/config_handler.py

@@ -6,12 +6,10 @@ import logging
 from types import TracebackType
 from dataclasses import dataclass
 
+import yaml
 # from rich.traceback import install
 
-from pfund.const.paths import PROJ_NAME, PROJ_PATH, LOG_PATH, PROJ_CONFIG_PATH, DATA_PATH
-# add python path so that for files like "ibapi" (official python code from IB)
-# can find their modules
-sys.path.append(f'{PROJ_PATH}/externals')
+from pfund.const.paths import PROJ_NAME, LOG_PATH, PROJ_CONFIG_PATH, DATA_PATH, USER_CONFIG_FILE_PATH
 
 # install(show_locals=False)  # rich will set its own sys.excepthook
 # rich_excepthook = sys.excepthook  # get rich's excepthook
@@ -50,19 +48,29 @@ def import_strategies_models_features_or_indicators(path: str):
 
 @dataclass
 class ConfigHandler:
-    data_path: str = str(DATA_PATH),
+    data_path: str = str(DATA_PATH)
     log_path: str = str(LOG_PATH)
     logging_config_file_path: str = f'{PROJ_CONFIG_PATH}/logging.yml'
     logging_config: dict | None = None
     use_fork_process: bool = True
     use_custom_excepthook: bool = True
     
+    @classmethod
+    def load_config(cls):
+        config_file_path = USER_CONFIG_FILE_PATH
+        if config_file_path.is_file():
+            with open(config_file_path, 'r') as f:
+                config = yaml.safe_load(f) or {}
+        else:
+            config = {}
+        return cls(**config)
+    
     def __post_init__(self):
         self.logging_config = self.logging_config or {}
         
         strategy_path, model_path = f'{self.data_path}/strategies', f'{self.data_path}/models'
         feature_path, indicator_path = f'{self.data_path}/features', f'{self.data_path}/indicators'
-        for path in (strategy_path, model_path, feature_path, indicator_path):
+        for path in [strategy_path, model_path, feature_path, indicator_path]:
             if not os.path.exists(path):
                 os.makedirs(path)
                 print(f'created {path}')
@@ -74,7 +82,7 @@ class ConfigHandler:
         
         if self.use_custom_excepthook:
             sys.excepthook = _custom_excepthook
-            
+    
 
 def configure(
     data_path: str = str(DATA_PATH),