mlquant
A reproducible PyTorch research stack for machine-learning multi-factor trading: 213 factors, bias correction, portfolio optimization, and vectorized backtesting.
Install and run
python -m pip install mlquantx
mlquant demo
The demo needs no market-data account or API key. It runs the deterministic synthetic pipeline from data generation through 213 factor dimensions, model training, portfolio construction, cost-aware backtesting, and Markdown/JSON report generation. The default config ships inside the wheel, so the command works outside a repository checkout.
What is included
- 204 hand-crafted factors plus 9 curated Alpha101-style factors
- mask-aware PyTorch tensor primitives for cross-sectional panels
- limit-up, limit-down, halt, and missing-data bias handling
- MLP and Transformer research baselines
- constrained Markowitz portfolio construction
- vectorized backtesting with turnover and transaction costs
- AkShare, Baostock, yfinance, and deterministic synthetic data paths
- auditable public-data validation reports, including negative results
Start here
- Source and full documentation
- Google Colab quick start
- Public validation dashboard
- Research card and limitations
- 100,000-row synthetic dataset
- 213-input MLP checkpoint
- Paper: arXiv:2507.07107
Research boundary
mlquant is research and educational software. It is not investment advice or
a production trading system. Synthetic smoke tests verify engineering behavior,
not profitability. Public-data backtests depend on data quality, survivorship,
transaction costs, slippage, and modeling assumptions and do not represent live
or guaranteed out-of-sample performance.
License
MIT. See the repository license.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mlquantx-0.2.5.tar.gz.
File metadata
- Download URL: mlquantx-0.2.5.tar.gz
- Upload date:
- Size: 84.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f106bb912d87141d0e22a1ad1a3b3f0efdb095302c3d04750672a9d66cdc93c
|
|
| MD5 |
e76d06235ddc61d293c410cef4bdaacc
|
|
| BLAKE2b-256 |
9c8a4ccdb025287171bfef16f70fb87c1dbc923f3b90e9b969fdcaeeb537e274
|
Provenance
The following attestation bundles were made for mlquantx-0.2.5.tar.gz:
Publisher:
publish-pypi.yml on initial-d/ml-quant-trading
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mlquantx-0.2.5.tar.gz -
Subject digest:
7f106bb912d87141d0e22a1ad1a3b3f0efdb095302c3d04750672a9d66cdc93c - Sigstore transparency entry: 2387489862
- Sigstore integration time:
-
Permalink:
initial-d/ml-quant-trading@f157cc8203b8a9b14d0469813c297aa32e7fe107 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/initial-d
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@f157cc8203b8a9b14d0469813c297aa32e7fe107 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file mlquantx-0.2.5-py3-none-any.whl.
File metadata
- Download URL: mlquantx-0.2.5-py3-none-any.whl
- Upload date:
- Size: 78.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
78b4783453c1edcf874319eedcf8a7246020e36c55e9845ffbecdb630fe99412
|
|
| MD5 |
03dd0cef54a19a0bb9fcd28913d92afd
|
|
| BLAKE2b-256 |
b28fa96ec4979a7daa47c11ac9d579005a9cd13ea14e864e8c6207341b5eafcd
|
Provenance
The following attestation bundles were made for mlquantx-0.2.5-py3-none-any.whl:
Publisher:
publish-pypi.yml on initial-d/ml-quant-trading
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mlquantx-0.2.5-py3-none-any.whl -
Subject digest:
78b4783453c1edcf874319eedcf8a7246020e36c55e9845ffbecdb630fe99412 - Sigstore transparency entry: 2387489873
- Sigstore integration time:
-
Permalink:
initial-d/ml-quant-trading@f157cc8203b8a9b14d0469813c297aa32e7fe107 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/initial-d
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@f157cc8203b8a9b14d0469813c297aa32e7fe107 -
Trigger Event:
workflow_dispatch
-
Statement type:
