Deep reinforcement learning’s first open-source trading desk
It gives researchers and students a complete, open-source playground for training deep reinforcement learning agents on financial markets.

What it does
FinRL organizes financial reinforcement learning into three layers: market environments, DRL agents, and financial applications. It offers a train-test-trade pipeline that feeds preprocessed market data—complete with technical indicators like MACD, RSI, VIX, and turbulence indices—to agents implemented via Stable Baselines 3, ElegantRL, or RLlib. Out-of-the-box applications cover stock trading, portfolio allocation, cryptocurrency, and high-frequency strategies.
The interesting bit
The README’s most unusual feature is its honesty: maintainers explicitly brand this as the “classic” educational stack and repeatedly steer new users toward FinRL-X / FinRL-Trading, their decoupled, production-oriented successor. For a project with 15.5k stars, it is refreshingly direct about its own obsolescence for production use.
Key highlights
- Widely recognized as the first open-source framework dedicated to financial reinforcement learning.
- Supports a broad set of data sources, including Yahoo Finance, Alpaca, Binance, CCXT, IEX Cloud, and multiple Asian market providers.
- Bundles reference implementations for stock trading, portfolio allocation, crypto trading, and imitation learning.
- Includes unit tests for environments and data downloaders to verify behavior.
Caveats
- The maintainers recommend FinRL-X / FinRL-Trading for modern or production-oriented systems; this repository is preserved for education and research prototyping.
- Live trading support is limited to basic Alpaca integration, and risk management is confined to Gym environment constraints rather than strategy-level controls.
- Configuration is handled through static Python files (
config.py,config_tickers.py) rather than more modern type-safe settings.
Verdict
A solid starting point for academics and students who need a canonical, well-cited baseline for financial DRL experiments. If you are building anything that might touch real money, the maintainers themselves suggest looking at FinRL-X instead.
Frequently asked
- What is AI4Finance-Foundation/FinRL?
- It gives researchers and students a complete, open-source playground for training deep reinforcement learning agents on financial markets.
- Is FinRL open source?
- Yes — AI4Finance-Foundation/FinRL is open source, released under the MIT license.
- What language is FinRL written in?
- AI4Finance-Foundation/FinRL is primarily written in Jupyter Notebook.
- How popular is FinRL?
- AI4Finance-Foundation/FinRL has 15.8k stars on GitHub and is currently cooling off.
- Where can I find FinRL?
- AI4Finance-Foundation/FinRL is on GitHub at https://github.com/AI4Finance-Foundation/FinRL.