7d7c267d29
docs: rewrite README — Numba loop, Optuna, ML, zero-LLM strategy discovery
2026-05-31 17:25:43 +02:00
8806b12ad6
docs: remove closed-source live trader reference from README
2026-05-25 12:16:04 +02:00
61e6a09b95
docs: remove forex-specific language from README
...
- Framework is instrument-agnostic, not EUR/USD-specific
- Trading strategies are closed-source — repo contains research framework only
- Clarify open-source scope: factor generation, model evolution, backtesting engine
- Update data setup examples to use generic symbol names
2026-05-25 12:14:36 +02:00
630794e00c
docs: fix script paths in README after rename
2026-05-09 22:43:55 +02:00
cbe1c52e00
refactor: rename project from Predix to NexQuant
...
Rename all source files, scripts, tests, documentation, and configuration
from Predix/predix to NexQuant/nexquant across the entire codebase.
2026-05-09 17:48:22 +02:00
85b56b8179
docs: update README — Kronos-small, test depth, daemon setup, project structure
...
- Kronos: auto-integrated into fin_quant, 3 horizons, model size table
- Tests: 1125+ collected (was 134), property-based + fuzzing
- CLI: updated commands, removed outdated Kronos commands
- llama-server: reduced to 18 GPU layers for Kronos co-existence
- Daemon setup: auto-restart commands for fin_quant, autopilot, live trader
- Project structure: scripts/, test/ details, current architecture
2026-05-09 09:39:06 +02:00
7696a3aaa6
docs: update license section from MIT to AGPL-3.0
2026-05-03 21:20:41 +02:00
6d37f8956f
feat: add runtime backtest verification (10 invariant checks in <1ms) + 489 tests + README docs
2026-05-03 14:00:49 +02:00
4a6178f53a
perf(kronos): batch GPU inference via predict_batch — 75x faster
...
Replace sequential predict() calls with predict_batch() in both
build_kronos_factor and evaluate_kronos_model. Up to batch_size windows
are processed simultaneously on GPU, reducing per-window time from ~10s
to ~0.13s (measured: 10 windows in 1.3s on RTX 5060 Ti).
Adds --batch-size / -b option (default 32) to both kronos-factor and
kronos-eval CLI commands. Falls back to single inference per window if
a batch fails. Refactors timestamp preparation into _build_window_inputs.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-18 12:04:44 +02:00
3f460226f2
feat: add Kronos CLI commands, expand tests, document in README
...
- predix kronos-factor: generate KronosPredReturn alpha factor via CLI
- predix kronos-eval: evaluate Kronos IC/hit-rate vs LightGBM via CLI
- 19 tests covering adapter, factor builder, model evaluator, CLI (mock-based)
- README: Kronos section in Features + CLI commands table
- Total test suite: 153 passed
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-18 09:53:56 +02:00
38cf4bc63e
docs: fix duplicate sections, add hardware requirements and data setup guide
...
- Remove duplicate Configuration and CLI Commands sections
- Add System Requirements table (GPU VRAM, RAM, CUDA)
- Expand Data Setup with concrete step-by-step instructions
- Add prerequisites checklist to Quick Start (Docker, data, LLM health)
- Consolidate all CLI commands into one section
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-18 09:16:02 +02:00
6dfbf148ed
docs: improve README badges, fix llama-server flags, clean up structure
...
- Fix CI badge branch main→master
- Add Security scan and Conventional Commits badges
- Fix llama-server flags: --parallel 2, --reasoning off (not --reasoning-budget 0)
- Remove duplicate Configuration section
- Add predix best command to CLI table
- Update Contributing section to use Conventional Commits format
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-18 08:50:59 +02:00
22e638af86
feat: unified backtest engine, LLM error handling, strategy refactor
...
- Add vbt_backtest.py as single source of truth for all metric formulas
(Sharpe, drawdown, IC, transaction costs) — backtest_engine.py and
strategy_orchestrator.py now delegate to it
- Add LLMUnavailableError to exception.py; rd_loop.py catches it at the
proposal stage and raises LoopResumeError to avoid corrupting trace
history with None hypotheses
- Guard record() against None exp/hypothesis so loop resets leave
trace.hist in a consistent state
- Refactor strategy_orchestrator and optuna_optimizer to use unified
backtest path; remove duplicate metric calculation code
- Add predix_rebacktest_unified.py script for offline re-evaluation
- Update tests and README
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-17 22:52:07 +02:00
2cec08bc91
feat: add daily log rotation, llama health wait, factor auto-fixer, and README updates
...
- Add rdagent/log/daily_log.py: daily-rotating structured logs per command
(fin_quant, strategies, evaluate, parallel) with loguru; all.log combined sink
- predix.py: route TeeWriter output to logs/YYYY-MM-DD/ instead of root dir;
wrap quant() and evaluate() in daily_log.session() for start/stop/duration tracking
- rdagent/app/cli.py: fin_quant_cli waits for llama.cpp /health endpoint before
starting pipeline (up to 300 s); daily_log integration for fin_quant,
generate_strategies, eval_all, parallel commands
- scripts/predix_gen_strategies_real_bt.py: daily_log integration with
per-strategy ACCEPTED/REJECTED entries and summary on completion
- rdagent/components/coder/factor_coder/auto_fixer.py: new module that patches
common LLM-generated factor issues (min_periods, inf/NaN, groupby.transform,
MultiIndex corrections)
- rdagent/components/coder/factor_coder/prompts.yaml: add critical rules for
EURUSD 1-min intraday factors (min_periods, inf handling, groupby, date range)
- README.md: document --reasoning off and --n-gpu-layers 28 for llama-server;
explain VRAM constraints when Ollama is running alongside llama.cpp
- .bandit.yml: suppress B615 (HuggingFace unsafe download) for RL benchmark files
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-16 07:20:08 +02:00
b98c9cd572
feat: Add GitHub infrastructure, CI/CD pipelines, and examples
...
- Add GitHub issue templates (bug, feature, docs)
- Add pull request template with closed-source checklist
- Add CODEOWNERS for code review assignment
- Add CI/CD workflows (ci, lint, security, docs, release)
- pytest + coverage with Python 3.10/3.11 matrix
- Ruff + MyPy code quality checks
- Bandit + safety security scanning
- Sphinx docs + GitHub Pages deployment
- Automated PyPI releases on tag push
- Add 6 comprehensive examples + Jupyter quickstart
- 01_factor_discovery.py (LLM factor generation)
- 02_factor_evolution.py (factor optimization)
- 03_strategy_generation.py (IC-weighted combination)
- 04_backtest_simple.py (strategy backtesting)
- 05_model_training.py (XGBoost/LSTM training)
- 06_rl_trading_agent.py (PPO/DQN/A2C agents)
- notebooks/quickstart.ipynb (interactive tutorial)
- Restructure .gitignore with explicit closed-source sections
- Add CI/coverage/license badges to README
- Complete CLI docstrings for all 9 commands
- Add data_config.yaml for quant loop configuration
2026-04-11 21:40:18 +02:00
53afed001e
docs: Add comprehensive data setup guide to README
...
Added OHLCV data requirements documentation:
- Required HDF5 format (MultiIndex, columns, dtypes)
- Data sources (Dukascopy, OANDA, TrueFX, Kaggle, MT5)
- CSV to HDF5 conversion script
- Save location instructions
2026-04-10 13:29:58 +02:00
cc8023ce48
docs: Add conda requirement to README + fix predix CLI
...
- README now requires conda (Miniconda/Anaconda)
- Clear installation instructions for 'predix' environment
- Fixed 'predix' CLI command to show welcome screen directly
2026-04-10 12:59:37 +02:00
4a3a3c8f24
docs: Add CLI welcome screenshot to README
...
Added beautiful CLI dashboard screenshot showing:
- System status (factors, strategies, security)
- Available commands
- Quick start guide
Renamed from German filename to cli-welcome-screen.png
2026-04-10 12:43:43 +02:00
dbc8603e73
docs: Add professional badges to README header
...
Tech Stack Badges:
- Python 3.10 | 3.11
- Platform: Linux
- PyTorch 2.0+
- Optuna 3.5+
- Pandas
- LightGBM
- Qlib
- llama.cpp
Status Badges:
- License (MIT)
- Ruff (code quality)
- Stars
- Forks
- Issues
- Pull Requests
- Last Commit
- Contributors
2026-04-09 15:40:36 +02:00
d6722e46f0
fix: Update LICENSE badge link from main to master branch
...
The LICENSE badge was linking to /blob/main/LICENSE but the default
branch is master. This caused the badge to show as invalid on GitHub.
2026-04-09 15:25:05 +02:00
360bd26d4f
feat: Strategy performance reports, CLI docs, and README update
...
New files:
- predix_strategy_report.py: Performance report generator with charts
* Dashboard (equity, drawdown, signals, monthly returns, metrics)
* Individual PNG charts per strategy
* Text report with full metrics
* Auto-generated after each accepted strategy
- debug_backtest.py: Debug script for backtest alignment & IC check
Updated:
- predix_gen_strategies_real_bt.py: Auto-generate report per strategy
- README.md: Full CLI commands reference (all predix commands)
- QWEN.md: Architecture update, CLI commands, env variables
Key fixes already committed:
- 96-bar forward returns (matching factor IC horizon)
- LogColors disabled when not TTY (NO_COLOR support)
- litellm 'Provider List' as info, not warning
- QuantTrace controller initialization fix
- LogColors TTY detection
2026-04-07 09:12:04 +02:00
5ce86c824e
feat: Full system integration - RL + Protections + Backtesting + CLI
...
Connect all Predix components into unified trading system:
INTEGRATION (ALL 295 TESTS PASS):
- RL Trading connected with Protection Manager
- RL Trading connected with Backtesting Engine
- CLI command 'rdagent rl_trading' added (train/backtest/live modes)
- Graceful fallback for users without stable-baselines3
OPEN SOURCE COMPATIBILITY:
- System works WITHOUT stable-baselines3 (momentum fallback)
- System works WITHOUT local models/prompts (uses standard)
- Clear warning messages when optional deps missing
- GitHub users get FULLY WORKING system
CLOSED SOURCE PROTECTION:
- models/local/, prompts/local/, .env stay local only
- .gitignore properly configured
- Our alpha (best models/prompts) remains private
DOCUMENTATION:
- QWEN.md: Open/closed source strategy
- QWEN.md: Development guidelines for AI assistant
- QWEN.md: Open source compatibility principle
- README.md: RL Trading CLI commands and examples
- requirements/rl.txt: Optional RL dependencies
Modified files:
- rdagent/app/cli.py: Added rl_trading command
- rdagent/components/backtesting/backtest_engine.py: RL backtest support
- rdagent/components/coder/rl/costeer.py: Protection Manager integration
- rdagent/components/coder/rl/__init__.py: Conditional imports + fallback
- rdagent/components/coder/rl/fallback.py: NEW - Simple momentum fallback
- requirements.txt: Optional RL deps commented
- requirements/rl.txt: NEW - Full RL dependencies
- test/integration/test_all_features.py: 7 new integration tests
- QWEN.md: Open source strategy + development guidelines
- README.md: RL Trading documentation
295 tests pass: 67 integration + 89 RL + 139 backtesting
2026-04-03 13:53:32 +02:00
bd025e50dc
feat: Add Trading Protection System with 4 protections + comprehensive tests
...
Implement automatic trading protection system to prevent excessive losses:
PROTECTIONS (100% original code, NOT copied from Freqtrade):
- Max Drawdown Protection: Blocks trading when DD > 15% (configurable)
- Cooldown Period: 4h mandatory rest after 5% loss
- Stoploss Guard: Detects stoploss clusters (>5 per day)
- Low Performance Filter: Filters factors with Sharpe < 0.5, Win Rate < 40%
ARCHITECTURE:
- Base protection interface with common utilities
- 4 specialized protection implementations
- ProtectionManager orchestrates all active protections
- Time-based blocking with automatic expiry
TESTS (32 total, ALL PASS):
- 25 unit tests in test/backtesting/test_protections.py
- 7 integration tests in test/integration/test_all_features.py
- Tests cover: normal operation, edge cases, error handling
DOCUMENTATION:
- Update QWEN.md with development guidelines for AI assistant
* Mandatory rules: Update QWEN.md, README, requirements.txt, tests
* Pre-commit checklist
* Example workflow
- Update README.md with protection system features
- Update project structure with new modules
All code is 100% original - NO license issues with Freqtrade GPLv3.
2026-04-03 13:01:56 +02:00
b9a3fde6f6
Remove documentation link from README
2026-04-02 22:20:33 +02:00
f3e947bf52
Remove CI badge from README
...
Removed CI badge from README.
2026-04-02 22:19:56 +02:00
5caa966597
Fix license and star badge links in README
2026-04-02 22:19:30 +02:00
e8db046289
Update README links to TPTBusiness repository
2026-04-02 22:18:07 +02:00
a0f46e9690
Fix TradingAgents repository link in README
...
Updated the link for TradingAgents to point to the correct repository.
2026-04-02 22:15:55 +02:00
ec9cd9bfa1
docs: Simplify README for git-clone-only installation
...
- Removed PyPI installation option (pip install predix)
- Removed make dev (not needed)
- Removed start_loop.sh (can be done inline)
- Simplified Quick Start to git clone + conda + pip install
- Updated badges (removed PyPI badge)
- Added inline loop example for continuous trading
- Configuration section moved after Quick Start
All installation now via git clone only.
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com >
2026-04-02 21:21:29 +02:00
7701ba02a8
docs: Add ATTRIBUTION.md with clear usage guidelines
...
- Created ATTRIBUTION.md explaining MIT License requirements
- Added attribution requirements to README.md
- Clarifies what users must do when using this code:
* Keep MIT License text
* Keep copyright notice
* Provide attribution to original project
- Includes examples of good and bad attribution
- Explains legal basis and consequences of violations
- Adds License badge to README header
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com >
2026-04-02 20:35:57 +02:00
647be579f8
docs: Remove 'Inspired by' comments and add comprehensive Acknowledgments
...
- Removed 'Inspiriert von' comments from all source files
- Added comprehensive Acknowledgments section to README.md
- Credits to:
* Microsoft RD-Agent (MIT) - R&D framework foundation
* TradingAgents (Apache 2.0) - Multi-agent patterns
* ai-hedge-fund - Macro analysis and risk management concepts
- Clarified that all code is originally written and implemented independently
- Ensures license compliance (MIT, Apache 2.0 compatible)
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com >
2026-04-02 20:16:54 +02:00
a48f0a9733
docs: Add Microsoft RD-Agent acknowledgment to README
...
- Added acknowledgment section crediting Microsoft RD-Agent
- Link to original project: https://github.com/microsoft/RD-Agent
- Clarifies that Predix extends RD-Agent with forex-specific features
2026-04-02 19:34:05 +02:00
11b347d0e7
chore: prepare repository for Predix public release
...
- Rebrand from RD-Agent to Predix for EUR/USD quantitative trading
- Update all documentation to English
- Remove Microsoft-specific references
- Clean up temporary files and backups
- Update LICENSE, README, and configuration for PredixAI organization
Breaking changes:
- Project name changed from 'rdagent' to 'predix' in pyproject.toml
- All Microsoft and RD-Agent branding replaced with Predix
- Documentation completely rewritten for EUR/USD focus
Documentation:
- README.md: Professional English documentation with installation, quick start, CLI reference
- CHANGELOG.md: Cleaned up, references upstream RD-Agent for historical changes
- CODE_OF_CONDUCT.md: Switched to Contributor Covenant v2.0
- SECURITY.md: Predix-specific vulnerability reporting process
- SUPPORT.md: Updated support channels (nico@predix.io , GitHub Discussions)
- CONTRIBUTING.md: Adapted for Predix project
- docs/: Sphinx configuration updated for Predix branding
Configuration:
- pyproject.toml: Updated project metadata, keywords, URLs for PredixAI
- .gitignore: Comprehensive Python/gitignore template
- Makefile: Updated CI pages URL
- setup_predix_eurusd.sh: Translated to English
Cleanup:
- Deleted log files, caches, __pycache__ directories
- Removed backup files (*.backup_*)
- Cleaned web/node_modules
2026-03-29 00:10:26 +01:00
14395488b9
feat: add a web UI server ( #1345 )
...
* update rdagent cmd
* fix log error message
* use multiProcessing.Process instead of subprocess.Popen
* add traces to gitignore
* add user interactor in RDLoop (finance scenarios)
* add interactor (feedback, hypothesis) for quant scens
* fix the test_end in qlib conf
* add features init config, general instruction to qlib scenarios
* set base features for based exp
* fix bug when combine factors
* move traces folder to git_ignore_folder
* fix bug in features init
* fix quant interact bug
* fix logger warning error
* bug fixes
* modify rdagent logger, now it can set file output
* adjust cli functions and fix logger bug
* fix server port transport problem
* update server_ui in cli
* add web code
* fix CI problem
* black fix
* update web ui README
* update README
* update readme
2026-03-18 14:04:52 +08:00
afb575cc91
fix: enhance feedback handling in MultiProcessEvolvingStrategy for improved task evolution ( #1274 )
2025-10-23 16:00:23 +08:00
3b9ad11457
fix(docs): update rdagent ui with correct params ( #1249 )
2025-09-23 16:20:00 +08:00
12969b491e
feat: update README with latest paper acceptance to NeurIPS 2025 ( #1252 )
...
* feat: update README with latest news and announcements
* update readme
2025-09-19 10:58:07 +08:00
a829b2aaea
style: convert CLI flags from snake_case to kebab-case ( #1198 )
...
Co-authored-by: Young <afe.young@gmail.com >
2025-08-25 20:07:01 +08:00
56ed919b2e
docs: update configuration docs ( #1155 )
...
* update configuration docs
* update configuration docs
* update configuration docs
2025-08-05 15:48:28 +08:00
81d0ac7185
docs: update data science docs ( #1015 )
...
* update data science docs part1
* update data science docs part2
* update data science docs part3
* update data science docs part4
* update data science docs part5
* format with isort
* update data science docs part6
* add check environment scripts
* format with isort
* format with isort
* merge env_check to health_check
* format with isort
* format with black
* optimize code
* use boolean cli options
* replace fire with typer
* replace fire with typer
* optimizing parameter and variable naming
2025-07-19 18:35:24 +08:00
6469a0679a
docs: update docs/installation_and_configuration.rst for Configuration ( #1061 )
...
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update README.md
* Update installation_and_configuration.rst
* Update installation_and_configuration.rst
* Update installation_and_configuration.rst
* Update docs/installation_and_configuration.rst
Co-authored-by: you-n-g <you-n-g@users.noreply.github.com >
* Update installation_and_configuration.rst
* Update installation_and_configuration.rst
---------
Co-authored-by: you-n-g <you-n-g@users.noreply.github.com >
2025-07-16 22:20:49 +08:00
dfd73cb619
docs: update installation methods in readme ( #1058 )
2025-07-11 16:26:16 +08:00
f2272f34c1
fix: support experimental support for Deepseek models and update docs about configuration ( #1024 )
...
* fix qlib running bug for deepseek and add configuration docs about deepseek
2025-07-07 14:18:56 +08:00
a30ad77afb
docs: update readme for v0.5.0 release ( #973 )
2025-06-18 14:49:24 +08:00
32a29a7479
fix: main bug ( #938 )
...
* feat: parameterize cache paths with USER to avoid conflicts
* guide for missing training_hyperparameters
* guidance for KeyError: 'concise_reason'
* fixed three bugs in the test
* fix general_model task bug
* fixed some bugs in the med_model scenario
* delete comments
* format with black
* fix mypy error
* fix ruff error
* fix isort error
* sync code
* revert cache_path code
* revert cache_path code
* delete data mining scenario
* fix factor report loop
* fix LiteLLMAPIBackend log_llm_chat_content setting
* refine fin factor report scenario
* remove unused LogColors
* fix UI
* remove medical scenario docs
* change **kaggle** to **data_science**
* remove default dataset_path in create_debug_data
* remove KAGGLE_SETTINGS in kaggle_crawler
* limit litellm versions
* reformat with black
* change README
* fix_data_science_docs
* make hypothesis observations string
* Hiding old versions of kaggle docs
* hidding kaggle agent docs
---------
Co-authored-by: Young <afe.young@gmail.com >
Co-authored-by: Bowen Xian <xianbowen@outlook.com >
Co-authored-by: yuanteli <1957922024@qq.com >
2025-06-18 14:35:45 +08:00
9165d64464
docs: update explanation for separate config use in litellm ( #958 )
...
* docs: update explanation for separate config use in litellm
* docs: update default backend to `rdagent.oai.backend.LiteLLMAPIBackend`
* docs: update .rst format
* Update installation_and_configuration.rst
2025-06-13 18:32:39 +08:00
b6c0e891d3
docs: update llm setting guidance and "REASONING_THINK_RM" description ( #943 )
...
* update llm setting guidance and "REASONING_THINK_RM" description
* remove deprecated backend in readme
2025-06-11 15:45:22 +08:00
76d87d241b
docs: Update README.md ( #948 )
2025-06-07 15:24:25 +08:00
9240a71c54
docs: update document for RD-Agent(Q) ( #940 )
2025-06-07 14:41:02 +08:00
1f0bc42277
docs: update README for RD-Agent(Q) ( #913 )
2025-05-30 12:28:52 +08:00
TPTBusiness