← all repositories
AI4Finance-Foundation/FinRL

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.

15.8k stars Jupyter Notebook Domain AppsAgents
FinRL
Velocity · 7d
+7.4
★ / day
Trend
cooling
star history

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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.