Metadata-Version: 2.4
Name: roboquant
Version: 1.6.3
Summary: A fast algo-trading platform with support for AI based strategies
Project-URL: Homepage, https://roboquant.org
Project-URL: Repository, https://github.com/neurallayer/roboquant.py.git
Project-URL: Issues, https://github.com/neurallayer/roboquant.py/issues
Author-email: roboquant team <info@roboquant.org>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: AI,crypto,exchange,finance,forex,investment,machine learning,stocks,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: <3.13,>=3.11
Requires-Dist: numpy>=1.26.4
Requires-Dist: python-ibapi-stable
Requires-Dist: requests>=2.32.0
Requires-Dist: websocket-client~=1.8.0
Requires-Dist: yfinance~=0.2.55
Provides-Extra: alpaca
Requires-Dist: alpaca-py>=0.39.0; extra == 'alpaca'
Provides-Extra: avro
Requires-Dist: fastavro>=1.9.7; extra == 'avro'
Provides-Extra: ibkr
Requires-Dist: ibind[oauth]>=0.1.13; extra == 'ibkr'
Provides-Extra: parquet
Requires-Dist: pyarrow>=19.0.0; extra == 'parquet'
Provides-Extra: torch
Requires-Dist: sb3-contrib>=2.5.0; extra == 'torch'
Requires-Dist: stable-baselines3[extra]>=2.5.0; extra == 'torch'
Requires-Dist: tensorboard>=2.19.0; extra == 'torch'
Requires-Dist: torch>=2.6.0; extra == 'torch'
Description-Content-Type: text/markdown


# ![roboquant logo](https://github.com/neurallayer/roboquant.py/raw/main/docs/roboquant_header.png)

![PyPI - Version](https://img.shields.io/pypi/v/roboquant)
![PyPI - License](https://img.shields.io/pypi/l/roboquant)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/roboquant)
![PyPI - Status](https://img.shields.io/pypi/status/roboquant)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/neurallayer/roboquant.py/python-package.yml)
[![discord](https://img.shields.io/discord/954650958300856340?label=discord)](https://discord.com/channels/954650958300856340/954650958300856343)

Roboquant is an open-source algorithmic trading platform. It is flexible, user-friendly and completely free to use. It is designed for anyone serious about algo-trading. 

So whether you are a beginning retail trader or an established trading firm, roboquant can help you to develop robust and fully automated trading strategies. You can find out more at [roboquant.org](https://roboquant.org).

## Usage
The following code snippet shows the steps required to run a full back-test on a number of stocks.

```python
import roboquant as rq

feed = rq.feeds.YahooFeed("JPM", "IBM", "F", "TSLA")
strategy = rq.strategies.EMACrossover()
account = rq.run(feed, strategy)
print(account)
```

## Install
Roboquant can be installed like most other Python packages, using pip or conda.
Make sure you have Python version 3.11 or higher installed.

```shell
python3 -m pip install --upgrade roboquant
```
If you don't want to install anything locally, you can try out roboquant in an online Jupyter environment like
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/neurallayer/roboquant-interactive/blob/main/intro_roboquant.ipynb)

The core of roboquant limits the number of dependencies. 
But you can install roboquant including one or more of the optional dependencies if you require certain functionality:

```shell
# PyTorch based strategies using RNNStrategy
python3 -m pip install --upgrade "roboquant[torch]"

# Integration with Interactive Brokers using IBKRBroker
python3 -m pip install --upgrade "roboquant[ibkr]"

# Integration with Alpaca
python3 -m pip install --upgrade "roboquant[alpaca]"

# Install Avro feed dependencies
python3 -m pip install --upgrade "roboquant[avro]"

# Install Avro feed dependencies
python3 -m pip install --upgrade "roboquant[parquet]"
```

## Building from source
Roboquant.py uses `uv` as the main tool for handling package dependencies.


```shell
uv sync --all-extras --dev
```

You should now be in the virtual environment and ready to build/install roboquant:

```shell
uv build
uv pip install .
```

Some other useful commands:

```shell
# run the unit tests
uv run python -m unittest discover -s tests/unit 

# validate the code
uvx ruff check

# publish, only works if UV_PUBLISH_TOKEN is set
uv publish 
```

## License
Roboquant is made available under the Apache 2.0 license. You can read more about the Apache 2.0 license on this page: https://www.apache.org/licenses/LICENSE-2.0.html

## Disclaimer
Absolutely no warranty is implied with this product. Use at your own risk. I provide no guarantee that it will be profitable, or that it won't lose all your money very quickly or does not contain bugs.

All financial trading offers the possibility of loss. Leveraged trading, may result in you losing all your money, and still owing more. Back tested results are no guarantee of future performance. I can take no responsibility for any losses caused by live trading using roboquant. Use at your own risk. I am not registered or authorised by any financial regulator.

## Kotlin version
Next to this Python version of `roboquant`, there is also a Kotlin version available. Both share a similar API, just the used computer language is different. Which one to use depends very much on personal preferences, skills and usage.
