qlib

[![Python Versions](https://img.shields.io/pypi/pyversions/pyqlib.svg?logo=python&logoColor=white)](https://pypi.org/project/pyqlib/#files)
[![Platform](https://img.shields.io/badge/platform-linux%20%7C%20windows%20%7C%20macos-lightgrey)](https://pypi.org/project/pyqlib/#files)
[![PypI Versions](https://img.shields.io/pypi/v/pyqlib)](https://pypi.org/project/pyqlib/#history)
[![Upload Python Package](https://github.com/microsoft/qlib/workflows/Upload%20Python%20Package/badge.svg)](https://pypi.org/project/pyqlib/)
[![Github Actions Test Status](https://github.com/microsoft/qlib/workflows/Test/badge.svg?branch=main)](https://github.com/microsoft/qlib/actions)
[![Documentation Status](https://readthedocs.org/projects/qlib/badge/?version=latest)](https://qlib.readthedocs.io/en/latest/?badge=latest)
[![License](https://img.shields.io/pypi/l/pyqlib)](LICENSE)
[![Join the chat at https://gitter.im/Microsoft/qlib](https://badges.gitter.im/Microsoft/qlib.svg)](https://gitter.im/Microsoft/qlib?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

## Unreleased breaking change: artifact loading

New source builds introduce a **backward-incompatible safety default**: recorder
loads are restricted. If you reload saved models/datasets, resume online or delayed
training, or use DDG-DA, verify the artifact writer and storage permissions before
opting in with `trusted=True` (CLI: `--trusted=True`). Fresh in-memory training and
supported data-only reads need no opt-in. HIST mappings and high-frequency cache
paths also have migration requirements.

Follow the [artifact loading migration guide](https://qlib.readthedocs.io/en/latest/start/artifact_migration.html)
before upgrading. Merging into `main` affects source installs before a new PyPI
release; this change remains **unreleased until the first tagged release containing
it**. That release's versioned upgrade notes should link to the same guide.

> **Upgrading configuration-driven workflows?** See the
> [configuration migration guide](docs/start/config_migration.rst) for the
> unreleased source changes: per-component `trusted: true` for local `.py`
> imports, restricted expressions, and explicit extension mappings. Package
> imports remain available. Match this guide to your checkout; PR source,
> `main`, and tagged/PyPI releases may differ.

## :newspaper: **What's NEW!**     :sparkling_heart: 

Recent released features

### Introducing <a href="https://github.com/microsoft/RD-Agent"><img src="docs/_static/img/rdagent_logo.png" alt="RD_Agent" style="height: 2em"></a>: LLM-Based Autonomous Evolving Agents for Industrial Data-Driven R&D

We are excited to announce the release of **RD-Agent**📢, a powerful tool that supports automated factor mining and model optimization in quant investment R&D.

RD-Agent is now available on [GitHub](https://github.com/microsoft/RD-Agent), and we welcome your star🌟!

To learn more, please visit the [RD-Agent repository](https://github.com/microsoft/RD-Agen