chore(main): release 0.0.1 (#182)

Release-As: 0.0.1

.bandit.yml

@@ -1,39 +0,0 @@
-# Bandit security scanning configuration
-# This file configures which security checks to skip
-
-skips:
-  # B101: assert_used - assert statements are used for development
-  - 'B101'
-  # B104: hardcoded_bind_all_interfaces - we bind to 0.0.0.0 intentionally
-  - 'B104'
-  # B108: hardcoded_tmp_directory - /tmp is used intentionally for Docker volumes
-  - 'B108'
-  # B301: pickle - pickle is used for session serialization (internal data only)
-  - 'B301'
-  # B310: urllib_urlopen - used for internal URL fetching
-  - 'B310'
-  # B311: random - random is used for non-crypto purposes
-  - 'B311'
-  # B404: subprocess - subprocess is used for process management
-  - 'B404'
-  # B603: subprocess_without_shell_equals_true - intentional usage
-  - 'B603'
-  # B608: hardcoded_sql_expressions - false positive
-  - 'B608'
-  # B609: linux_commands_wildcard_injection - intentional usage
-  - 'B609'
-  # B102: exec_used - required for sandboxed strategy code evaluation
-  - 'B102'
-  # B602: subprocess_popen_with_shell_equals_true - intentional for Docker/Conda env setup
-  - 'B602'
-  # B701: jinja2_autoescape_false - internal template rendering, no user XSS exposure
-  - 'B701'
-  # B113: requests_without_timeout - internal API calls, timeout not critical
-  - 'B113'
-  # B614: pytorch_load - internal benchmark code loading .pt files from workspace only
-  - 'B614'
-  # B307: eval_used - internal config parsing with controlled input
-  - 'B307'
-  # B615: huggingface_unsafe_download - RL benchmark files use HuggingFace Hub for
-  #   research datasets; revision pinning is not required for benchmark reproducibility
-  - 'B615'

.bumpversion.cfg

@@ -0,0 +1,6 @@
+[bumpversion]
+current_version = 0.0.0
+commit = True
+tag = True
+
+[bumpversion:file:pyproject.toml]

.codacy.yml

@@ -1,33 +0,0 @@
----
-engines:
-  # Disable ESLint — no .eslintrc in web/ frontend directory
-  eslint:
-    enabled: false
-  # Disable PMD — no Java code, no ruleset configured
-  pmd:
-    enabled: false
-  # Disable Prospector — redundant with pylint
-  prospector:
-    enabled: false
-  # Keep bandit for security scanning
-  bandit:
-    enabled: true
-  # Keep pylint but limit scope via exclude_paths below
-  pylint:
-    enabled: true
-
-# Global path exclusions — keeps pylint result count manageable
-# to avoid Codacy SARIF formatter IndexOutOfBoundsException (Sarif.scala:185)
-exclude_paths:
-  - "web/**"
-  - "git_ignore_folder/**"
-  - "workspace/**"
-  - "scripts/**"
-  - "test/**"
-  - "*.md"
-  - "*.txt"
-  - "*.yaml"
-  - "*.yml"
-  - "*.json"
-  - "*.toml"
-  - ".git/**"

.env.example

@@ -0,0 +1,30 @@
+"""
+This file is a template for the .env file.
+
+Please copy this file to .env and fill in the values.
+
+For more information about configuration options, please refer to the documentation
+
+"""
+
+# Global configs:
+USE_AZURE=False
+USE_AZURE_TOKEN_PROVIDER=False
+MAX_RETRY=10
+RETRY_WAIT_SECONDS=20
+
+# LLM API Setting:
+OPENAI_API_KEY=<your_api_key>
+CHAT_MODEL=gpt-4-turbo
+CHAT_MAX_TOKENS=3000
+CHAT_TEMPERATURE=0.7
+# CHAT_AZURE_API_BASE=<for_Azure_user>
+# CHAT_AZURE_API_VERSION=<for_Azure_user>
+
+EMBEDDING_MODEL=text-embedding-3-small
+# EMBEDDING_AZURE_API_BASE=<for_Azure_user>
+# EMBEDDING_AZURE_API_VERSION=<for_Azure_user>
+
+# Cache Setting (Optional):
+
+# Senario Configs:

.github/CODEOWNERS

@@ -1,42 +0,0 @@
-# CODEOWNERS
-# Diese Datei definiert die Verantwortlichen für Code-Reviews
-# Siehe: https://docs.github.com/en/repositories/working-with-files/managing-files/about-code-owners
-
-# Core Maintainer (Standard-Reviewer für alle Änderungen)
-* @nico
-
-# RD-Agent Core-Module
-/rdagent/core/ @nico
-/rdagent/components/ @nico
-/rdagent/app/ @nico
-
-# Trading-Spezifika
-/rdagent/scenarios/ @nico
-/prompts/ @nico
-
-# Dokumentation
-/docs/ @nico
-/README.md @nico
-/examples/ @nico
-/CONTRIBUTING.md @nico
-/CODE_OF_CONDUCT.md @nico
-
-# Konfiguration & Build
-/pyproject.toml @nico
-/requirements.txt @nico
-/setup.py @nico
-/Makefile @nico
-
-# CI/CD & Security
-/.github/ @nico
-/.pre-commit-config.yaml @nico
-/.bandit.yml @nico
-/SECURITY.md @nico
-
-# Dashboard & Visualization
-/dashboard/ @nico
-/web/ @nico
-
-# Data Pipeline
-/data/ @nico
-/scripts/download*.py @nico

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github:
+  - MIIC-finance

.github/ISSUE_TEMPLATE/🐛_bug_report.md

@@ -1,58 +0,0 @@
----
-name: 🐛 Bug Report
-about: Create a report to help us improve PREDIX
-title: '[Bug] '
-labels: 'bug, needs-triage'
-assignees: ''
-
----
-
-## Beschreibung
-<!-- Eine klare und prägnante Beschreibung des Bugs -->
-
-## Reproduktionsschritte
-<!-- Schritte zum Reproduzieren des Verhaltens -->
-
-1. Schritt 1: `...`
-2. Schritt 2: `...`
-3. Schritt 3: `...`
-4. Fehler tritt auf
-
-## Erwartetes Verhalten
-<!-- Eine klare Beschreibung dessen, was passieren sollte -->
-
-## Tatsächliches Verhalten
-<!-- Was passiert tatsächlich? -->
-
-## Environment
-
-<!-- Bitte fülle die folgenden Informationen aus -->
-
-- **OS:** [z.B. Linux, macOS, Windows]
-- **Python-Version:** [z.B. 3.10, 3.11]
-- **PREDIX-Version:** [z.B. v2.0.0, main-branch]
-- **Installation:** [z.B. pip, conda, from source]
-
-## Logs & Screenshots
-
-<!-- Füge relevante Logs oder Screenshots hinzu -->
-
-<details>
-<summary>Log Output (klicken zum Aufklappen)</summary>
-
-```
-Hier die Log-Ausgabe einfügen
-```
-
-</details>
-
-## Zusätzliche Kontext
-
-<!-- Weitere Informationen zum Problem -->
-
-### Data Configuration
-- [ ] Ich habe sichergestellt, dass die Daten korrekt geladen sind
-- [ ] `qlib init` wurde erfolgreich ausgeführt
-
-### Workaround
-<!-- Falls vorhanden: Gibt es einen Workaround? -->

.github/ISSUE_TEMPLATE/💡_feature_request.md

@@ -1,47 +0,0 @@
----
-name: 💡 Feature Request
-about: Suggest an idea for PREDIX
-title: '[Feature] '
-labels: 'enhancement, needs-triage'
-assignees: ''
-
----
-
-## Problem-Beschreibung
-<!-- Bezieht sich dein Feature auf ein Problem? Bitte beschreibe es -->
-<!-- Beispiel: "Ich bin immer frustriert, wenn ich..." -->
-
-## Lösungsvorschlag
-<!-- Eine klare und prägnante Beschreibung dessen, was du gerne hättest -->
-
-## Alternativen
-<!-- Hast du alternative Lösungen in Betracht gezogen? -->
-
-## Zusätzliche Kontext
-<!-- Weitere Informationen, Screenshots oder Mockups -->
-
-## Use Case
-<!-- Wie würde dieses Feature deinen Workflow verbessern? -->
-
-### Checkliste
-<!-- Bitte bestätige die folgenden Punkte mit [x] -->
-
-- [ ] Ich habe die [Dokumentation](https://github.com/nico/Predix/tree/main/docs) gelesen
-- [ ] Ich habe geprüft, ob dieses Feature bereits als [bestehendes Issue](https://github.com/nico/Predix/issues) existiert
-- [ ] Dieses Feature ist relevant für **Open-Source** (keine closed-source Komponenten)
-
-## Impact
-
-<!-- Wer würde von diesem Feature profitieren? -->
-
-- [ ] Alle PREDIX-Nutzer
-- [ ] Spezifische Nutzer (z.B. FX-Trader, Qlib-Nutzer)
-- [ ] Entwickler/Contributors
-
-## Priorität
-
-<!-- Wie dringend ist dieses Feature? -->
-
-- [ ] Niedrig (Nice-to-have)
-- [ ] Mittel (Würde den Workflow verbessern)
-- [ ] Hoch (Blockiert meine Arbeit)

.github/ISSUE_TEMPLATE/📚_docs_improvement.md

@@ -1,58 +0,0 @@
----
-name: 📚 Documentation Improvement
-about: Suggest improvements to PREDIX documentation
-title: '[Docs] '
-labels: 'documentation'
-assignees: ''
-
----
-
-## Aktueller Zustand
-<!-- Welche Seite/Welcher Teil der Dokumentation ist betroffen? -->
-
-**URL/Datei:** `z.B. README.md, docs/quickstart.rst`
-
-**Aktueller Inhalt:**
-<!-- Zitat oder Beschreibung des aktuellen Zustands -->
-
-## Verbesserungsvorschlag
-<!-- Was sollte geändert/hinzugefügt werden? -->
-
-## Beispiel/Begründung
-<!-- Warum ist diese Verbesserung notwendig? -->
-
-### Art der Verbesserung
-
-- [ ] Tippfehler/Grammatik
-- [ ] Fehlende Erklärung
-- [ ] Veraltetes Beispiel
-- [ ] Neues Beispiel hinzufügen
-- [ ] Struktur/Navigation verbessern
-- [ ] API-Dokumentation erweitern
-- [ ] Troubleshooting-Sektion
-
-## Betroffene Nutzergruppe
-
-<!-- Wer profitiert von dieser Verbesserung? -->
-
-- [ ] Neueinsteiger
-- [ ] Fortgeschrittene Nutzer
-- [ ] Developers/Contributors
-- [ ] Alle
-
-## Vorschlag (Optional)
-
-<!-- Hast du bereits einen konkreten Formulierungsvorschlag? -->
-
-<details>
-<summary>Vorgeschlagener Text (klicken zum Aufklappen)</summary>
-
-```markdown
-Hier den verbesserten Text einfügen
-```
-
-</details>
-
-## Zusätzliche Kontext
-
-<!-- Weitere Informationen -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,91 +1,36 @@
-# Pull Request
+<!--- Thank you for submitting a Pull Request! In order to make our work smoother. -->
+<!--- please make sure your Pull Request meets the following requirements: -->
+<!---   1. Provide a general summary of your changes in the Title above; -->
+<!---   2. Add appropriate prefixes to titles, such as `build:`, `chore:`, `ci:`, `docs:`, `feat:`, `fix:`, `perf:`, `refactor:`, `revert:`, `style:`, `test:`(Ref: https://www.conventionalcommits.org/). -->
+<!--- Category: -->
+<!--- Patch Updates: `fix:` -->
+<!---   Example: fix(auth): correct login validation issue -->
+<!--- minor update (introduces new functionality): `feat` -->
+<!---   Example: feature(parser): add ability to parse arrays -->
+<!--- major update(destructive update): Include BREAKING CHANGE in the commit message footer, or add `! ` in the commit footer to indicate that there is a destructive update. -->
+<!---   Example: feat(auth)! : remove support for old authentication method -->
+<!--- Other updates: `build:`, `chore:`, `ci:`, `docs:`, `perf:`, `refactor:`, `revert:`, `style:`, `test:`. -->
 
-## Beschreibung
+## Description
+<!--- Describe your changes in detail -->
 
-<!-- 
-Eine klare und prägnante Beschreibung der Änderungen.
-Beziehe dich auf das zugehörige Issue (falls vorhanden).
--->
+## Motivation and Context
+<!--- Are there any related issues? If so, please put the link here. -->
+<!--- Why is this change required? What problem does it solve? -->
 
-**Fixes:** #<!-- Issue-Nummer -->
+## How Has This Been Tested?
+<!---  Put an `x` in all the boxes that apply: --->
+- [ ] Pass the test by running: `pytest qlib/tests/test_all_pipeline.py` under upper directory of `qlib`.
+- [ ] If you are adding a new feature, test on your own test scripts.
 
-## Typ
+<!--- **ATTENTION**: If you are adding a new feature, please make sure your codes are **correctly tested**. If our test scripts do not cover your cases, please provide your own test scripts under the `tests` folder and test them. More information about test scripts can be found [here](https://docs.python.org/3/library/unittest.html#basic-example), or you could refer to those we provide under the `tests` folder. -->
 
-<!-- Bitte zutreffendes ankreuzen [x] -->
+## Screenshots of Test Results (if appropriate):
+1. Pipeline test:
+2. Your own tests:
 
-- [ ] 🐛 Bug Fix
-- [ ] ✨ Neue Funktion
-- [ ] 📚 Dokumentation
-- [ ] 🧹 Code Cleanup/Refactoring
-- [ ] ⚡ Performance-Verbesserung
-- [ ] 🔧 Konfiguration/Build
-- [ ] 🧪 Tests
-
-## Changes
-
-<!-- Welche Dateien wurden geändert und warum? -->
-
-- `Datei1.py`: Beschreibung der Änderung
-- `Datei2.py`: Beschreibung der Änderung
-
-## Testing
-
-<!-- Wie wurden die Änderungen getestet? -->
-
-### Tests hinzugefügt/aktualisiert
-
-- [ ] Ja, Unit Tests
-- [ ] Ja, Integration Tests
-- [ ] Nein, aber manuell getestet
-- [ ] Nicht zutreffend
-
-### Testing Notes
-
-<!-- Beschreibe deine Testing-Schritte -->
-
-```bash
-# Beispiel: Tests ausführen
-pytest test/ -v --cov=rdagent
-
-# Beispiel: CLI Command testen
-rdagent COMMAND --help
-```
-
-## Checklist
-
-<!-- Bitte alle zutreffenden Punkte ankreuzen [x] -->
-
-- [ ] Meine Änderungen folgen dem [Coding Style](CONTRIBUTING.md)
-- [ ] Ich habe [CONTRIBUTING.md](CONTRIBUTING.md) gelesen und befolgt
-- [ ] Tests wurden hinzugefügt oder aktualisiert
-- [ ] Dokumentation wurde aktualisiert (`docs/` oder README.md)
-- [ ] CHANGELOG.md wurde aktualisiert (falls zutreffend)
-- [ ] Pre-commit Hooks bestanden (`pre-commit run --all-files`)
-- [ ] Keine closed-source Assets committen (siehe unten)
-
-## ⚠️ Closed-Source Check
-
-<!-- 
-KRITISCH: Bitte bestätige, dass KEINE der folgenden Dateien committen wurden:
--->
-
-- [ ] `git_ignore_folder/` – Trading-Skripte, OHLCV-Daten, Credentials
-- [ ] `results/` – Backtest-Ergebnisse, Strategien, Logs
-- [ ] `.env` – API-Keys, Credentials
-- [ ] `models/local/` – Eigene verbesserte Modelle
-- [ ] `prompts/local/` – Eigene verbesserte Prompts
-- [ ] `rdagent/scenarios/qlib/local/` – Closed-Source Komponenten
-- [ ] `*.db` – SQLite-Datenbanken
-- [ ] `*.log` – Log-Files
-
-## Screenshots (falls relevant)
-
-<!-- Vorher/Nachher-Vergleiche, UI-Änderungen etc. -->
-
-| Vorher | Nachher |
-|--------|---------|
-| <!-- Screenshot --> | <!-- Screenshot --> |
-
-## Zusätzliche Kontext
-
-<!-- Weitere Informationen zu den Änderungen -->
+## Types of changes
+<!--- What types of changes does your code introduce? Put an `x` in all the boxes that apply: -->
+- [ ] Fix bugs
+- [ ] Add new feature
+- [ ] Update documentation

.github/dependabot.yml

@@ -1,26 +1,19 @@
-version: 2
 updates:
-  - package-ecosystem: "pip"
-    directory: "/"
+  - commit-message:
+      prefix: build(actions)
+    directory: /
+    package-ecosystem: github-actions
     schedule:
-      interval: "weekly"
-      day: "monday"
-      time: "06:00"
-    open-pull-requests-limit: 5
-    labels:
-      - "dependencies"
-    ignore:
-      # Ignore major version bumps — review manually
-      - dependency-name: "*"
-        update-types: ["version-update:semver-major"]
-
-  - package-ecosystem: "github-actions"
-    directory: "/"
+      interval: weekly
+  - commit-message:
+      prefix: build(requirements)
+    directory: /
+    groups:
+      dev:
+        dependency-type: development
+      prod:
+        dependency-type: production
+    package-ecosystem: pip
     schedule:
-      interval: "weekly"
-      day: "monday"
-      time: "06:00"
-    open-pull-requests-limit: 5
-    labels:
-      - "dependencies"
-      - "github-actions"
+      interval: weekly
+version: 2

.github/workflows/ci.yml

@@ -1,49 +1,70 @@
-name: CI
-
-on:
-  push:
-    branches: [master, main]
-  pull_request:
-    branches: [master, main]
-
-permissions:
-  contents: read
-  security-events: write
-
+concurrency:
+  cancel-in-progress: true
+  group: ${{ github.workflow }}-${{ github.ref }}
 jobs:
-  security:
+  ci:
+    if: ${{ !cancelled() && ! failure() }}
+    needs: dependabot
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
-
-      - name: Run Bandit (Security Scan)
-        uses: PyCQA/bandit-action@v1
+      - name: checkout
+        uses: actions/checkout@v4
         with:
-          targets: "rdagent/"
-          severity: medium
-
-  test:
+          fetch-depth: 0
+          submodules: recursive
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          cache: pip
+          python-version: ${{ matrix.python-version }}
+      - run: env | sort
+      - run: make dev
+      - name: lint test docs and build
+        run: make lint docs-gen # test docs build
+    strategy:
+      matrix:
+        python-version:
+          - '3.10'
+          - '3.11'
+  dependabot:
+    if: ${{ github.actor == 'dependabot[bot]' && startsWith(github.head_ref, 'dependabot/pip/') }}
+    permissions:
+      contents: write
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
-
-      - uses: actions/setup-python@v6
+      - uses: actions/checkout@v4
         with:
-          python-version: "3.10"
-          cache: "pip"
-
-      - name: Install dependencies
+          fetch-depth: 0
+          ref: ${{ github.head_ref }}
+      - name: Set up Git
         run: |
-          python -m pip install --upgrade pip
-          pip install -e ".[test]" || pip install -r requirements.txt
-          pip install pytest pytest-cov
-
-      - name: Run unit tests (no Docker needed)
-        run: |
-          pytest test/backtesting/ -v --tb=short
-
-      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v6
+          git config --global user.name github-actions
+          git config --global user.email github-actions@github.com
+      - name: Set up Python with multiple versions.
+        uses: actions/setup-python@v5
         with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          fail_ci_if_error: false
+          cache: pip
+          python-version: |
+            3.10
+            3.11
+      - name: Install pipenv using pipx
+        run: pipx install pipenv
+      - name: Generate constraints for all supported Python versions
+        run: |
+          CI= PYTHON_VERSION=3.10 make constraints
+          CI= PYTHON_VERSION=3.11 make constraints
+      - name: Push changes if applicable
+        run: |
+          if [[ -n `git status --porcelain` ]]; then
+            git commit -a -m "build: Update constraints for dependabot."
+            git push
+          fi
+name: CI
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+  push:
+    branches:
+      - main

.github/workflows/codacy.yml

@@ -1,61 +0,0 @@
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
-
-# This workflow checks out code, performs a Codacy security scan
-# and integrates the results with the
-# GitHub Advanced Security code scanning feature.  For more information on
-# the Codacy security scan action usage and parameters, see
-# https://github.com/codacy/codacy-analysis-cli-action.
-# For more information on Codacy Analysis CLI in general, see
-# https://github.com/codacy/codacy-analysis-cli.
-
-name: Codacy Security Scan
-
-on:
-  push:
-    branches: [ "master" ]
-  pull_request:
-    # The branches below must be a subset of the branches above
-    branches: [ "master" ]
-  schedule:
-    - cron: '45 11 * * 2'
-
-permissions:
-  contents: read
-
-jobs:
-  codacy-security-scan:
-    permissions:
-      contents: read # for actions/checkout to fetch code
-      security-events: write # for github/codeql-action/upload-sarif to upload SARIF results
-      actions: read # only required for a private repository by github/codeql-action/upload-sarif to get the Action run status
-    name: Codacy Security Scan
-    runs-on: ubuntu-latest
-    steps:
-      # Checkout the repository to the GitHub Actions runner
-      - name: Checkout code
-        uses: actions/checkout@v6
-
-      # Execute Codacy Analysis CLI and generate a SARIF output with the security issues identified during the analysis
-      - name: Run Codacy Analysis CLI
-        uses: codacy/codacy-analysis-cli-action@562ee3e92b8e92df8b67e0a5ff8aa8e261919c08
-        env:
-          JAVA_TOOL_OPTIONS: "-Dfile.encoding=UTF-8"
-        with:
-          project-token: ${{ secrets.CODACY_PROJECT_TOKEN }}
-          verbose: true
-          output: results.sarif
-          format: sarif
-          gh-code-scanning-compat: true
-          max-allowed-issues: 2147483647
-          # Limit to bandit only — avoids ESLint (no .eslintrc), PMD (no ruleset),
-          # and pylint 14k-result SARIF crash (IndexOutOfBoundsException Sarif.scala:185)
-          tool: bandit
-
-      # Upload the SARIF file generated in the previous step
-      - name: Upload SARIF results file
-        uses: github/codeql-action/upload-sarif@v4
-        with:
-          sarif_file: results.sarif

.github/workflows/conventional-commits.yml

@@ -1,78 +0,0 @@
-name: Conventional Commits
-
-on:
-  pull_request:
-    branches: [master, main]
-    types: [opened, edited, synchronize, reopened]
-
-permissions:
-  contents: read
-  pull-requests: read
-
-jobs:
-  check-title:
-    name: Validate PR Title
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check PR title follows Conventional Commits
-        env:
-          PR_TITLE: ${{ github.event.pull_request.title }}
-        run: |
-          echo "PR title: $PR_TITLE"
-
-          # Conventional Commits pattern: type(scope)!: description
-          # Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
-          PATTERN='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([^)]+\))?(!)?: .{1,100}$'
-
-          if echo "$PR_TITLE" | grep -qE "$PATTERN"; then
-            echo "✓ PR title follows Conventional Commits format"
-          else
-            echo "::error::PR title does not follow Conventional Commits format."
-            echo ""
-            echo "Expected format:  type(scope): description"
-            echo "Examples:"
-            echo "  feat: add volatility factor"
-            echo "  fix(optuna): fix inverted range in stage 2"
-            echo "  ci: add dependabot config"
-            echo "  chore(deps): pin aiohttp>=3.13.4"
-            echo ""
-            echo "Valid types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert"
-            echo ""
-            echo "This is required for release-please to generate correct changelogs."
-            exit 1
-          fi
-
-  check-commits:
-    name: Validate Commit Messages
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - name: Check commits in PR follow Conventional Commits
-        env:
-          BASE_SHA: ${{ github.event.pull_request.base.sha }}
-          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
-        run: |
-          PATTERN='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([^)]+\))?(!)?: .+'
-
-          FAILED=0
-          while IFS= read -r msg; do
-            # Skip merge commits
-            if echo "$msg" | grep -qE "^Merge (pull request|branch|remote)"; then
-              continue
-            fi
-            if ! echo "$msg" | grep -qE "$PATTERN"; then
-              echo "::warning::Non-conventional commit: $msg"
-              FAILED=1
-            fi
-          done < <(git log "$BASE_SHA..$HEAD_SHA" --format="%s")
-
-          if [ $FAILED -eq 1 ]; then
-            echo ""
-            echo "::warning::Some commits don't follow Conventional Commits."
-            echo "This won't block the PR but may affect changelog generation."
-          else
-            echo "✓ All commits follow Conventional Commits format"
-          fi

.github/workflows/docs.yml

@@ -1,86 +0,0 @@
-name: Documentation
-
-on:
-  push:
-    branches: [ main ]
-    paths:
-      - 'docs/**'
-      - 'README.md'
-      - '**/*.rst'
-      - '.github/workflows/docs.yml'
-  pull_request:
-    branches: [ main ]
-    paths:
-      - 'docs/**'
-      - 'README.md'
-      - '**/*.rst'
-
-permissions:
-  contents: read
-
-jobs:
-  docs:
-    name: Build Documentation
-    runs-on: ubuntu-latest
-
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v6
-
-    - name: Set up Python
-      uses: actions/setup-python@v6
-      with:
-        python-version: "3.10"
-
-    - name: Cache pip dependencies
-      uses: actions/cache@v5
-      with:
-        path: ~/.cache/pip
-        key: ${{ runner.os }}-pip-docs-${{ hashFiles('**/pyproject.toml') }}
-        restore-keys: |
-          ${{ runner.os }}-pip-docs-
-
-    - name: Install docs dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -e ".[docs]"
-
-    - name: Build Sphinx documentation
-      run: |
-        cd docs
-        make clean
-        make html SPHINXOPTS="-W --keep-going" || {
-          echo "::error::Sphinx build failed with warnings"
-          exit 1
-        }
-
-    - name: Check for broken links
-      run: |
-        cd docs
-        make linkcheck || {
-          echo "::warning::Some links are broken (non-blocking)"
-          exit 0
-        }
-
-    - name: Upload docs artifact
-      if: github.ref == 'refs/heads/main'
-      uses: actions/upload-pages-artifact@v5
-      with:
-        path: docs/_build/html
-
-  deploy:
-    name: Deploy to GitHub Pages
-    needs: docs
-    if: github.ref == 'refs/heads/main'
-    runs-on: ubuntu-latest
-    permissions:
-      pages: write
-      id-token: write
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-
-    steps:
-    - name: Deploy to GitHub Pages
-      id: deployment
-      uses: actions/deploy-pages@v5

.github/workflows/lint.yml

@@ -1,84 +0,0 @@
-name: Code Quality
-
-on:
-  push:
-    branches: [ main, develop ]
-  pull_request:
-    branches: [ main ]
-
-permissions:
-  contents: read
-
-jobs:
-  lint:
-    name: Lint & Format
-    runs-on: ubuntu-latest
-
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v6
-
-    - name: Set up Python
-      uses: actions/setup-python@v6
-      with:
-        python-version: "3.10"
-
-    - name: Cache pip dependencies
-      uses: actions/cache@v5
-      with:
-        path: ~/.cache/pip
-        key: ${{ runner.os }}-pip-lint-${{ hashFiles('**/pyproject.toml') }}
-        restore-keys: |
-          ${{ runner.os }}-pip-lint-
-
-    - name: Install lint dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install ruff mypy
-
-    - name: Run Ruff (linter)
-      run: |
-        echo "=== Running Ruff Linter ==="
-        ruff check . --statistics || {
-          echo "::error::Ruff linter found issues. Run: ruff check . --fix"
-          exit 1
-        }
-
-    - name: Run Ruff (formatter)
-      run: |
-        echo "=== Running Ruff Formatter ==="
-        ruff format --check . || {
-          echo "::error::Ruff formatter found issues. Run: ruff format ."
-          exit 1
-        }
-
-    - name: Run MyPy (type checker)
-      run: |
-        echo "=== Running MyPy Type Checker ==="
-        mypy rdagent/ \
-          --ignore-missing-imports \
-          --no-strict-optional \
-          --follow-imports=skip \
-          --warn-return-any || {
-          echo "::warning::MyPy found type issues (non-blocking)"
-          # Non-blocking: MyPy warnings don't fail the build
-          exit 0
-        }
-
-    - name: Check for trailing whitespace
-      run: |
-        echo "=== Checking for trailing whitespace ==="
-        if grep -rIn '[[:space:]]$' --include='*.py' --include='*.md' --include='*.rst' . | grep -v '.git'; then
-          echo "::error::Found trailing whitespace. Please remove it."
-          exit 1
-        fi
-        echo "✓ No trailing whitespace found"
-
-    - name: Check for merge conflicts
-      run: |
-        echo "=== Checking for merge conflict markers ==="
-        if grep -rn '<<<<<<< HEAD\|=======\|>>>>>>>' --include='*.py' --include='*.md' . | grep -v '.git'; then
-          echo "::error::Found merge conflict markers. Please resolve them."
-          exit 1
-        fi
-        echo "✓ No merge conflict markers found"

.github/workflows/pr.yml

@@ -0,0 +1,22 @@
+concurrency:
+  cancel-in-progress: true
+  group: ${{ github.workflow }}-${{ github.ref }}
+jobs:
+  lint-title:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check PR Title for Conventional Commit Format
+        run: |
+          if ! echo "${{ github.event.pull_request.title }}" | grep -Pq '^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test|Release-As)(\(\w+\))?!?:\s.*'; then
+            echo 'The title does not conform to the Conventional Commit.'
+            echo 'Please refer to "https://www.conventionalcommits.org/"'
+            exit 1
+          fi
+name: Lint pull request title
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - edited

.github/workflows/readthedocs-preview.yml

@@ -0,0 +1,17 @@
+concurrency:
+  cancel-in-progress: true
+  group: ${{ github.workflow }}-${{ github.ref }}
+jobs:
+  documentation-links:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: readthedocs/actions/preview@v1
+        with:
+          project-slug: RDAgent
+name: Read the Docs Pull Request Preview
+on:
+  pull_request_target:
+    types:
+      - opened
+permissions:
+  pull-requests: write

.github/workflows/release.yml

@@ -1,19 +1,50 @@
 name: Release
-
 on:
   push:
-    branches: [master, main]
-
+    branches:
+      - main
 permissions:
-  contents: write
-  pull-requests: write
-
+  contents: read
 jobs:
-  release-please:
+  release_and_publish:
+    permissions:
+      contents: write
+      pull-requests: read
     runs-on: ubuntu-latest
     steps:
-      - uses: googleapis/release-please-action@v5
+      - name: Release please
+        id: release_please
+        uses: googleapis/release-please-action@v4
         with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          config-file: release-please-config.json
-          manifest-file: .release-please-manifest.json
+          # The current PAT (personal access token) was created on 2024-08-05,
+          # since the maximum validity of PAT is 1 year, you need to change the PAT before 2025-08-05.
+          token: ${{ secrets.PAT }}
+          release-type: simple
+      - uses: actions/checkout@v4
+        if: ${{ steps.release_please.outputs.release_created }}
+        with:
+          fetch-depth: 0
+      - name: Set up Python
+        if: ${{ steps.release_please.outputs.release_created }}
+        uses: actions/setup-python@v5
+        with:
+          cache: pip
+          python-version: '3.10'
+      - name: Install dependencies
+        if: ${{ steps.release_please.outputs.release_created }}
+        run: |
+          python -m pip install --upgrade pip
+          pip install setuptools wheel twine  #  better-exceptions(optional for debug)
+      - run: env | sort
+        if: ${{ steps.release_please.outputs.release_created }}
+      - run: make dev
+        if: ${{ steps.release_please.outputs.release_created }}
+      - run: make build
+        if: ${{ steps.release_please.outputs.release_created }}
+      - name: upload
+        if: ${{ steps.release_please.outputs.release_created }}
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
+        run: |
+          make upload

.github/workflows/scheduled-tests.yml

@@ -1,68 +0,0 @@
-name: Scheduled Tests
-
-on:
-  schedule:
-    # Every Monday at 07:00 UTC
-    - cron: "0 7 * * 1"
-  workflow_dispatch:  # Allow manual trigger
-
-permissions:
-  contents: read
-
-jobs:
-  test:
-    name: Weekly Test Run (Python ${{ matrix.python-version }})
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.10", "3.11"]
-
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: actions/setup-python@v6
-        with:
-          python-version: ${{ matrix.python-version }}
-          cache: "pip"
-
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e ".[test]" || pip install -r requirements.txt
-          pip install pytest pytest-cov
-
-      - name: Run tests
-        run: |
-          pytest test/backtesting/ -v --tb=short --durations=10
-
-      - name: Upload results on failure
-        if: failure()
-        uses: actions/upload-artifact@v7
-        with:
-          name: test-results-py${{ matrix.python-version }}
-          path: |
-            .pytest_cache/
-          retention-days: 7
-
-  dependency-audit:
-    name: Dependency Audit
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: actions/setup-python@v6
-        with:
-          python-version: "3.10"
-          cache: "pip"
-
-      - name: Install safety
-        run: pip install safety
-
-      - name: Check for known vulnerabilities
-        run: |
-          echo "=== Weekly dependency vulnerability scan ==="
-          safety check -r requirements.txt --json || {
-            echo "::warning::Vulnerabilities found — review and update dependencies"
-            exit 0
-          }

.github/workflows/security.yml

@@ -1,155 +0,0 @@
-name: Security Scan
-
-on:
-  push:
-    branches: [ master, develop ]
-  pull_request:
-    branches: [ master ]
-  schedule:
-    # Weekly on Monday at 6:00 UTC
-    - cron: '0 6 * * 1'
-
-permissions:
-  contents: read
-
-jobs:
-  security:
-    name: Security Analysis
-    runs-on: ubuntu-latest
-
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v6
-
-    - name: Set up Python
-      uses: actions/setup-python@v6
-      with:
-        python-version: "3.10"
-
-    - name: Cache pip dependencies
-      uses: actions/cache@v5
-      with:
-        path: ~/.cache/pip
-        key: ${{ runner.os }}-pip-security-${{ hashFiles('**/requirements.txt') }}
-        restore-keys: |
-          ${{ runner.os }}-pip-security-
-
-    - name: Install security tools
-      run: |
-        python -m pip install --upgrade pip
-        pip install bandit safety
-
-    - name: Run Bandit (code security)
-      run: |
-        echo "=== Running Bandit Security Scan ==="
-        bandit \
-          -c .bandit.yml \
-          -r rdagent/ \
-          -f json \
-          -o bandit-report.json \
-          --exit-zero || true
-
-        # Show summary
-        bandit -c .bandit.yml -r rdagent/ -ll || true
-
-    - name: Upload Bandit report
-      uses: actions/upload-artifact@v7
-      if: always()
-      with:
-        name: bandit-security-report
-        path: bandit-report.json
-        retention-days: 30
-
-    - name: Check dependencies for vulnerabilities
-      run: |
-        echo "=== Checking Dependencies for Vulnerabilities ==="
-        safety check --json || {
-          echo "::warning::Some dependencies have known vulnerabilities"
-          echo "Please review and update dependencies."
-          exit 0  # Non-blocking
-        }
-
-    - name: Check for exposed secrets
-      run: |
-        echo "=== Scanning for Exposed Secrets ==="
-
-        # Check for common secret patterns
-        PATTERNS=(
-          "api_key\s*=\s*['\"][^'\"]+['\"]"
-          "secret\s*=\s*['\"][^'\"]+['\"]"
-          "password\s*=\s*['\"][^'\"]+['\"]"
-          "token\s*=\s*['\"][^'\"]+['\"]"
-          "PRIVATE.KEY"
-          "BEGIN RSA PRIVATE KEY"
-        )
-
-        FOUND_SECRETS=0
-        for pattern in "${PATTERNS[@]}"; do
-          if grep -rInE "$pattern" --include='*.py' --include='*.yml' --include='*.yaml' --include='*.json' . | \
-             grep -v '.git' | \
-             grep -v 'test/' | \
-             grep -v 'example' | \
-             grep -v '# ' | \
-             grep -v 'os.environ' | \
-             grep -v 'getenv' | \
-             grep -v 'argparse'; then
-            FOUND_SECRETS=1
-          fi
-        done
-
-        if [ $FOUND_SECRETS -eq 1 ]; then
-          echo "::error::Potential secrets exposure detected!"
-          echo "Please review the output above and remove any hardcoded credentials."
-          echo "Use environment variables or .env files instead."
-          exit 1
-        fi
-
-        echo "✓ No exposed secrets found"
-
-    - name: Verify closed-source files not committed
-      run: |
-        echo "=== Verifying No Closed-Source Assets Committed ==="
-
-        FOUND_CLOSED=0
-
-        # Exact directory prefixes that must never appear (use grep -F for literal matching)
-        EXACT_PREFIXES=(
-          "git_ignore_folder/"
-          "models/local/"
-          "prompts/local/"
-          "rdagent/scenarios/qlib/local/"
-        )
-        for prefix in "${EXACT_PREFIXES[@]}"; do
-          if git ls-files | grep -qF "$prefix"; then
-            echo "::error::Found closed-source asset: $prefix"
-            FOUND_CLOSED=1
-          fi
-        done
-
-        # results/ — allow README.md and .gitkeep but nothing else
-        if git ls-files | grep -F "results/" | grep -qvE "results/README\.md|results/\.gitkeep"; then
-          echo "::error::Found closed-source asset: results/ (non-documentation file)"
-          git ls-files | grep -F "results/" | grep -vE "results/README\.md|results/\.gitkeep"
-          FOUND_CLOSED=1
-        fi
-
-        # .env files — match only .env and .env.* exactly, not paths containing "env"
-        if git ls-files | grep -qE "(^|/)\.env($|\.)"; then
-          echo "::error::Found closed-source asset: .env file"
-          FOUND_CLOSED=1
-        fi
-
-        # Binary / data files that must never be committed
-        if git ls-files | grep -qE "\.(db|h5|parquet|log)$"; then
-          echo "::error::Found data/log file committed (*.db, *.h5, *.parquet, *.log)"
-          git ls-files | grep -E "\.(db|h5|parquet|log)$"
-          FOUND_CLOSED=1
-        fi
-
-        if [ $FOUND_CLOSED -eq 1 ]; then
-          echo "CRITICAL: Closed-source assets must not be committed to the repository!"
-          echo "Please remove them and add to .gitignore if needed."
-          exit 1
-        fi
-
-        echo "✓ No closed-source assets found"

.gitignore

@@ -1,143 +1,172 @@
-# ═══════════════════════════════════════════════════════════
-# PREDIX .gitignore
-# ═══════════════════════════════════════════════════════════
+# Custom
+*.swp
+.DS_Store
+Pipfile
+public
+release-notes.md
 
-# ──────────────────────────────────────────────────────────
-# 🔒 CLOSED-SOURCE ASSETS (NIEMALS COMMITTEN!)
-# ──────────────────────────────────────────────────────────
-
-# Trading scripts & raw OHLCV data
-git_ignore_folder/
-data_raw/
-
-# Backtest results, strategies, logs
-results/
-*.log
-fin_quant*.log
-selector.log
-log/
-
-# Credentials & environment
-.env
-.env.*
-!.env.example
-.env.backup
-.env.local
-.env.test
-*.test.env
-
-# Private prompts (your improved versions)
-prompts/local/
-*.local.yaml
-*_private.yaml
-
-# Private models (your improved versions)
-models/local/
-*.local.py
-*_private.py
-
-# Closed source RD-Agent components
-rdagent/scenarios/qlib/local/
-
-# Databases & generated data
-*.db
-*.h5
-intraday_pv*.h5
-prompt_cache.db
-
-# Generated strategy files
-*.json
-!package.json
-!package-lock.json
-!pyproject.json
-
-# Private test scripts
-test_credentials.py
-test/backtesting/test_smart_strategy_gen.py
-
-# Private scripts (root)
-predix_quick_daytrading.py
-predix_smart_strategy_gen.py
-
-# Internal docs
-TODO.md
-QWEN.md
-CLAUDE.md
-docs/COMPLETE_WORKFLOW.md
-docs/SMART_STRATEGY_GEN.md
-
-# OpenACP workspace (secrets)
-.openacp
-
-# ──────────────────────────────────────────────────────────
-# 🐍 Python
-# ──────────────────────────────────────────────────────────
-
-# Byte-compiled & cache
+# Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
 *$py.class
-*.pyc
-.Python
 
-# Distribution/packaging
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
 build/
+develop-eggs/
 dist/
-*.egg-info/
-*.egg
-predix.egg-info/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
 sdist/
 var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
 
-# Virtual environments
-venv/
-ENV/
-env/
-.venv/
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
 
-# ──────────────────────────────────────────────────────────
-# 🧪 Testing & Coverage
-# ──────────────────────────────────────────────────────────
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
 
-.pytest_cache/
-.coverage
-.coverage.*
+# Unit test / coverage reports
 htmlcov/
 .tox/
 .nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
 
-# ──────────────────────────────────────────────────────────
-# 💻 IDE & Editor
-# ──────────────────────────────────────────────────────────
+# Translations
+*.mo
+*.pot
 
-.idea/
+# Django stuff:
+*.log
+/log/
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+^env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# all pkl files
+*.pkl
+
+# all h5 files
+*.h5
+
+# all vs-code files
 .vscode/
-*.swp
-*.swo
-*~
 
-# ──────────────────────────────────────────────────────────
-# 🗜️ Cache & Temp
-# ──────────────────────────────────────────────────────────
+# reports
+reports/
 
-.cache/
-pickle_cache/
-*.so
+# git_ignore_folder
+git_ignore_folder/
 
-# ──────────────────────────────────────────────────────────
-# 🏗️ Build & Reports
-# ──────────────────────────────────────────────────────────
+#cache
+*cache*/
+*cache.json
 
-*.manifest
-*.spec
-..bfg-report/
+# DB files
+*.db
 
-# ──────────────────────────────────────────────────────────
-# 🤖 AI Agent Workspaces (parallel runs)
-# ──────────────────────────────────────────────────────────
+# Docker
+factor_template/mlruns/
+env_tpl
+mlruns/
 
-.qwen/
-RD-Agent_workspace_run*/
-AGENTS.md
-CLAUDE.md
-.claude/
+# possible output from coder or runner
+*.pth
+*qlib_res.csv
+
+# shell script
+*.out
+*.sh

.pre-commit-config.yaml

@@ -1,36 +0,0 @@
-# Pre-commit hooks configuration for Predix
-# See https://pre-commit.com for more information
-
-repos:
-  # ── Integration Tests (MANDATORY - MUST PASS before commit) ──────
-  - repo: local
-    hooks:
-      - id: integration-tests
-        name: Run Integration Tests (60 tests)
-        entry: pytest
-        language: system
-        args:
-          - test/integration/test_all_features.py
-          - -v
-          - --tb=short
-          - --no-cov  # Skip coverage for speed (run separately if needed)
-        pass_filenames: false
-        always_run: true
-
-  # ── Security Scanning (MANDATORY) ─────────────────────────────────
-  - repo: local
-    hooks:
-      - id: bandit-security-scan
-        name: Bandit Security Scan
-        entry: bandit
-        language: system
-        args:
-          - -r
-          - rdagent/
-          - -c
-          - .bandit.yml
-          - --severity-level=medium
-          - --confidence-level=medium
-          - --format=txt
-        pass_filenames: false
-        always_run: true

.pre-commit-hooks/run_bandit.sh

@@ -1,39 +0,0 @@
-#!/bin/bash
-# Bandit Security Scanner Wrapper for Pre-Commit
-# This script runs Bandit with the correct configuration
-# Usage: .pre-commit-hooks/run_bandit.sh [files...]
-
-set -e
-
-BANDIT_CONFIG=".bandit.yml"
-SCAN_DIR="rdagent/"
-EXCLUDE_DIRS="test/,.git/,.qwen/,results/,git_ignore_folder/"
-EXCLUDE_FILES="rdagent/scenarios/qlib/proposal/bandit.py"
-
-echo "🔒 Running Bandit Security Scanner..."
-echo "   Config: ${BANDIT_CONFIG}"
-echo "   Scan: ${SCAN_DIR}"
-echo ""
-
-# Run bandit with high severity threshold
-# Exit code 1 if any HIGH severity issues found
-bandit \
-  --configfile "${BANDIT_CONFIG}" \
-  --severity-level high \
-  --confidence-level medium \
-  --format txt \
-  --recursive "${SCAN_DIR}" \
-  --exclude "${EXCLUDE_DIRS},${EXCLUDE_FILES}" \
-  "$@"
-
-exit_code=$?
-
-if [ $exit_code -eq 0 ]; then
-    echo "✅ No HIGH severity security issues found"
-else
-    echo "⚠️  HIGH severity security issues detected!"
-    echo "   Review issues above and fix before committing."
-    echo "   To suppress false positives, add # nosec BXXX to the line."
-fi
-
-exit $exit_code

.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.3.8"
-}

CHANGELOG.md

@@ -1,187 +1,33 @@
 # Changelog
 
-## [1.3.8](https://github.com/TPTBusiness/Predix/compare/v1.3.7...v1.3.8) (2026-04-30)
-
-
-### Bug Fixes
-
-* **deps:** relax aiohttp constraint to >=3.13.4 for litellm compatibility ([34ab192](https://github.com/TPTBusiness/Predix/commit/34ab1923a887089eb36e5cbad6cb8df16f0333ca))
-* **qlib:** correct indentation in except blocks in quant_proposal and factor_runner ([8143451](https://github.com/TPTBusiness/Predix/commit/8143451e8c0ead01c4d86d19669268c7bfb15fac))
-* **security:** replace eval() with ast.literal_eval in finetune validator (B307) ([0508caf](https://github.com/TPTBusiness/Predix/commit/0508caf9140d210b823fefefa28ee535ec85a0ae))
-* **security:** replace shell=True subprocess calls with list args in env.py (B602) ([2012d5a](https://github.com/TPTBusiness/Predix/commit/2012d5ae4e77cc2f1ab9a48beaaac5a74695d083))
-* **security:** resolve path-injection and add nosec for safe temp paths (B108, py/path-injection) ([6727480](https://github.com/TPTBusiness/Predix/commit/67274803bd1d14e5d1df9a063f46b2edb8501a2b))
-
-## [1.3.7](https://github.com/TPTBusiness/Predix/compare/v1.3.6...v1.3.7) (2026-04-30)
-
-
-### Bug Fixes
-
-* **security:** nosec for B608/B701 false positives in UI and template code ([5eb5d7e](https://github.com/TPTBusiness/Predix/commit/5eb5d7e8fdbe90e0dced83fef4e09f5a33e96b2b))
-* **security:** replace eval() with ast.literal_eval and add request timeouts (B307, B113) ([3301ada](https://github.com/TPTBusiness/Predix/commit/3301ada697ca7d3afa1a188d2a76a87ae98b4529))
-* **security:** replace shell=True subprocess calls with list args (B602) ([13c08f4](https://github.com/TPTBusiness/Predix/commit/13c08f4ce6813eb7c314087921ec8c0f40074bd7))
-
-## [1.3.6](https://github.com/TPTBusiness/Predix/compare/v1.3.5...v1.3.6) (2026-04-30)
-
-
-### Bug Fixes
-
-* **security:** real fix for B110 (logging in factor_proposal.py [#746](https://github.com/TPTBusiness/Predix/issues/746)) ([16624e0](https://github.com/TPTBusiness/Predix/commit/16624e0bd966ae4d24c4a3eb42bbc31c11da3136))
-* **security:** real fix for B110 (logging in factor_runner.py [#744](https://github.com/TPTBusiness/Predix/issues/744)) ([88cf0fb](https://github.com/TPTBusiness/Predix/commit/88cf0fb8828b11c97f2f3ae2881a4900b020c6f0))
-* **security:** real fix for B110 (logging in quant_proposal.py [#741](https://github.com/TPTBusiness/Predix/issues/741)) ([7cf2a64](https://github.com/TPTBusiness/Predix/commit/7cf2a644f553b054bd4b0607ea51e5372e68d90a))
-* **security:** real fix for B110 (logging in quant_proposal.py [#741](https://github.com/TPTBusiness/Predix/issues/741)) ([ef985f8](https://github.com/TPTBusiness/Predix/commit/ef985f86035d8dca707c60137e6508349a0c4ae6))
-* **security:** real fix for B404/B603 (sys.executable in factor_runner.py [#745](https://github.com/TPTBusiness/Predix/issues/745)) ([819655a](https://github.com/TPTBusiness/Predix/commit/819655aaa3efa76596d60501d0e8ca365df3e5e2))
-* **security:** revert broken read_pickle encoding arg in kaggle template (B301) ([3574907](https://github.com/TPTBusiness/Predix/commit/35749073c91e69f63ddaad61dae3f2b799327e63))
-* **security:** validate SQL identifiers in _add_column_if_not_exists (B608) ([e10dfa2](https://github.com/TPTBusiness/Predix/commit/e10dfa2576038e911f83595d3b466c261bc0cd54))
-* **security:** whitelist-validate metric column in get_top_factors (B608) ([e50519f](https://github.com/TPTBusiness/Predix/commit/e50519fe066e68aec2f19b83df4f643c3c22053d))
-
-## [1.3.5](https://github.com/TPTBusiness/Predix/compare/v1.3.4...v1.3.5) (2026-04-27)
-
-
-### Bug Fixes
-
-* **auto-fixer:** add five new factor code fixes for groupby/apply errors ([449c8fd](https://github.com/TPTBusiness/Predix/commit/449c8fd70a327e604dcca122e4a134f0cca918e4))
-* **auto-fixer:** add four new factor code fixes for common runtime errors ([40484f6](https://github.com/TPTBusiness/Predix/commit/40484f6d300425da481f1edd325da4acbc06ec7d))
-* **auto-fixer:** add groupby([level=N,'date']) SyntaxError fix ([ca77c00](https://github.com/TPTBusiness/Predix/commit/ca77c005bea4abdd8854c1de2b0e8d03b7742161))
-* **auto-fixer:** disable _fix_min_periods for intraday data ([77b0740](https://github.com/TPTBusiness/Predix/commit/77b0740f059349df7e769a378af728aa33b2070e))
-* **auto-fixer:** fix chained groupby(level=N).groupby('date') pattern ([7d5fe32](https://github.com/TPTBusiness/Predix/commit/7d5fe32b31a19ce8b04bd8f5a430720fdb748f7a))
-* **auto-fixer:** fix df.loc[instrument] DateParseError on MultiIndex frames ([b7860ea](https://github.com/TPTBusiness/Predix/commit/b7860eafc0ad26384947ce0510ecf4e9f3425807))
-* **auto-fixer:** fix df['instrument'] KeyError on MultiIndex frames ([aad6bd1](https://github.com/TPTBusiness/Predix/commit/aad6bd1c7c720b3d486e0cf248337f32394773b1))
-* **auto-fixer:** fix two assignment-target bugs in instrument column fixers ([421eedf](https://github.com/TPTBusiness/Predix/commit/421eedffed4b883c24397dc5581c019a3985277f))
-* **auto-fixer:** preserve date dimension in groupby(['instrument','date']) fix ([b58fdd8](https://github.com/TPTBusiness/Predix/commit/b58fdd8be43720b5d4363e0f8de9a01591d4d2dc))
-* **auto-fixer:** remove ddof from rolling() args, not only from std()/var() ([b0fc328](https://github.com/TPTBusiness/Predix/commit/b0fc328d0d4a041c65d8eeb32cb3f2bb86568406))
-* **auto-fixer:** strip spurious .reset_index() after .transform() calls ([8708aae](https://github.com/TPTBusiness/Predix/commit/8708aae6e08728cda1875c775a76dc92e43576f3))
-* **loop:** prevent step_idx advance on unhandled exceptions + fix consecutive assistant messages ([5ec4ad1](https://github.com/TPTBusiness/Predix/commit/5ec4ad1b96b5b99ef42bea7bb828cb1ef709a688))
-
-## [1.3.4](https://github.com/TPTBusiness/Predix/compare/v1.3.3...v1.3.4) (2026-04-27)
-
-
-### Bug Fixes
-
-* **auto-fixer:** add five new factor code fixes for groupby/apply errors ([449c8fd](https://github.com/TPTBusiness/Predix/commit/449c8fd70a327e604dcca122e4a134f0cca918e4))
-* **auto-fixer:** add four new factor code fixes for common runtime errors ([40484f6](https://github.com/TPTBusiness/Predix/commit/40484f6d300425da481f1edd325da4acbc06ec7d))
-* **auto-fixer:** add groupby([level=N,'date']) SyntaxError fix ([ca77c00](https://github.com/TPTBusiness/Predix/commit/ca77c005bea4abdd8854c1de2b0e8d03b7742161))
-* **auto-fixer:** disable _fix_min_periods for intraday data ([77b0740](https://github.com/TPTBusiness/Predix/commit/77b0740f059349df7e769a378af728aa33b2070e))
-* **auto-fixer:** fix chained groupby(level=N).groupby('date') pattern ([7d5fe32](https://github.com/TPTBusiness/Predix/commit/7d5fe32b31a19ce8b04bd8f5a430720fdb748f7a))
-* **auto-fixer:** fix df.loc[instrument] DateParseError on MultiIndex frames ([b7860ea](https://github.com/TPTBusiness/Predix/commit/b7860eafc0ad26384947ce0510ecf4e9f3425807))
-* **auto-fixer:** fix df['instrument'] KeyError on MultiIndex frames ([aad6bd1](https://github.com/TPTBusiness/Predix/commit/aad6bd1c7c720b3d486e0cf248337f32394773b1))
-* **auto-fixer:** preserve date dimension in groupby(['instrument','date']) fix ([b58fdd8](https://github.com/TPTBusiness/Predix/commit/b58fdd8be43720b5d4363e0f8de9a01591d4d2dc))
-* **auto-fixer:** remove ddof from rolling() args, not only from std()/var() ([b0fc328](https://github.com/TPTBusiness/Predix/commit/b0fc328d0d4a041c65d8eeb32cb3f2bb86568406))
-* **backtest:** replace broken MC permutation test with binomial win-rate test ([c38d894](https://github.com/TPTBusiness/Predix/commit/c38d89478f586825bfca5715a96ca70ccd8791a3))
-* **factors:** detect and correct look-ahead bias in daily-constant factors ([eb490a4](https://github.com/TPTBusiness/Predix/commit/eb490a461b66cbd815ae53ac5205115754712432))
-* **factors:** extend look-ahead rules to session factors and add intraday-factor guidance ([c24c100](https://github.com/TPTBusiness/Predix/commit/c24c100442d6487686c0578de0b32d240fcbf215))
-* **loop:** compress old experiment history in proposal prompt to reduce context size ([4bf90a9](https://github.com/TPTBusiness/Predix/commit/4bf90a905ba8b2aba2a818191c19998088cccaaf))
-* **loop:** prevent step_idx advance on unhandled exceptions + fix consecutive assistant messages ([5ec4ad1](https://github.com/TPTBusiness/Predix/commit/5ec4ad1b96b5b99ef42bea7bb828cb1ef709a688))
-
-## [1.3.3](https://github.com/TPTBusiness/Predix/compare/v1.3.2...v1.3.3) (2026-04-25)
-
-
-### Bug Fixes
-
-* **backtest:** replace broken MC permutation test with binomial win-rate test ([c38d894](https://github.com/TPTBusiness/Predix/commit/c38d89478f586825bfca5715a96ca70ccd8791a3))
-* **factors:** detect and correct look-ahead bias in daily-constant factors ([eb490a4](https://github.com/TPTBusiness/Predix/commit/eb490a461b66cbd815ae53ac5205115754712432))
-* **factors:** extend look-ahead rules to session factors and add intraday-factor guidance ([c24c100](https://github.com/TPTBusiness/Predix/commit/c24c100442d6487686c0578de0b32d240fcbf215))
-* **loop:** compress old experiment history in proposal prompt to reduce context size ([4bf90a9](https://github.com/TPTBusiness/Predix/commit/4bf90a905ba8b2aba2a818191c19998088cccaaf))
-* **strategies:** guard against None IC in acceptance check, disable slow wf_rolling ([2197f52](https://github.com/TPTBusiness/Predix/commit/2197f52150a50ef38d9e70991d7e48c8c30caec4))
-* **strategies:** handle None ic/sharpe/dd in rejected strategy log output ([ad2ad3a](https://github.com/TPTBusiness/Predix/commit/ad2ad3ab3360ea75ed3bbc90c12098b9c5cc0114))
-
-## [1.3.2](https://github.com/TPTBusiness/Predix/compare/v1.3.1...v1.3.2) (2026-04-23)
-
-
-### Bug Fixes
-
-* **strategies:** guard against None IC in acceptance check, disable slow wf_rolling ([2197f52](https://github.com/TPTBusiness/Predix/commit/2197f52150a50ef38d9e70991d7e48c8c30caec4))
-* **strategies:** handle None ic/sharpe/dd in rejected strategy log output ([ad2ad3a](https://github.com/TPTBusiness/Predix/commit/ad2ad3ab3360ea75ed3bbc90c12098b9c5cc0114))
-
-## [1.3.1](https://github.com/TPTBusiness/Predix/compare/v1.3.0...v1.3.1) (2026-04-21)
-
-
-### Bug Fixes
-
-* **deps:** bump python-dotenv to >=1.2.2 (CVE symlink overwrite) ([126ae7d](https://github.com/TPTBusiness/Predix/commit/126ae7d5fb556b677d09d10221862a0d648d697a))
-
-## [1.3.0](https://github.com/TPTBusiness/Predix/compare/v1.2.2...v1.3.0) (2026-04-21)
+## 0.0.1 (2024-08-08)
 
 
 ### Features
 
-* **backtest:** add rolling walk-forward validation and Monte Carlo trade permutation test ([637a94c](https://github.com/TPTBusiness/Predix/commit/637a94c1d987da763869f4f9b73372a3f37d873c))
+* Add description for scenario experiments. ([#174](https://github.com/microsoft/RD-Agent/issues/174)) ([fbd8c6d](https://github.com/microsoft/RD-Agent/commit/fbd8c6d87e1424c08997103b8e8fbf264858c4ed))
+* Added QlibFactorFromReportScenario and improved the report-factor loop. ([#161](https://github.com/microsoft/RD-Agent/issues/161)) ([882c79b](https://github.com/microsoft/RD-Agent/commit/882c79bf11583980e646b130f71cfa20201ffc7b))
+* filter feature which is high correlation to former implemented features ([#145](https://github.com/microsoft/RD-Agent/issues/145)) ([e818326](https://github.com/microsoft/RD-Agent/commit/e818326422740e04a4863f7c3c18744dde2ad98f))
+* Remove redundant 'key steps' section in frontend scene display. ([#169](https://github.com/microsoft/RD-Agent/issues/169)) ([e767005](https://github.com/microsoft/RD-Agent/commit/e76700513bee29232c93b97414419df330d9be8d))
+* streamlit webapp demo for different scenarios ([#135](https://github.com/microsoft/RD-Agent/issues/135)) ([d8da7db](https://github.com/microsoft/RD-Agent/commit/d8da7db865e6653fc4740efee9a843b69bd79699))
+* Uploaded Documentation, Updated Prompts & Some Code for model demo ([#144](https://github.com/microsoft/RD-Agent/issues/144)) ([529f935](https://github.com/microsoft/RD-Agent/commit/529f935aa98623f0dc1dda29eecee3ef738dd446))
 
 
 ### Bug Fixes
 
-* **security:** resolve all 30 Bandit security alerts (B301, B614, B104) ([ce5983d](https://github.com/TPTBusiness/Predix/commit/ce5983d9d59c4c34341fb1ec749e44bbcfc4a1c4))
-
-## [1.2.2](https://github.com/TPTBusiness/Predix/compare/v1.2.1...v1.2.2) (2026-04-19)
+* Add framework handling for task coding failure. ([#176](https://github.com/microsoft/RD-Agent/issues/176)) ([5e14fa5](https://github.com/microsoft/RD-Agent/commit/5e14fa54a9dd30a94aebe2643b8c9a3b85517a11))
+* Comprehensive update to factor extraction. ([#143](https://github.com/microsoft/RD-Agent/issues/143)) ([b5ea040](https://github.com/microsoft/RD-Agent/commit/b5ea04019fd5fa15c0f8b9a7e4f18f490f7057d4))
+* first round app folder cleaning ([#166](https://github.com/microsoft/RD-Agent/issues/166)) ([6a5a750](https://github.com/microsoft/RD-Agent/commit/6a5a75021912927deb5e8e4c7ad3ec4b51bfc788))
+* fix pickle problem ([#140](https://github.com/microsoft/RD-Agent/issues/140)) ([7ee4258](https://github.com/microsoft/RD-Agent/commit/7ee42587b60d94417f34332cee395cf210dc8a0e))
+* fix release CI ([#165](https://github.com/microsoft/RD-Agent/issues/165)) ([85d6a5e](https://github.com/microsoft/RD-Agent/commit/85d6a5ed91113fda34ae079b23c89aa24acd2cb2))
+* fix release CI error ([#160](https://github.com/microsoft/RD-Agent/issues/160)) ([1c9f8ef](https://github.com/microsoft/RD-Agent/commit/1c9f8ef287961731944acc9008496b4dddeddca7))
+* fix several bugs in data mining scenario ([#147](https://github.com/microsoft/RD-Agent/issues/147)) ([b233380](https://github.com/microsoft/RD-Agent/commit/b233380e2c66fb030db39424f0f040c86e37f5c4))
+* fix some small bugs in report-factor loop ([#152](https://github.com/microsoft/RD-Agent/issues/152)) ([a79f9f9](https://github.com/microsoft/RD-Agent/commit/a79f9f93406aff6305a76e6a6abd3852642e4c62))
+* fix_release_ci_error ([#150](https://github.com/microsoft/RD-Agent/issues/150)) ([4f82e99](https://github.com/microsoft/RD-Agent/commit/4f82e9960a2638af9d831581185ddd3bac5711fc))
+* Fixed some bugs introduced during refactoring. ([#167](https://github.com/microsoft/RD-Agent/issues/167)) ([f8f1445](https://github.com/microsoft/RD-Agent/commit/f8f1445283fb89aefeb2918243c35a219a51a56c))
+* optimize some prompts in factor loop. ([#158](https://github.com/microsoft/RD-Agent/issues/158)) ([c2c1330](https://github.com/microsoft/RD-Agent/commit/c2c13300b9ad315a663ec2d0eada414e56c6f54f))
 
 
-### Documentation
+### Miscellaneous Chores
 
-* **claude:** auto-merge release-please PR after every push ([f500917](https://github.com/TPTBusiness/Predix/commit/f500917b699ee78dc676e84e01574d49bdc8e796))
-
-## [2.2.0](https://github.com/TPTBusiness/Predix/compare/v2.1.0...v2.2.0) (2026-04-18)
-
-
-### Features
-
-* add Kronos CLI commands, expand tests, document in README ([f911081](https://github.com/TPTBusiness/Predix/commit/f911081d1763d0dc4dd790b57dd97aae2dc62679))
-* **fin_quant:** auto-generate Kronos factor before loop start ([277063f](https://github.com/TPTBusiness/Predix/commit/277063f3e36cd071db859cdc77f69135c1f0763b))
-* integrate Kronos-mini OHLCV foundation model (Option A + B) ([4ae3b99](https://github.com/TPTBusiness/Predix/commit/4ae3b99f2450930f72e202a1a470c407bfde3328))
-
-
-### Bug Fixes
-
-* **kronos:** lazy torch import to fix CI ModuleNotFoundError ([ccc1d27](https://github.com/TPTBusiness/Predix/commit/ccc1d27dbe5ab06a57085a589d456ac7bf49cc08))
-* **kronos:** pass actual datetime Series to Kronos predictor timestamps ([dc6e7ce](https://github.com/TPTBusiness/Predix/commit/dc6e7ce207d21fbc21976f2af7691058530fac2f))
-* **kronos:** replace rdagent_logger with stdlib logging for CI compatibility ([b4558f2](https://github.com/TPTBusiness/Predix/commit/b4558f2456659c6109bd1b3cf100510491cd3e6c))
-
-
-### Performance Improvements
-
-* **kronos:** batch GPU inference via predict_batch — 75x faster ([74611d0](https://github.com/TPTBusiness/Predix/commit/74611d071ac123a655eb15d0737bb73b8c1bd2b0))
-* **kronos:** batch GPU inference via predict_batch — 75x faster ([2babeb9](https://github.com/TPTBusiness/Predix/commit/2babeb95f42828e13a37dc16166c75538f33fd4b))
-
-
-### Documentation
-
-* fix duplicate sections, add hardware requirements and data setup guide ([6c771b3](https://github.com/TPTBusiness/Predix/commit/6c771b37e6f88526a896499e86929cfca2c199eb))
-
-## [2.1.0](https://github.com/TPTBusiness/Predix/compare/v2.0.0...v2.1.0) (2026-04-18)
-
-
-### Features
-
-* add daily log rotation, llama health wait, factor auto-fixer, and README updates ([4ae4d6f](https://github.com/TPTBusiness/Predix/commit/4ae4d6f0f1388d229e44333130306ae05767f2e5))
-* Add GitHub infrastructure, CI/CD pipelines, and examples ([a0b5dc4](https://github.com/TPTBusiness/Predix/commit/a0b5dc464eaac831c76bdbf805cf60c9083e7d80))
-* **factor-coder:** Add critical rules to prevent common factor implementation errors ([a1edca8](https://github.com/TPTBusiness/Predix/commit/a1edca87dd5e75ee402ea555f1b7a07b45c4b1f0))
-* **logging:** write complete LLM prompts and responses to daily JSONL log ([803ef13](https://github.com/TPTBusiness/Predix/commit/803ef13052c645392e71aa5de24874aae83f62a7))
-* **strategy:** Continuous optimization with Optuna parameter injection ([4fda5ea](https://github.com/TPTBusiness/Predix/commit/4fda5eaa31bc570e295ad96380ee2c02b82db706))
-* unified backtest engine, LLM error handling, strategy refactor ([76b9341](https://github.com/TPTBusiness/Predix/commit/76b9341fe8ef0ff03fd911337c299cf0e8582f37))
-
-
-### Bug Fixes
-
-* Add critical column name rules to factor generation prompt ([3e74410](https://github.com/TPTBusiness/Predix/commit/3e7441079f0f1c5867829a365c6e45cd7d2071df))
-* **ci:** fix closed-source asset check false positives in security workflow ([4b83c2b](https://github.com/TPTBusiness/Predix/commit/4b83c2bfe7e90c0c7a11116f07a1b989035b7a3f))
-* **ci:** remove CodeQL workflow (conflicts with default setup), drop duplicate lint job ([a671361](https://github.com/TPTBusiness/Predix/commit/a671361ee4de9a7e00ccc66d8fd5732c2ed1fee9))
-* **ci:** set JAVA_TOOL_OPTIONS UTF-8 in Codacy workflow ([e36721c](https://github.com/TPTBusiness/Predix/commit/e36721c765a02a325b8a7dfd3c262b2aca7b1652))
-* **deps:** pin aiohttp>=3.13.4 to patch 4 CVEs ([81adddc](https://github.com/TPTBusiness/Predix/commit/81adddcfcd14819a1f85c06288a663e7d222a8fb))
-* **optuna:** fix inverted parameter range in Stage 2/3 when signal_bias is negative ([eaf885e](https://github.com/TPTBusiness/Predix/commit/eaf885ec2d20ebd93e34d1e2cb445532d2fb0ed3))
-* **security:** Patch 5 CodeQL path injection and clear-text logging alerts ([#22](https://github.com/TPTBusiness/Predix/issues/22)-[#25](https://github.com/TPTBusiness/Predix/issues/25), [#9](https://github.com/TPTBusiness/Predix/issues/9)) ([d386af9](https://github.com/TPTBusiness/Predix/commit/d386af98205722d1ea6d1465f585e89cb8df47de))
-* **security:** Patch 5 CodeQL path injection and weak hashing alerts ([#25](https://github.com/TPTBusiness/Predix/issues/25)-[#30](https://github.com/TPTBusiness/Predix/issues/30)) ([0d4c3b7](https://github.com/TPTBusiness/Predix/commit/0d4c3b7d69fdbdaafab00940bf7346c8b664928e))
-* **security:** Patch path injection and stack trace exposure (CodeQL [#31](https://github.com/TPTBusiness/Predix/issues/31), [#27](https://github.com/TPTBusiness/Predix/issues/27)) ([b0b8432](https://github.com/TPTBusiness/Predix/commit/b0b84328d13dac5c2ef79961200b011c0b5778f1))
-* **security:** replace relative_to() with realpath+startswith for CodeQL sanitization ([6d70f1e](https://github.com/TPTBusiness/Predix/commit/6d70f1ed944180c44d0eb75c0e86b013e5888b60))
-* **security:** resolve CodeQL path-injection alerts in UI data loaders ([cced426](https://github.com/TPTBusiness/Predix/commit/cced426916cb726e95ad251dcbc0eb9ab6ec3591))
-* **security:** resolve CodeQL path-injection and clear-text-logging alerts ([ec50224](https://github.com/TPTBusiness/Predix/commit/ec50224c3580c5c82ddba02fe77af95efd9667ea))
-* **security:** Resolve GitHub Security Scan alerts ([6c85ba8](https://github.com/TPTBusiness/Predix/commit/6c85ba833a48326e39006e0f73c506b29a594bde))
-* **security:** Upgrade vllm and transformers to patch 4 CVEs ([6c9ba91](https://github.com/TPTBusiness/Predix/commit/6c9ba91d3bf7ce1ed389e544c68be55262bf4e28))
-* **strategy:** Fix template variables, APIBackend import, and JSON extraction ([8220faa](https://github.com/TPTBusiness/Predix/commit/8220faa3de6ea555717ac29ba90a3b68135fbf9e))
-* **strategy:** Re-evaluate Optuna-optimized strategies with full OHLCV backtest ([026edce](https://github.com/TPTBusiness/Predix/commit/026edce122284fb1da467e6e9de8a2b9116c7ace))
-
-
-### Documentation
-
-* Add CLI welcome screenshot to README ([e6f2374](https://github.com/TPTBusiness/Predix/commit/e6f237437595745406c310b58a9bd7214ff914ae))
-* Add comprehensive data setup guide to README ([f721d53](https://github.com/TPTBusiness/Predix/commit/f721d53e5681be6997418c13acc3439897168048))
-* Add conda requirement to README + fix predix CLI ([df45698](https://github.com/TPTBusiness/Predix/commit/df45698b20e0a3e6e0079decf2b8eecb6983a175))
-* Clean changelog of closed-source performance metrics ([a0f6587](https://github.com/TPTBusiness/Predix/commit/a0f6587ab1724293924da07fe18c40891ca612a1))
-* improve README badges, fix llama-server flags, clean up structure ([336e1a5](https://github.com/TPTBusiness/Predix/commit/336e1a5afb4933ec13572ef050a3e5a2ca183400))
+* release 0.0.1 ([1feacd3](https://github.com/microsoft/RD-Agent/commit/1feacd39b21193de11e9bbecf880ddf96d7c261c))

CODE_OF_CONDUCT.md

@@ -1,71 +1,9 @@
-# Contributor Covenant Code of Conduct
+# Microsoft Open Source Code of Conduct
 
-## Our Pledge
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, religion, or sexual identity
-and orientation.
+Resources:
 
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
-  overall community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or
-  advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
-  address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-nico@predix.io.
-All complaints will be reviewed and investigated promptly and fairly.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.0, available at
-https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
-
-Community Impact Guidelines were inspired by [Mozilla's code of conduct
-enforcement ladder](https://github.com/mozilla/diversity).
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see the FAQ at
-https://www.contributor-covenant.org/faq. Translations are available at
-https://www.contributor-covenant.org/translations.
+- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
+- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
+- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns

CONTRIBUTING.md

@@ -1,166 +0,0 @@
-# Contributing to Predix
-
-We welcome contributions and suggestions to improve Predix. Whether it's solving an issue, addressing a bug, enhancing documentation, or even correcting a typo, every contribution is valuable and helps improve the project.
-
-## Getting Started
-
-To get started, you can explore the issues list or search for `TODO:` comments in the codebase by running:
-```sh
-grep -r "TODO:"
-```
-
-## Development Workflow
-
-### 1. Fork and Clone
-
-```bash
-# Fork the repository on GitHub, then clone your fork
-git clone https://github.com/YOUR-USERNAME/Predix.git
-cd Predix
-
-# Add upstream remote
-git remote add upstream https://github.com/TPTBusiness/Predix.git
-```
-
-### 2. Create a Branch
-
-```bash
-# Use conventional commit prefixes in branch names
-git checkout -b feat/your-feature-name
-# or
-git checkout -b fix/bug-description
-git checkout -b docs/documentation-update
-git checkout -b refactor/code-cleanup
-```
-
-**Branch naming convention:**
-- `feat/` - New features
-- `fix/` - Bug fixes
-- `docs/` - Documentation changes
-- `refactor/` - Code refactoring
-- `test/` - Test additions/fixes
-- `chore/` - Maintenance tasks
-
-### 3. Make Your Changes
-
-Follow the project conventions:
-
-- **Code style**: Use type hints, docstrings (Google style), and 120 char line limit
-- **Language**: All comments and documentation MUST be in English
-- **Structure**: Follow the existing module structure
-
-### 4. Write Tests
-
-**MANDATORY:** All new features MUST have tests with >80% coverage.
-
-```bash
-# Run tests
-pytest test/ -v
-
-# Run with coverage
-pytest --cov=rdagent --cov-report=html
-
-# Run integration tests
-pytest test/integration/ -v
-```
-
-### 5. Run Pre-commit Hooks
-
-Pre-commit hooks run automatically before EVERY commit:
-
-```bash
-# Install pre-commit
-pre-commit install
-
-# Run manually
-pre-commit run --all-files
-```
-
-### 6. Commit Your Changes
-
-Use [Conventional Commits](https://www.conventionalcommits.org/) format:
-
-```bash
-git commit -m "type: description"
-
-# Types:
-# feat:     New feature
-# fix:      Bug fix
-# docs:     Documentation
-# style:    Formatting
-# refactor: Code restructuring
-# test:     Tests
-# chore:    Maintenance
-```
-
-**Examples:**
-```bash
-git commit -m "feat: Add Optuna hyperparameter optimization"
-git commit -m "fix: Resolve database connection timeout"
-git commit -m "docs: Update README with new CLI commands"
-git commit -m "test: Add integration tests for portfolio optimizer"
-```
-
-### 7. Push and Create a Pull Request
-
-```bash
-git push origin your-branch-name
-```
-
-Then open a Pull Request on GitHub with:
-- Clear title (use conventional commit format)
-- Description of changes
-- Link to related issues
-- Screenshots (for UI changes)
-
-## Code Review Process
-
-All PRs are reviewed by maintainers. Expect:
-- Automated checks (tests, linting, security scan)
-- Code review by maintainers
-- Possible requested changes
-
-## Important Rules
-
-### 🚫 NEVER COMMIT
-
-- `.env` files or API keys
-- Generated data (`results/`, `*.db`, `*.log`)
-- Closed-source assets (`models/local/`, `prompts/local/`)
-- JSON strategy files in root directory
-- Private credentials or tokens
-
-### ✅ ALWAYS DO
-
-- Write tests for new features
-- Update documentation for user-visible changes
-- Run `pre-commit run --all-files` before pushing
-- Keep commit messages in English
-- Follow conventional commit format
-
-## Project Structure
-
-```
-Predix/
-├── rdagent/                 # Core framework (open source)
-│   ├── app/                 # CLI and scenario apps
-│   ├── components/          # Reusable agent components
-│   └── scenarios/           # Domain-specific scenarios
-├── test/                    # Test suite
-├── docs/                    # Documentation
-├── scripts/                 # Utility scripts
-├── prompts/                 # LLM prompts
-├── models/                  # ML models (standard only)
-├── constraints/             # Python version constraints
-└── requirements/            # Dependency files
-```
-
-## Need Help?
-
-- **Issues**: [GitHub Issues](https://github.com/TPTBusiness/Predix/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/TPTBusiness/Predix/discussions)
-- **Documentation**: See `docs/` folder
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the MIT License.

LICENSE

@@ -1,21 +1,21 @@
-MIT License
+    MIT License
 
-Copyright (c) 2025 Predix Team
+    Copyright (c) Microsoft Corporation.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

Makefile

@@ -0,0 +1,209 @@
+.PHONY: clean deepclean install init-qlib-env dev constraints black isort mypy ruff toml-sort lint pre-commit test-run test build upload docs-autobuild changelog docs-gen docs-mypy docs-coverage docs
+#You can modify it according to your terminal
+SHELL := /bin/bash
+
+########################################################################################
+# Variables
+########################################################################################
+
+# Determine whether to invoke pipenv based on CI environment variable and the availability of pipenv.
+PIPRUN := $(shell [ "$$CI" != "true" ] && command -v pipenv > /dev/null 2>&1 && echo "pipenv run")
+
+# Get the Python version in `major.minor` format, using the environment variable or the virtual environment if exists.
+PYTHON_VERSION := $(shell echo $${PYTHON_VERSION:-$$(python -V 2>&1 | cut -d ' ' -f 2)} | cut -d '.' -f 1,2)
+
+# Determine the constraints file based on the Python version.
+CONSTRAINTS_FILE := constraints/$(PYTHON_VERSION).txt
+
+# Documentation target directory, will be adapted to specific folder for readthedocs.
+PUBLIC_DIR := $(shell [ "$$READTHEDOCS" = "True" ] && echo "$$READTHEDOCS_OUTPUT/html" || echo "public")
+
+# URL and Path of changelog source code.
+CHANGELOG_URL := $(shell echo $${CI_PAGES_URL:-https://microsoft.github.io/rdagent}/_sources/changelog.md.txt)
+CHANGELOG_PATH := docs/changelog.md
+
+########################################################################################
+# Development Environment Management
+########################################################################################
+
+# Remove common intermediate files.
+clean:
+	-rm -rf \
+		$(PUBLIC_DIR) \
+		.coverage \
+		.mypy_cache \
+		.pytest_cache \
+		.ruff_cache \
+		Pipfile* \
+		coverage.xml \
+		dist \
+		release-notes.md
+	find . -name '*.egg-info' -print0 | xargs -0 rm -rf
+	find . -name '*.pyc' -print0 | xargs -0 rm -f
+	find . -name '*.swp' -print0 | xargs -0 rm -f
+	find . -name '.DS_Store' -print0 | xargs -0 rm -f
+	find . -name '__pycache__' -print0 | xargs -0 rm -rf
+
+# Remove pre-commit hook, virtual environment alongside itermediate files.
+deepclean: clean
+	if command -v pre-commit > /dev/null 2>&1; then pre-commit uninstall --hook-type pre-push; fi
+	if command -v pipenv >/dev/null 2>&1 && pipenv --venv >/dev/null 2>&1; then pipenv --rm; fi
+
+# Install the package in editable mode.
+install:
+	$(PIPRUN) pip install -e . -c $(CONSTRAINTS_FILE)
+
+# Install the package in editable mode with specific optional dependencies.
+dev-%:
+	$(PIPRUN) pip install -e .[$*] -c $(CONSTRAINTS_FILE)
+
+# Prepare the development environment.
+# Build submodules.
+# Install the pacakge in editable mode with all optional dependencies and pre-commit hook.
+init-qlib-env:
+	# note: You may need to install torch manually
+	# todo: downgrade ruamel.yaml in pyqlib
+	conda create -n qlibRDAgent python=3.8 -y
+	@source $$(conda info --base)/etc/profile.d/conda.sh && conda activate qlibRDAgent && which pip && pip install pyqlib && pip install ruamel-yaml==0.17.21 && pip install torch==2.1.1 && pip install catboost==0.24.3 && conda deactivate
+
+dev:
+	$(PIPRUN) pip install -e .[docs,lint,package,test] -c $(CONSTRAINTS_FILE)
+	if [ "$(CI)" != "true" ] && command -v pre-commit > /dev/null 2>&1; then pre-commit install --hook-type pre-push; fi
+
+# Generate constraints for current Python version.
+constraints: deepclean
+	$(PIPRUN) --python $(PYTHON_VERSION) pip install --upgrade -e .[docs,lint,package,test]
+	$(PIPRUN) pip freeze --exclude-editable > $(CONSTRAINTS_FILE)
+
+########################################################################################
+# Lint and pre-commit
+########################################################################################
+
+# Check lint with black.
+black:
+	$(PIPRUN) python -m black --check --diff . --extend-exclude test/scripts --extend-exclude git_ignore_folder -l 120
+
+# Check lint with isort.
+isort:
+	$(PIPRUN) python -m isort --check . -s git_ignore_folder -s test/scripts
+
+# Check lint with mypy.
+# First deal with the core folder, and then gradually increase the scope of detection,
+# and eventually realize the detection of the complete project.
+mypy:
+	$(PIPRUN) python -m mypy rdagent/core   #  --exclude rdagent/scripts,git_ignore_folder
+
+# Check lint with ruff.
+# First deal with the core folder, and then gradually increase the scope of detection,
+# and eventually realize the detection of the complete project.
+ruff:
+	$(PIPRUN) ruff check rdagent/core --ignore FBT001,FBT002   # --exclude rdagent/scripts,git_ignore_folder
+
+# Check lint with toml-sort.
+toml-sort:
+	$(PIPRUN) toml-sort --check pyproject.toml
+
+# Check lint with all linters.
+# Prioritize fixing isort, then black, otherwise you'll get weird and unfixable black errors.
+# lint: mypy ruff
+lint: mypy ruff isort black toml-sort
+
+# Run pre-commit with autofix against all files.
+pre-commit:
+	pre-commit run --all-files
+
+########################################################################################
+# Auto Lint
+########################################################################################
+
+# Auto lint with black.
+auto-black:
+	$(PIPRUN) python -m black . --extend-exclude test/scripts --extend-exclude git_ignore_folder -l 120
+
+# Auto lint with isort.
+auto-isort:
+	$(PIPRUN) python -m isort . -s git_ignore_folder -s test/scripts
+
+# Auto lint with toml-sort.
+auto-toml-sort:
+	$(PIPRUN) toml-sort pyproject.toml
+
+# Auto lint with all linters.
+auto-lint: auto-isort auto-black auto-toml-sort
+
+########################################################################################
+# Test
+########################################################################################
+
+# Clean and run test with coverage.
+test-run:
+	$(PIPRUN) python -m coverage erase
+	$(PIPRUN) python -m coverage run --concurrency=multiprocessing -m pytest --ignore test/scripts
+	$(PIPRUN) python -m coverage combine
+
+# Generate coverage report for terminal and xml.
+test: test-run
+	$(PIPRUN) python -m coverage report --fail-under 80
+	$(PIPRUN) python -m coverage xml --fail-under 80
+
+########################################################################################
+# Package
+########################################################################################
+
+# Build the package.
+build:
+	$(PIPRUN) python -m build
+
+# Upload the package.
+upload:
+	$(PIPRUN) python -m twine upload dist/*
+
+########################################################################################
+# Documentation
+########################################################################################
+
+# Generate documentation with auto build when changes happen.
+docs-autobuild:
+	$(PIPRUN) python -m sphinx_autobuild docs $(PUBLIC_DIR) \
+		--watch README.md \
+		--watch rdagent
+
+# Generate changelog from git commits.
+# The -c and -s arguments should match
+# If -c uses Basic (default, inherits from base class), -s optional argument: # If -c uses conventional (inherits from base class), -s optional parameter: add,fix,change,remove,merge,doc
+# If -c uses conventional (inherits from base class), -s is optional: build,chore,ci,deps,doc,docs,feat,fix,perf,ref,refactor,revert,style,test,tests
+# If -c uses angular (inherits from conventional), -s optional argument: build,chore,ci,deps,doc,docs,feat,fix,perf,ref,refactor,revert,style,test,tests
+# NOTE(xuan.hu): Need to be run before document generation to take effect.
+# $(PIPRUN) git-changelog -ETrio $(CHANGELOG_PATH) -c conventional -s build,chore,ci,docs,feat,fix,perf,refactor,revert,style,test
+changelog:
+	@if wget -q --spider $(CHANGELOG_URL); then \
+		echo "Existing Changelog found at '$(CHANGELOG_URL)', download for incremental generation."; \
+		wget -q -O $(CHANGELOG_PATH) $(CHANGELOG_URL); \
+	fi
+	$(PIPRUN) LATEST_TAG=$$(git tag --sort=-creatordate | head -n 1); \
+	git-changelog --bump $$LATEST_TAG -Tio docs/changelog.md -c conventional -s build,chore,ci,deps,doc,docs,feat,fix,perf,ref,refactor,revert,style,test,tests
+
+# Generate release notes from changelog.
+release-notes:
+	@$(PIPRUN) git-changelog --input $(CHANGELOG_PATH) --release-notes
+
+# Build documentation only from rdagent.
+docs-gen:
+	$(PIPRUN) python -m sphinx.cmd.build docs $(PUBLIC_DIR)
+
+# Generate mypy reports.
+docs-mypy: docs-gen
+	$(PIPRUN) python -m mypy rdagent test --exclude git_ignore_folder --exclude rdagent/scripts --html-report $(PUBLIC_DIR)/reports/mypy
+
+# Generate html coverage reports with badge.
+docs-coverage: test-run docs-gen
+	$(PIPRUN) python -m coverage html -d $(PUBLIC_DIR)/reports/coverage --fail-under 80
+	$(PIPRUN) bash scripts/generate-coverage-badge.sh $(PUBLIC_DIR)/_static/badges
+
+# Generate all documentation with reports.
+docs: changelog docs-gen docs-mypy docs-coverage
+
+
+########################################################################################
+# End
+########################################################################################

README.md

@@ -1,576 +1,205 @@
-# Predix
-
-<p align="center">
-  <img src="https://img.shields.io/badge/Python-3.10%20|%203.11-blue?style=for-the-badge&logo=python" alt="Python">
-  <img src="https://img.shields.io/badge/Platform-Linux-lightgrey?style=for-the-badge&logo=linux" alt="Platform">
-  <img src="https://img.shields.io/badge/PyTorch-2.0+-red?style=for-the-badge&logo=pytorch" alt="PyTorch">
-  <img src="https://img.shields.io/badge/Optuna-3.5+-009B77?style=for-the-badge&logo=optuna" alt="Optuna">
-</p>
-
-<p align="center">
-  <img src="https://img.shields.io/badge/Pandas-150458?style=for-the-badge&logo=pandas" alt="Pandas">
-  <img src="https://img.shields.io/badge/LightGBM-00A1E0?style=for-the-badge" alt="LightGBM">
-  <img src="https://img.shields.io/badge/Qlib-FF6B6B?style=for-the-badge" alt="Qlib">
-  <img src="https://img.shields.io/badge/llama.cpp-7B68EE?style=for-the-badge" alt="llama.cpp">
-</p>
-
-<h4 align="center">
-  <strong>AI-powered Quantitative Trading Agent for EUR/USD Forex</strong>
-</h4>
-
-<p align="center">
-  <a href="#installation">Installation</a> •
-  <a href="#no-gpu-use-openrouter">No GPU?</a> •
-  <a href="#quick-start">Quick Start</a> •
-  <a href="#configuration">Configuration</a> •
-  <a href="#features">Features</a>
-</p>
-
-<p align="center">
-  <a href="https://github.com/TPTBusiness/Predix/actions/workflows/ci.yml">
-    <img src="https://img.shields.io/github/actions/workflow/status/TPTBusiness/Predix/ci.yml?branch=master&label=CI&logo=github&style=flat-square" alt="CI Status">
-  </a>
-  <a href="https://github.com/TPTBusiness/Predix/actions/workflows/codacy.yml">
-    <img src="https://img.shields.io/github/actions/workflow/status/TPTBusiness/Predix/codacy.yml?branch=master&label=Security&logo=shield&style=flat-square" alt="Security Scan">
-  </a>
-  <a href="https://codecov.io/gh/TPTBusiness/Predix">
-    <img src="https://img.shields.io/codecov/c/github/TPTBusiness/Predix?style=flat-square&logo=codecov" alt="Coverage">
-  </a>
-  <a href="https://github.com/TPTBusiness/Predix/blob/master/LICENSE">
-    <img src="https://img.shields.io/github/license/TPTBusiness/Predix?style=flat-square" alt="License">
-  </a>
-  <a href="https://www.conventionalcommits.org/">
-    <img src="https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow?style=flat-square" alt="Conventional Commits">
-  </a>
-  <a href="https://github.com/astral-sh/ruff">
-    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=flat-square" alt="Ruff">
-  </a>
-  <a href="https://github.com/TPTBusiness/Predix/stargazers">
-    <img src="https://img.shields.io/github/stars/TPTBusiness/Predix?style=flat-square" alt="Stars">
-  </a>
-  <a href="https://github.com/TPTBusiness/Predix/forks">
-    <img src="https://img.shields.io/github/forks/TPTBusiness/Predix?style=flat-square" alt="Forks">
-  </a>
-  <a href="https://github.com/TPTBusiness/Predix/issues">
-    <img src="https://img.shields.io/github/issues/TPTBusiness/Predix?style=flat-square" alt="Issues">
-  </a>
-  <a href="https://github.com/TPTBusiness/Predix/commits/master">
-    <img src="https://img.shields.io/github/last-commit/TPTBusiness/Predix?style=flat-square" alt="Last Commit">
-  </a>
-</p>
+[![CI](https://github.com/microsoft/RD-Agent/actions/workflows/ci.yml/badge.svg)](https://github.com/microsoft/RD-Agent/actions/workflows/ci.yml)
+[![CodeQL](https://github.com/microsoft/RD-Agent/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/microsoft/RD-Agent/actions/workflows/github-code-scanning/codeql)
+[![Dependabot Updates](https://github.com/microsoft/RD-Agent/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/microsoft/RD-Agent/actions/workflows/dependabot/dependabot-updates)
+[![Lint PR Title](https://github.com/microsoft/RD-Agent/actions/workflows/pr.yml/badge.svg)](https://github.com/microsoft/RD-Agent/actions/workflows/pr.yml)
+[![Readthedocs Preview](https://github.com/microsoft/RD-Agent/actions/workflows/readthedocs-preview.yml/badge.svg)](https://github.com/microsoft/RD-Agent/actions/workflows/readthedocs-preview.yml)
+[![Release.yml](https://github.com/microsoft/RD-Agent/actions/workflows/release.yml/badge.svg)](https://github.com/microsoft/RD-Agent/actions/workflows/release.yml)
+[![Release](https://img.shields.io/github/v/release/microsoft/RD-Agent)](https://github.com/microsoft/RD-Agent/releases)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
+[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+<!-- TODO: License / pypi / PyPI - Python Version  --> 
 
----
+# 📰 News
+| 🗞️News        | 📝Description                 |
+| --            | ------                        |
+| First release | RDAgent are release on Github |
 
-## 🖥️ CLI Dashboard
 
-```bash
-rdagent predix
-```
+# 🌟 Introduction
 
-![Predix CLI Welcome Screen](docs/cli-welcome-screen.png)
+![Our focused scenario](docs/_static/scen.jpg)
 
-*The Predix CLI shows system status, available commands, and quick start guide.*
+RDAgent aims to automate the most critical and valuable aspects of the industrial R&D process, and we begins with focusing on the data-driven scenarios to streamline the development of models and data. 
+Methodologically, we have identified a framework with two key components: 'R' for proposing new ideas and 'D' for implementing them.
+We believe that the automatic evolution of R&D will lead to solutions of significant industrial value.
 
----
 
-## Overview
+<!-- Tag Cloud -->
+R&D is a very general scenario. The advent of RDAgent can be your
+- [🎥Automatic Quant Factory]()
+- 🤖Data mining agent: iteratively proposing [🎥data]() & [models]() and implementing them by gaining knowledge from data.
+- 🦾Research copilot: Auto read [🎥research papers]()/[🎥reports]() and implement model structures or building datasets.
+- ...
 
-**Predix** is an autonomous AI agent for quantitative trading strategies in the EUR/USD forex market. Built on a multi-agent framework, Predix automates the full research and development cycle:
+You can click the [🎥link]() above to view the demo. More methods and scenarios are being added to the project to empower your R&D processes and boost productivity.
 
-- 📊 **Data Analysis** – Automatically analyzes market patterns and microstructure
-- 💡 **Strategy Discovery** – Proposes novel trading factors and signals
-- 🧠 **Model Evolution** – Iteratively improves predictive models
-- 📈 **Backtesting** – Validates strategies on historical 1-minute data
+We have a quick 🎥demo for one use case of RDAgent.
+- TODO: Demo
 
-Predix is optimized for **1-minute EUR/USD FX data** (2020–2026) and uses Qlib as the underlying backtesting engine.
 
-## Acknowledgments
+# ⚡Quick start
+You can try our demo by running the following command:
 
-This project draws inspiration from various open-source projects in the AI trading and multi-agent systems space. We thank all the authors for their innovative work that helped shape our understanding of these patterns.
+### 🐍 Create a Conda Environment
+- Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
+  ```sh
+  conda create -n rdagent python=3.10
+  ```
+- Activate the environment:
+  ```sh
+  conda activate rdagent
+  ```
 
-Special thanks to:
+### 🛠️ Run Make Files
+TODO: `pip install rdagent` in the future.
 
-- **[Microsoft RD-Agent](https://github.com/microsoft/RD-Agent)** (MIT License) - Foundation for our autonomous R&D agent framework. We extend our gratitude to the RD-Agent team for their excellent foundational work.
+- **Navigate to the directory containing the MakeFile** and set up the development environment:
+  ```sh
+  make dev
+  ```
 
-- **[TradingAgents](https://github.com/TauricResearch/TradingAgents)** (Apache 2.0 License) - Inspiration for our multi-agent debate system, reflection mechanism, and memory management modules.
+### 📦 Install Pytorch
+TODO: use docker in quick start intead.
 
-- **[ai-hedge-fund](https://github.com/virattt/ai-hedge-fund)** - Inspiration for macro analysis (Stanley Druckenmiller agent), risk management concepts, and market regime detection.
+- Install Pytorch and related libraries:
+  ```sh
+  pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
+  pip3 install torch_geometric
+  ```
 
-All code in Predix is originally written and implemented independently. Predix extends these frameworks with EUR/USD forex-specific features, 1-minute backtesting capabilities, comprehensive risk management, and trading dashboards.
+### ⚙️ Environment Configuration
+- Place the `.env` file in the same directory as the `.env.example` file.
+  - The `.env.example` file contains the environment variables required for users using the OpenAI API (Please note that `.env.example` is an example file. `.env` is the one that will be finally used.)
+  - please refer to [Configuration](docs/build/html/installation.html#azure-openai) for the detailed explanation of the `.env`
+- Export each variable in the `.env` file:
+  ```sh
+  export $(grep -v '^#' .env | xargs)
+  ```
+### 🚀 Run the Application
+TODO: run the front-page demo.
 
----
+The [🎥demo]() is implemented by the above commands.
 
-## Installation
+- Run the factor extraction and implementation application based on financial reports:
+  ```sh
+  python rdagent/app/qlib_rd_loop/factor_from_report_sh.py
+  ```
 
-### System Requirements
+- Run the self-loop factor extraction and implementation application:
+  ```sh
+  python rdagent/app/qlib_rd_loop/factor.py
+  ```
 
-| Component | Minimum | Recommended |
-|-----------|---------|-------------|
-| **GPU VRAM** | 8 GB | 16 GB (RTX 4080 / 5060 Ti) |
-| **RAM** | 16 GB | 32 GB |
-| **Storage** | 20 GB | 50 GB (models + data) |
-| **OS** | Linux (Ubuntu 22.04+) | Linux |
-| **CUDA** | 12.0+ | 12.4+ |
+- Run the self-loop model extraction and implementation application:
+  ```sh
+  python rdagent/app/qlib_rd_loop/model.py
+  ```
 
-> Local LLMs require a CUDA-capable GPU. The default model (Qwen3.6-35B Q3) uses ~13.6 GB VRAM. CPU-only inference is possible but very slow (not recommended for production use).
 
-### Prerequisites
+# Scenarios
 
-- **Conda** (Miniconda or Anaconda) — required for environment management
-- **Docker** — required for sandboxed factor/model code execution (`docker run hello-world` to verify)
-- **llama.cpp** — for local LLM inference (see [llama.cpp build guide](https://github.com/ggml-org/llama.cpp))
-- **Ollama** — for embeddings (`nomic-embed-text`); install from [ollama.com](https://ollama.com) and run `ollama pull nomic-embed-text`
-- **Linux** — officially supported; macOS/Windows may work with adjustments
+We have applied RD-Agent to multiple valuable data-driven industrial scenarios..
 
-### Quick Install
 
-```bash
-# Clone repository
-git clone https://github.com/TPTBusiness/Predix
-cd Predix
+## 🎯 Goal: Agent for Data-driven R&D
 
-# Create and activate conda environment
-conda create -n predix python=3.10 -y
-conda activate predix
+In this project, we are aiming to build a Agent to automate Data-Driven R\&D that can
++ 📄Read real-world material (reports, papers, etc.) and **extract** key formulas, descriptions of interested **features** and **models**, which are the key components of data-driven R&D .
++ 🛠️**Implement** the extracted formulas (e.g., features, factors, and models) in runnable codes.
+   + Due to the limited ability of LLM in implementing at once, evolve the agent to be able to extend abilities by learning from feedback and knowledge and improve the agent's ability to implement more complex models.
++ 💡Propose **new ideas** based on current knowledge and observations.
 
-# Install in editable mode
-pip install -e .
+<!-- ![Data-Centric R&D Overview](docs/_static/overview.png) -->
 
-# Verify Docker is accessible
-docker run --rm hello-world
-```
+## 📈 Scenarios/Demos
 
-> **Important:** Predix requires a conda environment to manage dependencies properly.
-> Using plain Python or other environment managers may cause conflicts.
+In the two key areas of data-driven scenarios, model implementation and data building, our system aims to serve two main roles: 🦾copilot and 🤖agent. 
+- The 🦾copilot follows human instructions to automate repetitive tasks. 
+- The 🤖agent, being more autonomous, actively proposes ideas for better results in the future.
 
----
+The supported scenarios are listed below:
 
-## Data Setup
+| Scenario/Target | Model Implementation                   | Data Building                                                                      |
+| --              | --                                     | --                                                                                 |
+| 💹 Finance      | 🤖Iteratively Proposing Ideas & Evolving | - 🦾Auto reports reading & implementation <br/> - 🤖Iteratively Proposing Ideas & Evolving |
+| 🩺 Medical      | 🤖Iteratively Proposing Ideas & Evolving | -                                                                                  |
+| 🏭 General      | 🦾Auto paper reading & implementation    | -                                                                                  |
 
-Predix requires **1-minute EUR/USD OHLCV data** in HDF5 format. This is a hard prerequisite — the system cannot run without it.
+Different scenarios vary in entrance and configuration. Please check the detailed setup tutorial in the scenarios documents.
 
-### Step 1: Get the data
+TODO: Scenario Gallary
+- map(scenario) => knowledge list;
 
-Download 1-minute EUR/USD data (2020–present) from any of these free sources:
+# ⚙️Framework
 
-| Source | Cost | Notes |
-|--------|------|-------|
-| **[Dukascopy](https://www.dukascopy.com/swiss/english/marketfeed/historical/)** | Free | Best quality free EUR/USD tick data |
-| **[OANDA API](https://developer.oanda.com/)** | Free (demo) | Requires API key, programmatic access |
-| **[TrueFX](https://truefx.com/)** | Free | Institutional-quality tick data |
-| **[Kaggle](https://www.kaggle.com/datasets?search=EURUSD+1min)** | Free | Search "EURUSD 1 minute" |
-| **MetaTrader 5** | Free | Export via `copy_rates_range()` |
+![image](https://github.com/user-attachments/assets/98fce923-77ab-4982-93c8-a7a01aece766)
 
-### Step 2: Convert to HDF5
 
-```python
-import pandas as pd
+Automating the R&D process in data science is a highly valuable yet underexplored area in industry. We propose a framework to push the boundaries of this important research field.
 
-df = pd.read_csv('eurusd_1min.csv', parse_dates=['datetime'])
-df = df.rename(columns={'open': '$open', 'close': '$close',
-                        'high': '$high', 'low': '$low', 'volume': '$volume'})
-df['instrument'] = 'EURUSD'
-df = df.set_index(['datetime', 'instrument'])
-for col in ['$open', '$close', '$high', '$low', '$volume']:
-    df[col] = df[col].astype('float32')
+The research questions within this framework can be divided into three main categories:
+| Research Area | Paper/Work List |
+|--------------------|-----------------|
+| Benchmark the R&D abilities | [Benchmark](#benchmark) |
+| Idea proposal: Explore new ideas or refine existing ones | [Research](#research) |
+| Ability to realize ideas: Implement and execute ideas | [Development](#development) |
 
-import os
-os.makedirs('git_ignore_folder/factor_implementation_source_data', exist_ok=True)
-df.to_hdf('git_ignore_folder/factor_implementation_source_data/intraday_pv.h5', key='data', mode='w')
-```
+We believe that the key to delivering high-quality solutions lies in the ability to evolve R&D capabilities. Agents should learn like human experts, continuously improving their R&D skills.
 
-### Required HDF5 format
 
-| Field | Type | Description |
-|-------|------|-------------|
-| **Index** | MultiIndex `(datetime, instrument)` | Timestamp + currency pair |
-| **`$open`** | float32 | Open price |
-| **`$close`** | float32 | Close price |
-| **`$high`** | float32 | High price |
-| **`$low`** | float32 | Low price |
-| **`$volume`** | float32 | Tick volume |
+# 📃Paper/Work list
 
-**Save location:** `git_ignore_folder/factor_implementation_source_data/intraday_pv.h5`
-
----
-
-## Configuration
-
-### Environment Setup
-
-Create a `.env` file in the project root:
-
-```bash
-# Local LLM (llama.cpp)
-OPENAI_API_KEY=local
-OPENAI_API_BASE=http://localhost:8081/v1
-CHAT_MODEL=qwen3.5-35b
-
-# Embedding (Ollama)
-LITELLM_PROXY_API_KEY=local
-LITELLM_PROXY_API_BASE=http://localhost:11434/v1
-EMBEDDING_MODEL=nomic-embed-text
-
-# Paths
-QLIB_DATA_DIR=~/.qlib/qlib_data/eurusd_1min_data
-```
-
-### LLM Server (llama.cpp)
-
-```bash
-~/llama.cpp/build/bin/llama-server \
-  --model ~/models/qwen3.6/Qwen3.6-35B-A3B-UD-Q3_K_XL.gguf \
-  --n-gpu-layers 24 \
-  --no-mmap \
-  --port 8081 \
-  --ctx-size 240000 \
-  --parallel 2 \
-  --batch-size 512 --ubatch-size 512 \
-  --host 0.0.0.0 \
-  -ctk q4_0 -ctv q4_0 \
-  --reasoning off
-```
-
-> **Important flags:**
-> - `--ctx-size 240000 --parallel 2` — allocates **2 slots × 120,000 tokens each**. `fin_quant` prompts can reach 80k+ tokens with full factor history; a smaller slot causes silent overflow and empty responses.
-> - `--reasoning off` — **critical**: completely disables Qwen3 chain-of-thought. `--reasoning-budget 0` is not sufficient and produces empty JSON responses.
-> - `--n-gpu-layers 24` — 4 fewer than maximum on RTX 5060 Ti (16 GB), freeing ~500 MB VRAM for the larger KV cache.
-> - `-ctk q4_0 -ctv q4_0` — quantises the KV cache to 4-bit, reducing VRAM from ~5 GB to ~1.3 GB at 240k context.
-
-### Data Configuration
-
-Edit [`data_config.yaml`](data_config.yaml) to customize walk-forward splits:
-
-```yaml
-instrument: EURUSD
-frequency: 1min
-data_path: ~/.qlib/qlib_data/eurusd_1min_data
-
-train_start: "2022-03-14"
-train_end:   "2024-06-30"
-valid_start: "2024-07-01"
-valid_end:   "2024-12-31"
-test_start:  "2025-01-01"
-test_end:    "2026-03-20"
-
-market_context:
-  spread_bps: 1.5
-  target_arr: 9.62
-  max_drawdown: 20
-```
-
----
-
-## No GPU? Use OpenRouter
-
-If you don't have a CUDA-capable GPU, you can run Predix using [OpenRouter](https://openrouter.ai) for LLM inference — no local model download required.
-
-**1. Set up `.env` for OpenRouter:**
-
-```bash
-# Chat (OpenRouter)
-OPENAI_API_KEY=sk-or-v1-<your-openrouter-key>
-OPENAI_API_BASE=https://openrouter.ai/api/v1
-CHAT_MODEL=qwen/qwen3-235b-a22b
-
-# Embedding (Ollama — still required locally)
-LITELLM_PROXY_API_KEY=local
-LITELLM_PROXY_API_BASE=http://localhost:11434/v1
-EMBEDDING_MODEL=nomic-embed-text
-```
-
-**2. Skip the llama-server step** — no local LLM server needed.
-
-**3. Run with the OpenRouter backend:**
-
-```bash
-rdagent fin_quant --model openrouter
-```
-
-**4. Parallel runs** (uses API concurrency instead of GPU slots):
-
-```bash
-python predix_parallel.py --runs 5 --api-keys 1 -m openrouter
-```
-
-> Ollama is still required for embeddings even in the OpenRouter path. Install from [ollama.com](https://ollama.com) and run `ollama pull nomic-embed-text` once.
-
----
-
-## Quick Start
-
-### Prerequisites checklist
-
-```bash
-# 1. Docker running?
-docker run --rm hello-world
-
-# 2. Data in place?
-ls git_ignore_folder/factor_implementation_source_data/intraday_pv.h5
-
-# 3. LLM server running?
-curl http://localhost:8081/health
-```
-
-### 1. Run Trading Loop
-
-```bash
-conda activate predix
-rdagent fin_quant
-# or with explicit options:
-rdagent fin_quant --loop-n 5 --step-n 2
-```
-
-### 2. Monitor Results
-
-```bash
-# Web dashboard
-rdagent server_ui --port 19899 --log-dir git_ignore_folder/RD-Agent_workspace/
-# then open http://127.0.0.1:19899
-
-# Best strategies so far
-python predix.py best
-```
-
-### 3. Run Continuously
-
-```bash
-while true; do
-    rdagent fin_quant
-    sleep 5
-done
-```
-
----
-
-## CLI Commands
-
-### Factor & Strategy Loop
-
-| Command | Description |
-|---------|-------------|
-| `rdagent fin_quant` | Start autonomous factor + model evolution loop |
-| `rdagent fin_quant --loop-n 5` | Run exactly 5 evolution loops |
-| `rdagent fin_quant --with-dashboard` | Start with web dashboard |
-| `rdagent fin_quant --cli-dashboard` | Start with CLI Rich dashboard |
-| `rdagent fin_factor` | Factor-only evolution |
-| `rdagent fin_model` | Model-only evolution |
-
-### Strategy Reports
-
-| Command | Description |
-|---------|-------------|
-| `python predix.py best` | Show top strategies by composite score |
-| `python predix.py best -n 20 -m sharpe` | Top 20 by Sharpe ratio |
-| `python predix.py best --show NAME` | Full metadata for one strategy |
-| `python predix_gen_strategies_real_bt.py` | Generate 10 strategies with LLM + real backtest |
-| `python predix_gen_strategies_real_bt.py 20` | Generate 20 strategies |
-
-### Kronos Foundation Model
-
-| Command | Description |
-|---------|-------------|
-| `python predix.py kronos-factor` | Generate Kronos predicted-return factor (daily stride, ~15 min GPU) |
-| `python predix.py kronos-factor --pred 30` | 30-bar prediction horizon |
-| `python predix.py kronos-factor --device cpu` | CPU inference (slower) |
-| `python predix.py kronos-eval` | Evaluate Kronos IC / hit rate vs LightGBM baseline |
-| `python predix.py kronos-eval --pred 96` | Daily horizon evaluation |
-
-### Factor Evaluation
-
-| Command | Description |
-|---------|-------------|
-| `python predix.py evaluate --all` | Evaluate all generated factors |
-| `python predix.py top -n 20` | Show top 20 factors by IC |
-| `python predix.py portfolio-simple` | Simple portfolio optimization |
-
-### Parallel Execution
-
-| Command | Description |
-|---------|-------------|
-| `python predix_parallel.py --runs 5 --api-keys 1 -m openrouter` | Run 5 parallel factor evolutions |
-| `python predix_parallel.py --runs 20 --api-keys 2 -m openrouter` | Run 20 runs with 2 API keys |
-
-### Monitoring & Debug
-
-| Command | Description |
-|---------|-------------|
-| `rdagent server_ui --port 19899 --log-dir <path>` | Start web dashboard |
-| `rdagent health_check` | Validate environment setup |
-| `python predix_batch_backtest.py` | Batch backtest multiple factors |
-| `python predix_rebacktest_strategies.py` | Re-backtest existing strategies |
-
----
-
-## Features
-
-### 🔄 Iterative Factor Evolution
-
-Predix continuously proposes, implements, and validates new alpha factors:
-
-- Learns from backtest feedback
-- Avoids overfitting through walk-forward validation
-- Discovers non-obvious patterns in order flow, volatility, and session dynamics
-
-### 🛡️ Trading Protection System
-
-Automatic risk management to prevent excessive losses:
-
-- **Max Drawdown Protection** - Pauses trading when drawdown exceeds threshold (default: 15%)
-- **Cooldown Period** - Enforces mandatory rest period after significant losses (default: 4h after 5% loss)
-- **Stoploss Guard** - Detects clusters of stoplosses and blocks trading (default: max 5 per day)
-- **Low Performance Filter** - Filters out consistently underperforming factors (Sharpe < 0.5, Win Rate < 40%)
-
-### 🧠 Model Architecture Search
-
-Automatically explores and refines predictive models:
-
-- Linear baselines (LightGBM, XGBoost)
-- Deep learning (LSTM, Transformer, Temporal CNN)
-- Ensemble methods
-
-### 📚 Knowledge Base
-
-Built-in knowledge accumulation across loops:
-
-- Successful factors are archived
-- Failed attempts inform future proposals
-- Cross-loop learning improves robustness
-
-### 🖥️ Interactive UI
-
-Real-time dashboard for monitoring:
-
-- Factor performance metrics
-- Model architecture evolution
-- Cumulative returns and drawdowns
-- Code diffs and implementation history
-
-### 🤖 Kronos Foundation Model Integration
-
-Predix integrates [Kronos-mini](https://github.com/shiyu-coder/Kronos) — a 4.1M parameter OHLCV foundation model pretrained on 12+ billion K-lines from 45 global exchanges (AAAI 2026, MIT):
-
-- **Option A — Alpha Factor**: Rolling daily inference generates a `KronosPredReturn` factor. Every 96 bars (one trading day), Kronos predicts the next day's return from the previous 512 bars of EUR/USD OHLCV data. The factor is forward-filled to 1-min frequency and plugs directly into Predix's factor evaluation pipeline.
-
-- **Option B — Model Evaluation**: Kronos runs alongside LightGBM as a standalone predictor. IC (Information Coefficient), IC IR, and directional hit rate are computed over the full dataset for direct comparison with LightGBM-generated models.
-
-```bash
-# One-time setup
-git clone https://github.com/shiyu-coder/Kronos ~/Kronos
-
-# Generate factor (Option A) — saves to results/factors/
-python predix.py kronos-factor
-
-# Evaluate as model (Option B) — prints IC vs LightGBM reference
-python predix.py kronos-eval
-```
-
-### 🔒 Security & Quality
-
-Automated quality assurance:
-
-- **134+ Tests** — all features tested automatically on every commit
-- **Bandit Security Scanner** — pre-commit security checks
-- **Weekly Dependency Audit** — automated vulnerability scan via GitHub Actions
-
----
-
-## Project Structure
-
-```
-predix/
-├── rdagent/                 # Core agent framework
-│   ├── app/                 # CLI and scenario apps
-│   ├── components/          # Reusable agent components
-│   │   ├── backtesting/     # Backtest engine & protections
-│   │   │   ├── backtest_engine.py
-│   │   │   ├── vbt_backtest.py  # Unified backtest engine
-│   │   │   ├── results_db.py
-│   │   │   └── protections/ # Trading protection system
-│   │   └── coder/           # Factor & model coding (CoSTEER + Optuna)
-│   ├── core/                # Core abstractions
-│   ├── scenarios/           # Domain-specific scenarios
-│   └── utils/               # Utilities
-├── test/                    # Test suite (134 tests)
-│   └── backtesting/         # Backtest unit tests
-├── web/                     # Web UI frontend
-├── data_config.yaml         # Walk-forward split configuration
-├── pyproject.toml           # Project metadata
-└── requirements.txt         # Dependencies
-```
-
----
-
-## Requirements
-
-Core dependencies (see [`requirements.txt`](requirements.txt) for full list):
-
-- **LLM**: `openai`, `litellm`
-- **Data**: `pandas`, `numpy`, `pyarrow`
-- **ML**: `scikit-learn`, `lightgbm`, `xgboost`
-- **Backtesting**: `qlib` (via Docker)
-- **UI**: `streamlit`, `plotly`, `flask`
-
----
-
-## License
-
-This project is licensed under the **MIT License** – see the [`LICENSE`](LICENSE) file for details.
-
-### Attribution Requirements
-
-If you use this code or concepts in your project, you **must**:
-1. Include the MIT License text
-2. Keep the copyright notice: "Copyright (c) 2025 Predix Team"
-3. Provide attribution to the original project
-
-See [`ATTRIBUTION.md`](ATTRIBUTION.md) for detailed guidelines and examples.
-
----
-
-## Contributing
-
-Contributions are welcome! Please:
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feat/my-feature`)
-3. Commit using [Conventional Commits](https://www.conventionalcommits.org/) (`git commit -m 'feat: add my feature'`)
-4. Push to the branch (`git push origin feat/my-feature`)
-5. Open a Pull Request with a conventional commit title
-
-For major changes, please open an issue first to discuss your approach.
-
----
-
-## Citation
-
-If you use Predix in your research, please cite the underlying framework:
-
-```bibtex
-@misc{yang2025rdagentllmagentframeworkautonomous,
-  title={R&D-Agent: An LLM-Agent Framework Towards Autonomous Data Science},
-  author={Yang, Xu and Yang, Xiao and Fang, Shikai and Zhang, Yifei and Wang, Jian and Xian, Bowen and Li, Qizheng and Li, Jingyuan and Xu, Minrui and Li, Yuante and others},
-  year={2025},
-  eprint={2505.14738},
-  archivePrefix={arXiv},
-  primaryClass={cs.AI}
+## Benchmark
+- [Towards Data-Centric Automatic R&D](https://arxiv.org/abs/2404.11276);
+```BibTeX
+@misc{chen2024datacentric,
+    title={Towards Data-Centric Automatic R&D},
+    author={Haotian Chen and Xinjie Shen and Zeqi Ye and Wenjun Feng and Haoxue Wang and Xiao Yang and Xu Yang and Weiqing Liu and Jiang Bian},
+    year={2024},
+    eprint={2404.11276},
+    archivePrefix={arXiv},
+    primaryClass={cs.AI}
 }
 ```
+![image](https://github.com/user-attachments/assets/494f55d3-de9e-4e73-ba3d-a787e8f9e841)
 
----
+## Research
 
-## Support
+In a data mining expert's daily research and development process, they propose a hypothesis (e.g., a model structure like RNN can capture patterns in time-series data), design experiments (e.g., finance data contains time-series and we can verify the hypothesis in this scenario), implement the experiment as code (e.g., Pytorch model structure), and then execute the code to get feedback (e.g., metrics, loss curve, etc.). The experts learn from the feedback and improve in the next iteration.
 
-- **Issues**: [GitHub Issues](https://github.com/TPTBusiness/Predix/issues)
+Based on the principles above, we have established a basic method framework that continuously proposes hypotheses, verifies them, and gets feedback from the real-world practice. This is the first scientific research automation framework that supports linking with real-world verification.
 
----
+[Demos](#📈 Scenarios/Demos) are released.
 
-## Disclaimer
+## Development
 
-Predix is provided "as is" for **research and educational purposes only**. It is **not** intended for:
+- [Collaborative Evolving Strategy for Automatic Data-Centric Development](https://arxiv.org/abs/2407.18690)
+```BibTeX
+@misc{yang2024collaborative,
+    title={Collaborative Evolving Strategy for Automatic Data-Centric Development},
+    author={Xu Yang and Haotian Chen and Wenjun Feng and Haoxue Wang and Zeqi Ye and Xinjie Shen and Xiao Yang and Shizhao Sun and Weiqing Liu and Jiang Bian},
+    year={2024},
+    eprint={2407.18690},
+    archivePrefix={arXiv},
+    primaryClass={cs.AI}
+}
+```
+![image](https://github.com/user-attachments/assets/75d9769b-0edd-4caf-9d45-57d1e577054b)
 
-- Live trading or financial advice
-- Production use without thorough testing
-- Replacement of qualified financial professionals
 
-Users assume all liability and should comply with applicable laws and regulations in their jurisdiction. Past performance does not guarantee future results.
+# Contributing
+
+More documents can be found in the [📚readthedocs](). TODO: add link
+
+## Guidance
+This project welcomes contributions and suggestions.
+You can find issues in the issues list or simply running `grep -r "TODO:"`.
+
+Making contributions is not a hard thing. Solving an issue(maybe just answering a question raised in issues list ), fixing/issuing a bug, improving the documents and even fixing a typo are important contributions to RDAgent.
+<img src="https://img.shields.io/github/contributors-anon/microsoft/RD-Agent"/>
+
+<a href="https://github.com/microsoft/RD-Agent/graphs/contributors"><img src="https://contrib.rocks/image?repo=microsoft/RD-Agent&max=240&columns=18" /></a>
+
+# Disclaimer
+**The RD-agent is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. The RD-agent is aimed to facilitate research and development process in the financial industry and not ready-to-use for any financial investment or advice. Users shall independently assess and test the risks of the RD-agent in a specific use scenario, ensure the responsible use of AI technology, including but not limited to developing and integrating risk mitigation measures, and comply with all applicable laws and regulations in all applicable jurisdictions. The RD-agent does not provide financial opinions or reflect the opinions of Microsoft, nor is it designed to replace the role of qualified financial professionals in formulating, assessing, and approving finance products. The inputs and outputs of the RD-agent belong to the users and users shall assume all liability under any theory of liability, whether in contract, torts, regulatory, negligence, products liability, or otherwise, associated with use of the RD-agent and any inputs and outputs thereof.**

SECURITY.md

@@ -1,21 +1,41 @@
-# Security Policy
+<!-- BEGIN MICROSOFT SECURITY.MD V0.0.9 BLOCK -->
 
-## Reporting a Vulnerability
+## Security
 
-We take the security of Predix seriously. If you believe you have found a security vulnerability, please report it responsibly.
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) and [Xamarin](https://github.com/xamarin).
+
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/security.md/definition), please report it to us as described below.
+
+## Reporting Security Issues
 
 **Please do not report security vulnerabilities through public GitHub issues.**
 
-### How to Report
+Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report).
 
-1. **Open a private security advisory** on GitHub: https://github.com/TPTBusiness/Predix/security/advisories
-2. Provide a detailed description of the vulnerability
-3. Include steps to reproduce if possible
-4. We will respond within 48 hours
+If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/security.md/msrc/pgp).
 
-### What to Expect
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://www.microsoft.com/msrc). 
 
-- We will acknowledge your report within 48 hours
-- We will investigate and provide updates regularly
-- Once resolved, we will credit you in the release notes (if desired)
-- Please allow reasonable time for us to address the issue before public disclosure
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+  * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+  * Full paths of source file(s) related to the manifestation of the issue
+  * The location of the affected source code (tag/branch/commit or direct URL)
+  * Any special configuration required to reproduce the issue
+  * Step-by-step instructions to reproduce the issue
+  * Proof-of-concept or exploit code (if possible)
+  * Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/security.md/msrc/bounty) page for more details about our active programs.
+
+## Preferred Languages
+
+We prefer all communications to be in English.
+
+## Policy
+
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/security.md/cvd).
+
+<!-- END MICROSOFT SECURITY.MD BLOCK -->

SUPPORT.md

@@ -1,25 +1,25 @@
-# Support
-
-## How to file issues and get help
-
-This project uses GitHub Issues to track bugs and feature requests. Please search the existing
-issues before filing new issues to avoid duplicates. For new issues, file your bug or
-feature request as a new Issue.
-
-- **Issues**: [https://github.com/PredixAI/predix/issues](https://github.com/PredixAI/predix/issues)
-
-For help and questions about using this project, please reach out via:
-
-- **Email**: nico@predix.io
-- **GitHub Discussions**: [https://github.com/PredixAI/predix/discussions](https://github.com/PredixAI/predix/discussions)
-
-## Community Support
-
-We encourage users to help each other through GitHub Discussions or by contributing
-answers to issues. If you find a solution to a problem, please consider sharing it
-publicly to help others.
-
-## Support Policy
-
-Support is provided on a best-effort basis by the maintainers and community.
-For critical issues or commercial support needs, please contact the maintainers directly.
+# TODO: The maintainer of this repo has not yet edited this file
+
+**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project?
+
+- **No CSS support:** Fill out this template with information about how to file issues and get help.
+- **Yes CSS support:** Fill out an intake form at [aka.ms/onboardsupport](https://aka.ms/onboardsupport). CSS will work with/help you to determine next steps.
+- **Not sure?** Fill out an intake as though the answer were "Yes". CSS will help you decide.
+
+*Then remove this first heading from this SUPPORT.MD file before publishing your repo.*
+
+# Support
+
+## How to file issues and get help  
+
+This project uses GitHub Issues to track bugs and feature requests. Please search the existing 
+issues before filing new issues to avoid duplicates.  For new issues, file your bug or 
+feature request as a new Issue.
+
+For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE 
+FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER
+CHANNEL. WHERE WILL YOU HELP PEOPLE?**.
+
+## Microsoft Support Policy  
+
+Support for this **PROJECT or PRODUCT** is limited to the resources listed above.

TODO.md

@@ -0,0 +1,10 @@
+We encourage to set the TODOs in code. But some TODOs are more global.
+So we place it here.
+
+
+- [ ] Aligning the naming of files in components & scenarios.
+  - We would like to have the same logic for naming convention in components(reusable components for all scenarios) and scenarios (componets for specific scenario).
+  - But now we have following mismatch
+    - `coder` in `components` & `developer` in `components`
+- [ ] The name of the folders mismatch with the content in them.
+  - Why are scenarios in experiments?

changelog/v1.0.0.md

@@ -1,175 +0,0 @@
-# Predix v1.0.0 Release Notes
-
-**Release Date:** 2026-04-02
-
-**Tag:** v1.0.0
-
----
-
-## 🎉 Overview
-
-Initial release of Predix - an autonomous AI-powered quantitative trading agent for EUR/USD forex markets.
-
----
-
-## ✨ Added
-
-### Autonomous Factor Generation
-- **110+ EURUSD factors** generated autonomously using LLMs
-- Multi-agent debate system (Bull/Bear/Neutral analysts)
-- Stanley Druckenmiller-style macro analysis agent
-- Market regime detection using Hurst Exponent
-- Session-aware analysis (Asian/London/NY sessions)
-
-### Backtesting Engine
-- IC (Information Coefficient) calculation
-- Sharpe Ratio, Sortino Ratio, Calmar Ratio
-- Max Drawdown with start/end dates
-- Win Rate, Total Trades tracking
-- Transaction cost modeling (1.5 bps spread)
-- Forward return calculation
-
-### Results Database
-- SQLite database for tracking all backtest results
-- Tables: factors, backtest_runs, backtest_metrics, daily_returns, loop_results
-- Queries for top factors by Sharpe/IC
-- Aggregate statistics
-- Foreign key integrity
-
-### Risk Management
-- Correlation matrix between factors
-- Portfolio optimization (Mean-Variance, Risk Parity)
-- Position sizing with volatility adjustment
-- Risk limits (position size, leverage, drawdown)
-- Advanced risk manager with custom thresholds
-
-### Dashboards & UI
-- **Web Dashboard** (Flask + HTML) with live progress
-- **CLI Dashboard** (Rich library) for terminal
-- Real-time macro data (EURUSD, DXY, Volatility)
-- Session info with recommendations
-- Memory statistics (Win-Rate, PnL, Sharpe)
-
-### Testing Infrastructure
-- **97 unit tests** with **98.77% code coverage**
-- Edge case testing for all metrics
-- Integration tests for full workflows
-- pytest configuration
-- Test fixtures for mock data
-
-### Documentation
-- Comprehensive QWEN.md (development guide)
-- ATTRIBUTION.md (usage guidelines)
-- README.md (installation, quick start)
-- All code comments in English
-- Git commit guidelines (English-only)
-
-### Developer Experience
-- English-only commit messages policy
-- Clean git history (all German messages translated)
-- .gitignore for sensitive files (.env, logs, results, etc.)
-- Makefile for common tasks
-- Pre-commit hooks support
-
----
-
-## 🔧 Changed
-
-- Rebranded from RD-Agent to Predix for EUR/USD quantitative trading
-- Updated project metadata for PredixAI organization
-- All code comments translated to English
-- Removed 'Inspired by' comments, added comprehensive Acknowledgments
-- Enhanced .gitignore for better file management
-- Removed test configuration files from root directory
-- Cleaned up log files and test artifacts from git history
-
----
-
-## 🛡️ Fixed
-
-- Removed all Chinese stock references, replaced with EUR/USD 1min FX data
-- Migrated to 1min EURUSD data (2020-2026)
-- Injected MultiIndex warning into factor interface prompt
-- Fixed Embedding Context Length errors with intelligent chunking
-- Fixed LLM connection errors with multi-provider fallback
-- Fixed division by zero in volatility calculations
-- Fixed NaN handling in correlation matrices
-
----
-
-## 📦 Dependencies
-
-### Core
-- Python 3.10/3.11
-- PyTorch for deep learning
-- Qlib for backtesting
-- Flask for web dashboard
-- Rich/Typer for CLI
-- pytest for testing (98.77% coverage)
-
-### Additional
-- pandas, numpy for data processing
-- SQLite for database
-- yfinance for live market data
-- langchain, langgraph for agent workflows
-
----
-
-## 📊 Statistics
-
-| Metric | Value |
-|--------|-------|
-| Lines of Code | ~15,000+ |
-| Files | 100+ |
-| Commits | 20+ |
-| Contributors | 1 |
-| Test Coverage | 98.77% |
-| Tests Passed | 97/97 |
-| Factors Generated | 110+ |
-
----
-
-## 🙏 Acknowledgments
-
-This release builds upon and is inspired by:
-
-- **Microsoft RD-Agent** (MIT License) - Foundation for autonomous R&D framework
-- **TradingAgents** (Apache 2.0 License) - Multi-agent debate patterns
-- **ai-hedge-fund** - Macro analysis and risk management concepts
-
-**All code in Predix v1.0.0 is originally written and independently implemented.**
-
----
-
-## 📝 License
-
-**MIT License** - See [LICENSE](../LICENSE) file for details.
-
-### Attribution Requirements
-
-If you use this code or concepts in your project, you **must**:
-1. Include the MIT License text
-2. Keep the copyright notice: "Copyright (c) 2025 Predix Team"
-3. Provide attribution to the original project
-
-See [ATTRIBUTION.md](../ATTRIBUTION.md) for detailed guidelines.
-
----
-
-## 🔗 Links
-
-- **GitHub Release:** https://github.com/TPTBusiness/Predix/releases/tag/v1.0.0
-- **Main Changelog:** ../CHANGELOG.md
-- **Attribution Guidelines:** ../ATTRIBUTION.md
-- **Installation Guide:** ../README.md#installation
-- **Quick Start:** ../README.md#quick-start
-
----
-
-<div align="center">
-
-**Made with ❤️ by Predix Team**
-
-For detailed usage guidelines, see [README.md](../README.md)
-
-</div>

changelog/v2.0.0.md

@@ -1,102 +0,0 @@
-# Predix v2.0.0 Release Notes
-
-**Release Date:** 2026-04-10
-
-**Tag:** v2.0.0
-
----
-
-## 🎉 Overview
-
-Major update adding AI-powered strategy generation, realistic backtesting, and comprehensive CLI tooling. Predix now autonomously generates, evaluates, and optimizes trading strategies using local LLMs.
-
----
-
-## ✨ Added
-
-### LLM-Powered Strategy Generation
-- **StrategyOrchestrator**: Generate trading strategies by combining factors with LLM
-- **Local llama.cpp Support**: Run strategy generation locally (Qwen3.5-35B)
-- **OpenRouter Support**: Optional cloud model fallback
-- **Improved Prompts (v3)**: IC-sign-aware factor combination instructions
-- **Diverse Factor Selection**: Automatic selection by type (momentum, divergence, volatility, session)
-
-### Realistic Backtesting
-- **OHLCV-Based Returns**: Real price returns instead of factor proxies
-- **Spread Costs**: 1.5 bps per trade deducted from returns
-- **Forward-Fill Support**: Daily factors → 1-min frequency
-- **Proper Annualization**: sqrt(252*1440) for 1-min data
-
-### CLI Commands
-- `rdagent predix` - Show beautiful welcome screen (perfect for screenshots!)
-- `rdagent start_llama` - Start llama.cpp server
-- `rdagent start_loop` - Start strategy generator loop with auto-restart
-- `rdagent generate_strategies` - Generate strategies from factors
-- `rdagent optimize_portfolio` - Portfolio optimization
-- `rdagent eval_all` - Evaluate factors with full data
-- `rdagent batch_backtest` - Batch backtest existing factors
-- `rdagent report` - Generate PDF performance reports
-- `rdagent rebacktest` - Re-backtest existing strategies
-
-### Code Quality
-- **282+ Integration Tests**: All features tested
-- **Security Hardening**: All Dependabot/CodeQL alerts resolved
-- **Pre-commit Hooks**: Automated tests + security scanning
-
----
-
-## 🔧 Changed
-
-- Utility scripts organized in `scripts/` directory
-- Generated data moved to `results/`
-- Config files moved to `constraints/`
-- Root directory cleaned
-
----
-
-## 🐛 Fixed
-
-- JSON strategy files no longer committed to root
-- LICENSE badge link corrected (main → master)
-- Security vulnerabilities resolved (bandit, path traversal)
-
----
-
-## 📦 Installation
-
-```bash
-git clone https://github.com/TPTBusiness/Predix
-cd Predix
-pip install -e .
-```
-
-## 🚀 Quick Start
-
-```bash
-# Show welcome screen
-rdagent predix
-
-# Start LLM server
-rdagent start_llama
-
-# Run trading loop
-rdagent fin_quant --auto-strategies
-
-# Generate strategies manually
-rdagent generate_strategies --count 5 --optuna
-```
-
----
-
-## 🔒 Security
-
-- All known vulnerabilities resolved
-- Bandit security scanning integrated
-- Pre-commit hooks for automated checks
-- Path traversal prevention hardened
-
----
-
-## 📄 License
-
-MIT License - see [LICENSE](../LICENSE) for details.

constraints/.bandit.yml

@@ -1,24 +0,0 @@
-# Bandit Security Scanner Configuration
-# Documentation: https://bandit.readthedocs.io/
-
-title: Bandit Security Scan for Predix
-
-# Tests to skip (known false positives or acceptable risks)
-skips:
-  - B101  # assert_used (asserts are OK in non-production code)
-  - B602  # subprocess_popen_with_shell_equals_true (known issue, will fix separately)
-  - B701  # jinja2_autoescape_false (false positive - code templates, not HTML)
-  - B301  # pickle (known usage for internal data, will audit separately)
-  - B108  # hardcoded_tmp_directory (internal tool)
-  - B615  # huggingface_unsafe_download (will audit separately)
-  - B307  # eval usage (will audit separately)
-  - B614  # pytorch_load (internal benchmark code)
-  - B104  # hardcoded_bind_all_interfaces (internal tool, localhost only)
-  - B310  # urllib_urlopen (internal API calls)
-
-# Minimum severity to report (LOW, MEDIUM, HIGH)
-# Pre-commit only warns on MEDIUM, blocks on HIGH
-severity_level: HIGH
-
-# Minimum confidence level (LOW, MEDIUM, HIGH)
-confidence_level: MEDIUM

constraints/3.10.txt

@@ -1,5 +1,266 @@
-azure-identity==1.25.3
-dill==0.4.1
+aiohttp==3.9.1
+aiosignal==1.3.1
+alabaster==0.7.13
+annotated-types==0.6.0
+anyio==4.2.0
+appdirs==1.4.4
+argon2-cffi==23.1.0
+argon2-cffi-bindings==21.2.0
+arrow==1.3.0
+asttokens==2.4.1
+async-lru==2.0.4
+async-timeout==4.0.3
+attrs==23.2.0
+autodoc-pydantic==2.0.1
+azure-ai-formrecognizer==3.3.2
+azure-common==1.1.28
+azure-core==1.29.6
+azure-identity==1.17.1
+Babel==2.14.0
+beautifulsoup4==4.12.2
+black==23.12.1
+bleach==6.1.0
+blosc2==2.7.1
+build==1.0.3
+certifi==2023.11.17
+cffi==1.16.0
+charset-normalizer==3.3.2
+click==8.1.7
+colorama==0.4.6
+comm==0.2.2
+contourpy==1.2.1
+coverage==7.4.0
+cryptography==41.0.7
+cycler==0.12.1
+Cython==3.0.7
+dataclasses-json==0.6.3
+debugpy==1.8.2
+decorator==5.1.1
+defusedxml==0.7.1
+dill==0.3.8
+distro==1.9.0
+docker==7.1.0
+docutils==0.20.1
+exceptiongroup==1.2.0
+executing==2.0.1
+fastjsonschema==2.20.0
+feedparser==6.0.11
+filelock==3.13.1
+fire==0.5.0
+fonttools==4.53.1
+fqdn==1.5.1
+frozenlist==1.4.1
+fsspec==2023.12.2
+furo==2023.9.10
+fuzzywuzzy==0.18.0
+git-changelog==2.4.0
+greenlet==3.0.3
+h11==0.14.0
+httpcore==1.0.2
+httpx==0.26.0
+idna==3.6
+imagesize==1.4.1
+importlib-metadata==7.0.1
+iniconfig==2.0.0
+ipykernel==6.29.5
+ipython==8.26.0
+ipywidgets==8.1.3
+isodate==0.6.1
+isoduration==20.11.0
+isort==5.13.2
+jaraco.classes==3.3.0
+jedi==0.19.1
+jeepney==0.8.0
+Jinja2==3.1.2
+joblib==1.4.2
+json5==0.9.25
+jsonpatch==1.33
+jsonpointer==2.4
+jsonschema==4.23.0
+jsonschema-specifications==2023.12.1
+jupyter==1.0.0
+jupyter-console==6.6.3
+jupyter-events==0.10.0
+jupyter-lsp==2.2.5
+jupyter_client==8.6.2
+jupyter_core==5.7.2
+jupyter_server==2.14.2
+jupyter_server_terminals==0.5.3
+jupyterlab==4.2.4
+jupyterlab_pygments==0.3.0
+jupyterlab_server==2.27.3
+jupyterlab_widgets==3.0.11
+keyring==24.3.0
+kiwisolver==1.4.5
+langchain==0.0.353
+langchain-community==0.0.7
+langchain-core==0.1.4
+langsmith==0.0.75
+Levenshtein==0.25.1
+livereload==2.6.3
+loguru==0.7.2
+loguru-mypy==0.0.4
+lxml==5.0.0
+markdown-it-py==3.0.0
+MarkupSafe==2.1.3
+marshmallow==3.20.1
+matplotlib==3.9.1
+matplotlib-inline==0.1.7
+mdit-py-plugins==0.4.0
+mdurl==0.1.2
+mistune==3.0.2
+more-itertools==10.1.0
+mpmath==1.3.0
+msal==1.30.0
+msal-extensions==1.2.0
+msgpack==1.0.8
+msrest==0.7.1
+multidict==6.0.4
+mypy==1.10.0
+mypy-extensions==1.0.0
+myst-parser==2.0.0
+nbclient==0.10.0
+nbconvert==7.16.4
+nbformat==5.10.4
+ndindex==1.8
+nest-asyncio==1.6.0
+networkx==3.2.1
+nh3==0.2.15
+notebook==7.2.1
+notebook_shim==0.2.4
+numexpr==2.10.1
+numpy==1.26.2
+nvidia-cublas-cu12==12.1.3.1
+nvidia-cuda-cupti-cu12==12.1.105
+nvidia-cuda-nvrtc-cu12==12.1.105
+nvidia-cuda-runtime-cu12==12.1.105
+nvidia-cudnn-cu12==8.9.2.26
+nvidia-cufft-cu12==11.0.2.54
+nvidia-curand-cu12==10.3.2.106
+nvidia-cusolver-cu12==11.4.5.107
+nvidia-cusparse-cu12==12.1.0.106
+nvidia-nccl-cu12==2.18.1
+nvidia-nvjitlink-cu12==12.3.101
+nvidia-nvtx-cu12==12.1.105
+oauthlib==3.2.2
+openai==1.6.1
+overrides==7.7.0
+packaging==23.2
+pandarallel==1.6.5
+pandas==2.1.4
+pandocfilters==1.5.1
+parso==0.8.4
+pathspec==0.12.1
+patsy==0.5.6
+pexpect==4.9.0
 pillow==10.4.0
-psutil==6.1.1
-scipy==1.15.3
+pkginfo==1.9.6
+platformdirs==4.1.0
+pluggy==1.3.0
+portalocker==2.10.1
+prometheus_client==0.20.0
+prompt_toolkit==3.0.47
+psutil==6.0.0
+ptyprocess==0.7.0
+pure_eval==0.2.3
+py-cpuinfo==9.0.0
+pycparser==2.21
+pydantic==2.5.3
+pydantic-settings==2.1.0
+pydantic_core==2.14.6
+Pygments==2.17.2
+PyJWT==2.8.0
+PyMuPDF==1.24.9
+PyMuPDFb==1.24.9
+pyparsing==3.1.2
+pypdf==3.17.4
+pyproject_hooks==1.0.0
+pytest==7.4.4
+python-dateutil==2.8.2
+python-dotenv==1.0.0
+python-json-logger==2.0.7
+python-Levenshtein==0.25.1
+pytz==2023.3.post1
+PyYAML==6.0.1
+pyzmq==26.0.3
+qtconsole==5.5.2
+QtPy==2.4.1
+rapidfuzz==3.9.5
+readme-renderer==42.0
+referencing==0.35.1
+regex==2024.7.24
+requests==2.31.0
+requests-oauthlib==1.3.1
+requests-toolbelt==1.0.0
+rfc3339-validator==0.1.4
+rfc3986==2.0.0
+rfc3986-validator==0.1.1
+rich==13.7.0
+rpds-py==0.19.1
+ruamel.yaml==0.18.5
+ruamel.yaml.clib==0.2.8
+ruff==0.4.5
+scikit-learn==1.5.1
+scipy==1.11.4
+SecretStorage==3.3.3
+semver==3.0.2
+Send2Trash==1.8.3
+setuptools-scm==8.0.4
+sgmllib3k==1.0.0
+shellingham==1.5.4
+six==1.16.0
+sniffio==1.3.0
+snowballstemmer==2.2.0
+soupsieve==2.5
+Sphinx==7.2.6
+sphinx-autobuild==2021.3.14
+sphinx-basic-ng==1.0.0b2
+sphinx-click==5.1.0
+sphinx-togglebutton==0.3.2
+sphinxcontrib-applehelp==1.0.7
+sphinxcontrib-devhelp==1.0.5
+sphinxcontrib-htmlhelp==2.0.4
+sphinxcontrib-jsmath==1.0.1
+sphinxcontrib-qthelp==1.0.6
+sphinxcontrib-serializinghtml==1.1.9
+SQLAlchemy==2.0.24
+stack-data==0.6.3
+statsmodels==0.14.2
+sympy==1.12
+tables==3.9.2
+tabulate==0.9.0
+tenacity==8.2.3
+termcolor==2.4.0
+terminado==0.18.1
+threadpoolctl==3.5.0
+tiktoken==0.7.0
+tinycss2==1.3.0
+toml-sort==0.23.1
+tomli==2.0.1
+tomlkit==0.12.3
+torch==2.1.2
+torch_geometric==2.5.3
+tornado==6.4
+tqdm==4.66.1
+traitlets==5.14.3
+tree-sitter==0.22.3
+tree-sitter-python==0.21.0
+triton==2.1.0
+twine==4.0.2
+typer==0.9.0
+types-psutil==6.0.0.20240621
+types-python-dateutil==2.9.0.20240316
+types-PyYAML==6.0.12.20240724
+types-tqdm==4.66.0.20240417
+typing-inspect==0.9.0
+typing_extensions==4.9.0
+tzdata==2023.4
+uri-template==1.3.0
+urllib3==2.1.0
+wcwidth==0.2.13
+webcolors==24.6.0
+webencodings==0.5.1
+websocket-client==1.8.0
+widgetsnbextension==4.0.11
+yarl==1.9.4
+zipp==3.17.0

constraints/3.11.txt

@@ -1,5 +1,263 @@
-azure-identity==1.25.3
-dill==0.4.1
+aiohttp==3.9.1
+aiosignal==1.3.1
+alabaster==0.7.13
+annotated-types==0.6.0
+anyio==4.2.0
+appdirs==1.4.4
+argon2-cffi==23.1.0
+argon2-cffi-bindings==21.2.0
+arrow==1.3.0
+asttokens==2.4.1
+async-lru==2.0.4
+attrs==23.2.0
+autodoc-pydantic==2.0.1
+azure-ai-formrecognizer==3.3.2
+azure-common==1.1.28
+azure-core==1.29.6
+azure-identity==1.17.1
+Babel==2.14.0
+beautifulsoup4==4.12.2
+black==23.12.1
+bleach==6.1.0
+blosc2==2.7.1
+build==1.0.3
+certifi==2023.11.17
+cffi==1.16.0
+charset-normalizer==3.3.2
+click==8.1.7
+colorama==0.4.6
+comm==0.2.2
+contourpy==1.2.1
+coverage==7.4.0
+cryptography==41.0.7
+cycler==0.12.1
+Cython==3.0.7
+dataclasses-json==0.6.3
+debugpy==1.8.2
+decorator==5.1.1
+defusedxml==0.7.1
+dill==0.3.8
+distro==1.9.0
+docker==7.1.0
+docutils==0.20.1
+executing==2.0.1
+fastjsonschema==2.20.0
+feedparser==6.0.11
+filelock==3.13.1
+fire==0.5.0
+fonttools==4.53.1
+fqdn==1.5.1
+frozenlist==1.4.1
+fsspec==2023.12.2
+furo==2023.9.10
+fuzzywuzzy==0.18.0
+git-changelog==2.4.0
+greenlet==3.0.3
+h11==0.14.0
+httpcore==1.0.2
+httpx==0.26.0
+idna==3.6
+imagesize==1.4.1
+importlib-metadata==7.0.1
+iniconfig==2.0.0
+ipykernel==6.29.5
+ipython==8.26.0
+ipywidgets==8.1.3
+isodate==0.6.1
+isoduration==20.11.0
+isort==5.13.2
+jaraco.classes==3.3.0
+jedi==0.19.1
+jeepney==0.8.0
+Jinja2==3.1.2
+joblib==1.4.2
+json5==0.9.25
+jsonpatch==1.33
+jsonpointer==2.4
+jsonschema==4.23.0
+jsonschema-specifications==2023.12.1
+jupyter==1.0.0
+jupyter-console==6.6.3
+jupyter-events==0.10.0
+jupyter-lsp==2.2.5
+jupyter_client==8.6.2
+jupyter_core==5.7.2
+jupyter_server==2.14.2
+jupyter_server_terminals==0.5.3
+jupyterlab==4.2.4
+jupyterlab_pygments==0.3.0
+jupyterlab_server==2.27.3
+jupyterlab_widgets==3.0.11
+keyring==24.3.0
+kiwisolver==1.4.5
+langchain==0.0.353
+langchain-community==0.0.7
+langchain-core==0.1.4
+langsmith==0.0.75
+Levenshtein==0.25.1
+livereload==2.6.3
+loguru==0.7.2
+loguru-mypy==0.0.4
+lxml==5.0.0
+markdown-it-py==3.0.0
+MarkupSafe==2.1.3
+marshmallow==3.20.1
+matplotlib==3.9.1
+matplotlib-inline==0.1.7
+mdit-py-plugins==0.4.0
+mdurl==0.1.2
+mistune==3.0.2
+more-itertools==10.1.0
+mpmath==1.3.0
+msal==1.30.0
+msal-extensions==1.2.0
+msgpack==1.0.8
+msrest==0.7.1
+multidict==6.0.4
+mypy==1.10.0
+mypy-extensions==1.0.0
+myst-parser==2.0.0
+nbclient==0.10.0
+nbconvert==7.16.4
+nbformat==5.10.4
+ndindex==1.8
+nest-asyncio==1.6.0
+networkx==3.2.1
+nh3==0.2.15
+notebook==7.2.1
+notebook_shim==0.2.4
+numexpr==2.10.1
+numpy==1.26.2
+nvidia-cublas-cu12==12.1.3.1
+nvidia-cuda-cupti-cu12==12.1.105
+nvidia-cuda-nvrtc-cu12==12.1.105
+nvidia-cuda-runtime-cu12==12.1.105
+nvidia-cudnn-cu12==8.9.2.26
+nvidia-cufft-cu12==11.0.2.54
+nvidia-curand-cu12==10.3.2.106
+nvidia-cusolver-cu12==11.4.5.107
+nvidia-cusparse-cu12==12.1.0.106
+nvidia-nccl-cu12==2.18.1
+nvidia-nvjitlink-cu12==12.3.101
+nvidia-nvtx-cu12==12.1.105
+oauthlib==3.2.2
+openai==1.6.1
+overrides==7.7.0
+packaging==23.2
+pandarallel==1.6.5
+pandas==2.1.4
+pandocfilters==1.5.1
+parso==0.8.4
+pathspec==0.12.1
+patsy==0.5.6
+pexpect==4.9.0
 pillow==10.4.0
-psutil==6.1.1
-scipy==1.15.3
+pkginfo==1.9.6
+platformdirs==4.1.0
+pluggy==1.3.0
+portalocker==2.10.1
+prometheus_client==0.20.0
+prompt_toolkit==3.0.47
+psutil==6.0.0
+ptyprocess==0.7.0
+pure_eval==0.2.3
+py-cpuinfo==9.0.0
+pycparser==2.21
+pydantic==2.5.3
+pydantic-settings==2.1.0
+pydantic_core==2.14.6
+Pygments==2.17.2
+PyJWT==2.9.0
+PyMuPDF==1.24.9
+PyMuPDFb==1.24.9
+pyparsing==3.1.2
+pypdf==3.17.4
+pyproject_hooks==1.0.0
+pytest==7.4.4
+python-dateutil==2.8.2
+python-dotenv==1.0.0
+python-json-logger==2.0.7
+python-Levenshtein==0.25.1
+pytz==2023.3.post1
+PyYAML==6.0.1
+pyzmq==26.0.3
+qtconsole==5.5.2
+QtPy==2.4.1
+rapidfuzz==3.9.5
+readme-renderer==42.0
+referencing==0.35.1
+regex==2024.7.24
+requests==2.31.0
+requests-oauthlib==1.3.1
+requests-toolbelt==1.0.0
+rfc3339-validator==0.1.4
+rfc3986==2.0.0
+rfc3986-validator==0.1.1
+rich==13.7.0
+rpds-py==0.19.1
+ruamel.yaml==0.18.5
+ruamel.yaml.clib==0.2.8
+ruff==0.4.5
+scikit-learn==1.5.1
+scipy==1.11.4
+SecretStorage==3.3.3
+semver==3.0.2
+Send2Trash==1.8.3
+setuptools-scm==8.0.4
+sgmllib3k==1.0.0
+shellingham==1.5.4
+six==1.16.0
+sniffio==1.3.0
+snowballstemmer==2.2.0
+soupsieve==2.5
+Sphinx==7.2.6
+sphinx-autobuild==2021.3.14
+sphinx-basic-ng==1.0.0b2
+sphinx-click==5.1.0
+sphinx-togglebutton==0.3.2
+sphinxcontrib-applehelp==1.0.7
+sphinxcontrib-devhelp==1.0.5
+sphinxcontrib-htmlhelp==2.0.4
+sphinxcontrib-jsmath==1.0.1
+sphinxcontrib-qthelp==1.0.6
+sphinxcontrib-serializinghtml==1.1.9
+SQLAlchemy==2.0.24
+stack-data==0.6.3
+statsmodels==0.14.2
+sympy==1.12
+tables==3.9.2
+tabulate==0.9.0
+tenacity==8.2.3
+termcolor==2.4.0
+terminado==0.18.1
+threadpoolctl==3.5.0
+tiktoken==0.7.0
+tinycss2==1.3.0
+toml-sort==0.23.1
+tomlkit==0.12.3
+torch==2.1.2
+torch_geometric==2.5.3
+tornado==6.4
+tqdm==4.66.1
+traitlets==5.14.3
+tree-sitter==0.22.3
+tree-sitter-python==0.21.0
+triton==2.1.0
+twine==4.0.2
+typer==0.9.0
+types-psutil==6.0.0.20240621
+types-python-dateutil==2.9.0.20240316
+types-PyYAML==6.0.12.20240724
+types-tqdm==4.66.0.20240417
+typing-inspect==0.9.0
+typing_extensions==4.9.0
+tzdata==2023.4
+uri-template==1.3.0
+urllib3==2.1.0
+wcwidth==0.2.13
+webcolors==24.6.0
+webencodings==0.5.1
+websocket-client==1.8.0
+widgetsnbextension==4.0.11
+yarl==1.9.4
+zipp==3.17.0

constraints/data_config.yaml

@@ -1,44 +0,0 @@
-# ============================================================
-#  Predix Data Configuration
-#  Change instrument, frequency, and time periods here
-#  All other components read from this file
-# ============================================================
-
-instrument: EURUSD
-frequency: 1min          # 1min, 5min, 15min, 1h, 1d
-data_path: ~/.qlib/qlib_data/eurusd_1min_data
-
-# Available columns (no $factor column!)
-columns:
-  - $open
-  - $close
-  - $high
-  - $low
-  - $volume
-
-# Walk-Forward Split
-train_start: "2022-03-14"
-train_end:   "2024-06-30"
-valid_start: "2024-07-01"
-valid_end:   "2024-12-31"
-test_start:  "2025-01-01"
-test_end:    "2026-03-20"
-
-# Market Context for LLM Prompts
-market_context:
-  spread_bps: 1.5
-  sessions:
-    asian:   "00:00-08:00 UTC"
-    london:  "08:00-16:00 UTC"
-    ny:      "13:00-21:00 UTC"
-    overlap: "13:00-16:00 UTC"
-  target_arr: 9.62          # % ARR to beat
-  max_drawdown: 20          # % maximum drawdown
-
-# Lookback Reference (in Bars)
-lookback:
-  1h:  4
-  2h:  8
-  4h:  16
-  8h:  32
-  1d:  96

data_config.yaml

@@ -1,43 +0,0 @@
-# PREDIX Data Configuration
-#
-# This file configures the data sources and paths for EUR/USD trading.
-# Adjust paths and settings to match your environment.
-
-# Data source configuration
-data_source:
-  type: "qlib"  # Options: qlib, csv, api
-  provider: "eurusd_1min"
-
-# Data paths
-paths:
-  qlib_data_dir: "~/.qlib/qlib_data/eurusd_1min_data"
-  raw_data_dir: "data_raw"
-  cache_dir: ".cache"
-
-# Instrument configuration
-instrument:
-  symbol: "EURUSD"
-  timeframe: "1min"
-  sessions:
-    asian:
-      start: "00:00"
-      end: "08:00"
-    london:
-      start: "08:00"
-      end: "16:00"
-    ny:
-      start: "13:00"
-      end: "21:00"
-    overlap:
-      start: "13:00"
-      end: "16:00"
-
-# Trading costs
-costs:
-  spread_bps: 1.5  # Average spread in basis points
-  commission_bps: 0.0  # Commission (if any)
-
-# Data range
-date_range:
-  start: "2020-01-01"
-  end: "2026-03-20"

docs/ATTRIBUTION.md

@@ -1,101 +0,0 @@
-# Attribution Guidelines
-
-## Using Predix in Your Project
-
-If you use code, concepts, or ideas from this project, you **must**:
-
-### 1. Keep the MIT License
-
-Include the full MIT License text in your project's LICENSE file or documentation.
-
-### 2. Include Copyright Notice
-
-```
-Copyright (c) 2025 Predix Team
-Original Project: https://github.com/TPTBusiness/Predix
-```
-
-### 3. Provide Attribution
-
-Add a notice in your documentation or README:
-
-```markdown
-## Acknowledgments
-
-This project uses code/concepts from [Predix](https://github.com/TPTBusiness/Predix), 
-licensed under the [MIT License](https://opensource.org/licenses/MIT).
-```
-
-### 4. State Changes
-
-If you modified the code:
-
-```markdown
-## Modifications
-
-Based on Predix (original by Predix Team).
-Modified by [Your Name/Organization] on [Date].
-Changes: [Brief description of changes]
-```
-
----
-
-## What You CAN Do
-
-✅ Use in commercial projects
-✅ Modify the code
-✅ Distribute copies
-✅ Use in proprietary software
-✅ Sell products that include this code
-
-## What You CANNOT Do
-
-❌ Remove copyright notice
-❌ Remove license text
-❌ Claim you wrote the original code
-❌ Hold the authors liable
-
----
-
-## Example Attribution
-
-**Good Example:**
-```markdown
-# My Trading Project
-
-This project uses factor generation concepts from [Predix](https://github.com/TPTBusiness/Predix).
-
-## License
-MIT License - see LICENSE file for details.
-
-## Credits
-- Original Predix code by Predix Team (MIT License)
-- Modified by John Doe, 2025
-```
-
-**Bad Example (Copyright Violation):**
-```markdown
-# My Trading Project
-
-All code written by John Doe.
-All rights reserved. No copying allowed.
-```
-
----
-
-## Legal Basis
-
-This requirement comes from the MIT License itself:
-
-> "The above copyright notice and this permission notice shall be included 
-> in all copies or substantial portions of the Software."
-
-Failure to comply means your license to use this code is automatically terminated.
-
----
-
-## Questions?
-
-If you're unsure about attribution requirements, please open an issue or contact us.
-
-We want our code to be used and appreciated, but proper attribution is essential.

docs/CHANGELOG.md

@@ -1,34 +0,0 @@
-# Changelog
-
-All notable changes to Predix will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## Releases
-
-### Version 1.0.0 (2026-04-02)
-
-**Initial Release - EURUSD Trading Agent**
-
-📄 **Detailed release notes:** [changelog/v1.0.0.md](changelog/v1.0.0.md)
-
-**Highlights:**
-- ✨ 110+ EURUSD factors generated autonomously
-- 🧠 Multi-agent debate system (Bull/Bear/Neutral)
-- 📊 Backtesting engine with IC, Sharpe, Drawdown
-- 🗄️ SQLite database for tracking results
-- ⚖️ Risk management with correlation analysis
-- 📱 Web + CLI dashboards
-- ✅ 97 tests with 98.77% coverage
-- 📚 Comprehensive documentation
-
----
-
-## Historical Changes (from RD-Agent upstream)
-
-For earlier changes inherited from the RD-Agent project, see the [upstream changelog](https://github.com/microsoft/RD-Agent/blob/main/CHANGELOG.md).
-
----
-
-## [Unreleased]

docs/IMPLEMENTATION_SUMMARY.md

@@ -1,95 +0,0 @@
-# 🎯 PREDIX: Vollständige Integration in fin_quant Loop
-
-## ✅ Implementierte Features
-
-### 1. Realistisches Backtesting
-- **Echte OHLCV-Daten** aus `intraday_pv.h5` (2.26M Bars, 2020-2026)
-- **Forward-Fill** täglicher Faktoren auf 1-Min-Frequenz
-- **Spread-Kosten**: 1.5 bps pro Trade
-- **Korrekte Annualisierung**: sqrt(252*1440) für 1-Min-Daten
-
-### 2. Verbesserter LLM-Prompt
-- **IC-geführte Faktorwahl**: |IC| > 0.10 PRIORITIZE, |IC| > 0.05 USE
-- **IC-gewichtete Kombinationen**: Höhere IC = höheres Gewicht
-- **Bessere Beispiele** mit IC-Gewichten im Prompt
-- **Verfügbarkeit von 'close' Series** für zusätzliche Berechnungen
-
-### 3. Optuna-Optimierung
-- **20 Trials pro Strategie** (konfigurierbar)
-- **TPESampler** mit MedianPruner
-- **Optimiert**: entry_threshold, rolling_window, SL, TP, Trailing Stop
-- **Auto-Update** wenn Optuna Sharpe verbessert
-
-### 4. Automatische Strategiegenerierung
-- **Trigger**: Alle 500 Faktoren (konfigurierbar)
-- **3 Strategien pro Zyklus** mit zufälligen Faktor-Kombinationen
-- **Graceful Degradation**: Bricht Hauptloop nicht bei Fehlern
-
-## 🚀 Benutzung
-
-### Automatisch (im fin_quant Loop)
-```bash
-# Standard: Alle 500 Faktoren
-rdagent fin_quant --auto-strategies
-
-# Custom threshold
-rdagent fin_quant --auto-strategies --auto-strategies-threshold 1000
-
-# Mit OpenRouter
-rdagent fin_quant -m openrouter --auto-strategies
-```
-
-### Manuell
-```bash
-# 5 Strategien mit Optuna
-rdagent generate_strategies --count 5 --optuna --optuna-trials 20
-
-# Ohne Optuna (schneller)
-rdagent generate_strategies --count 5 --no-optuna
-```
-
-## 📊 Testergebnisse
-
-### MomentumDivergenceZScore (vorher vs. nachher)
-
-| Metrik | Vorher | Nachher |
-|--------|--------|---------|
-| **Datenpunkte** | 259 (4.3h) | 823,450 (2.27 Jahre) |
-| **Sharpe** | 3.59 | 6.04 |
-| **Max DD** | -0.22% | -1.57% |
-| **Win Rate** | 49.46% | 49.19% |
-| **Ann Return** | 543% (falsch) | 21.88% ✅ |
-
-## 🔧 Architecture
-
-```
-fin_quant Loop
-    │
-    ├─ Factor Generation (LLM → Docker → Evaluation)
-    │   └─ Every 500 factors → Trigger Strategy Generation
-    │
-    └─ StrategyOrchestrator (auto-strategies)
-        │
-        ├─ Load Top 50 Factors (by IC)
-        ├─ For each strategy (3x):
-        │   ├─ Select random 2-5 factors
-        │   ├─ LLM generates code (improved prompt)
-        │   ├─ Evaluate with real OHLCV
-        │   ├─ Optuna optimize (20 trials)
-        │   └─ Save if accepted
-        │
-        └─ Log results
-```
-
-## 📝 Nächste Schritte
-
-1. **Live Trading**: Bestehende Strategien für Paper Trading nutzen
-2. **Mehr Faktoren**: Weiterhin Faktoren generieren für bessere Strategien
-3. **Dashboard**: Live-Statistiken im Web/CLI Dashboard anzeigen
-
-## ⚠️ Wichtige Hinweise
-
-- **Forward-Fill** kann zu Daten-Leakage führen (tägliche Werte werden auf Minuten aufgefüllt)
-- **Optuna** benötigt 20-30 Sekunden pro Strategie
-- **Auto-Strategies** nur wenn ≥10 Faktoren verfügbar
-- **LLM** muss verfügbar sein (local oder openrouter)

docs/STRATEGY_BUILDER_DESIGN.md

@@ -1,890 +0,0 @@
-# StrategyBuilder — Architektur-Design
-
-## Überblick
-
-Der **StrategyBuilder** kombiniert existierende Faktoren systematisch zu handelbaren Strategien. 
-Im Gegensatz zum ML-Trainer (der ein einzelnes Modell auf Top-Faktoren trainiert) testet der 
-StrategyBuilder **explizite Kombinationsregeln** mit Walk-Forward-Validierung.
-
----
-
-## 1. Klassen-Design
-
-### 1.1 StrategyCombinator
-
-**Zweck:** Generiert systematische Faktorkombinationen nach verschiedenen Strategien.
-
-```python
-# rdagent/scenarios/qlib/developer/strategy_builder.py
-
-class CombinationStrategy(Enum):
-    """Supported combination methods."""
-    PAIR = "pair"                    # Top-N pairs by IC product
-    TRIPLET = "triplet"              # Top triplets
-    CATEGORY = "category"            # All factors of same type
-    TEMPORAL = "temporal"            # Session/time-specific combos
-    CUSTOM = "custom"                # User-defined combinations
-
-
-@dataclass
-class StrategySpec:
-    """Defines a single strategy configuration."""
-    name: str
-    factors: List[str]               # Factor names to combine
-    combination_type: str            # "weighted_sum", "regime_switch", etc.
-    weighting: str                   # "equal", "ic_weighted", "risk_parity"
-    metadata: Dict[str, Any]         # Additional context (category, session, etc.)
-
-
-class StrategyCombinator:
-    """Generate factor combinations systematically."""
-
-    def __init__(
-        self,
-        factors_db: ResultsDatabase,
-        min_ic: float = 0.02,
-        max_factors_per_strategy: int = 5,
-    ) -> None: ...
-
-    def load_valid_factors(self, min_ic: float = 0.02) -> pd.DataFrame:
-        """Load all factors with IC >= threshold from DB."""
-        ...
-
-    def generate_pairs(
-        self,
-        top_n: int = 50,
-        max_correlation: float = 0.7,
-    ) -> List[StrategySpec]:
-        """
-        Generate pairwise combinations.
-        
-        Rules:
-        - Take top_n factors by |IC|
-        - Filter pairs with correlation < max_correlation
-        - Score by |IC1 * IC2| (both must have predictive power)
-        - Prefer complementary pairs (one positive IC, one negative)
-        """
-        ...
-
-    def generate_triplets(
-        self,
-        top_n: int = 30,
-        max_pairwise_corr: float = 0.5,
-    ) -> List[StrategySpec]:
-        """
-        Generate triplet combinations.
-        
-        Rules:
-        - Top 30 factors by |IC|
-        - All pairwise correlations < max_pairwise_corr
-        - Score by geometric mean of |IC|
-        """
-        ...
-
-    def generate_category_combos(
-        self,
-        category: str,
-        min_factors: int = 2,
-        max_factors: int = 5,
-    ) -> List[StrategySpec]:
-        """
-        Combine all factors within a category.
-        
-        Categories (inferred from factor names):
-        - "Momentum": mom_*, trend_*
-        - "Mean Reversion": mean_rev_*, reversal_*
-        - "Volatility": vol_*, std_*
-        - "Session": session_*, intraday_*
-        - "Volume": volume_*, turnover_*
-        """
-        ...
-
-    def generate_temporal_combos(
-        self,
-        session_filters: Dict[str, Callable],
-    ) -> List[StrategySpec]:
-        """
-        Generate session-specific combinations.
-        
-        Example strategies:
-        - "London Open": Use momentum factors 07:00-09:00 UTC
-        - "NY Close": Use mean reversion 14:00-16:00 UTC
-        - "Asian Session": Use volatility factors 00:00-06:00 UTC
-        """
-        ...
-
-    def generate_custom_combo(
-        self,
-        factor_names: List[str],
-        weighting: str = "equal",
-    ) -> StrategySpec:
-        """User-defined combination for testing specific hypotheses."""
-        ...
-
-    def generate_all(
-        self,
-        strategies: List[CombinationStrategy] = None,
-    ) -> List[StrategySpec]:
-        """
-        Run all enabled combination strategies.
-        
-        Default: PAIR + TRIPLET + CATEGORY
-        Returns list of all StrategySpec objects.
-        """
-        ...
-```
-
----
-
-### 1.2 StrategyEvaluator
-
-**Zweck:** Walk-Forward-Backtesting für Strategien mit Transaktionskosten.
-
-```python
-@dataclass
-class WalkForwardConfig:
-    """Walk-forward validation configuration."""
-    train_window: int = 30           # Days for training
-    test_window: int = 5             # Days for out-of-sample testing
-    step_size: int = 5               # Days to slide forward
-    min_train_periods: int = 3       # Minimum windows before first test
-
-
-@dataclass
-class TransactionCostModel:
-    """Realistic transaction cost modeling."""
-    cost_per_trade_bps: float = 1.5  # 1.5 bps per trade
-    slippage_bps: float = 0.5        # Additional slippage
-    min_trade_size: float = 0.01     # Minimum position size
-
-
-class StrategyMetrics:
-    """Complete metrics for a validated strategy."""
-    
-    def __init__(self, strategy_name: str) -> None: ...
-    
-    def update(
-        self,
-        window_idx: int,
-        in_sample_ic: float,
-        out_of_sample_ic: float,
-        oos_sharpe: float,
-        oos_return: float,
-        oos_drawdown: float,
-        n_trades: int,
-        transaction_costs: float,
-    ) -> None: ...
-    
-    def finalize(self) -> Dict[str, Any]:
-        """
-        Calculate aggregate metrics:
-        
-        - Mean OOS IC
-        - IC decay (IS IC vs OOS IC)
-        - Mean OOS Sharpe
-        - Worst OOS Drawdown
-        - Calmar Ratio (Ann Return / Max DD)
-        - Total transaction costs
-        - Win rate across windows
-        - Consistency score (% windows with positive IC)
-        """
-        ...
-
-
-class StrategyEvaluator:
-    """Walk-forward backtesting for strategy combinations."""
-
-    def __init__(
-        self,
-        data_source: str,              # Path to intraday_pv.h5
-        wf_config: WalkForwardConfig = None,
-        cost_model: TransactionCostModel = None,
-    ) -> None: ...
-
-    def load_factor_values(
-        self,
-        factor_names: List[str],
-    ) -> Dict[str, pd.Series]:
-        """Load time series values for each factor."""
-        ...
-
-    def compute_combined_signal(
-        self,
-        factor_values: Dict[str, pd.Series],
-        weights: Dict[str, float],
-        combination_type: str = "weighted_sum",
-    ) -> pd.Series:
-        """
-        Combine factors into single signal.
-        
-        Types:
-        - "weighted_sum": sum(w_i * factor_i)
-        - "regime_switch": use different factors per regime
-        - "timing": use volatility to scale momentum
-        """
-        ...
-
-    def walk_forward_backtest(
-        self,
-        strategy_spec: StrategySpec,
-    ) -> StrategyMetrics:
-        """
-        Run walk-forward validation for a single strategy.
-        
-        Process:
-        1. Split time series into rolling windows
-        2. For each window:
-           a. Optimize weights on train period
-           b. Test on out-of-sample period
-           c. Apply transaction costs
-           d. Record metrics
-        3. Aggregate across all windows
-        
-        Returns StrategyMetrics with full validation results.
-        """
-        ...
-
-    def backtest_single_window(
-        self,
-        train_data: pd.DataFrame,
-        test_data: pd.DataFrame,
-        strategy_spec: StrategySpec,
-    ) -> Dict[str, float]:
-        """
-        Backtest strategy on single train/test split.
-        
-        Steps:
-        1. Compute factor values on train period
-        2. Optimize weights (IC-weighted or risk parity)
-        3. Apply to test period
-        4. Calculate returns with transaction costs
-        5. Return metrics
-        """
-        ...
-
-    def apply_transaction_costs(
-        self,
-        raw_returns: pd.Series,
-        signals: pd.Series,
-        cost_model: TransactionCostModel,
-    ) -> pd.Series:
-        """
-        Deduct transaction costs from returns.
-        
-        Cost = (signal changes) * (cost_per_trade + slippage)
-        Only charged when position actually changes.
-        """
-        ...
-```
-
----
-
-### 1.3 StrategySelector
-
-**Zweck:** Selektiere beste Strategien nach Out-of-Sample-Performance.
-
-```python
-@dataclass
-class StrategyRanking:
-    """Ranking criteria for strategies."""
-    primary_metric: str = "oos_sharpe"     # oos_sharpe, calmar, oos_ic
-    min_oos_ic: float = 0.02               # Minimum OOS IC
-    max_drawdown: float = -0.15            # Maximum allowed drawdown
-    min_consistency: float = 0.6           # % of windows with positive IC
-    min_windows: int = 3                   # Minimum validation windows
-
-
-class StrategySelector:
-    """Select and rank best strategies based on walk-forward results."""
-
-    def __init__(
-        self,
-        ranking: StrategyRanking = None,
-    ) -> None: ...
-
-    def rank_strategies(
-        self,
-        strategy_results: List[Dict[str, Any]],
-    ) -> pd.DataFrame:
-        """
-        Rank strategies by primary metric.
-        
-        Filters:
-        - OOS IC >= min_oos_ic
-        - Max DD <= max_drawdown threshold
-        - Consistency >= min_consistency
-        - At least min_windows validated
-        
-        Returns sorted DataFrame with:
-        - strategy_name
-        - oos_sharpe (primary)
-        - oos_ic_mean
-        - ic_decay (IS vs OOS gap)
-        - calmar_ratio
-        - max_drawdown
-        - consistency_score
-        - n_windows
-        - total_transaction_costs
-        """
-        ...
-
-    def select_top_k(
-        self,
-        ranked: pd.DataFrame,
-        k: int = 10,
-    ) -> List[Dict[str, Any]]:
-        """Return top K strategies passing all filters."""
-        ...
-
-    def identify_overfitting(
-        self,
-        strategy_results: List[Dict[str, Any]],
-        ic_decay_threshold: float = 0.5,
-    ) -> List[str]:
-        """
-        Flag strategies where OOS IC < 50% of IS IC.
-        Indicates overfitting to training period.
-        """
-        ...
-
-    def recommend_ensemble(
-        self,
-        ranked: pd.DataFrame,
-        max_correlation: float = 0.3,
-        max_strategies: int = 3,
-    ) -> List[str]:
-        """
-        Recommend ensemble of uncorrelated strategies.
-        
-        Select up to max_strategies with:
-        - Highest combined Sharpe
-        - Pairwise correlation < max_correlation
-        """
-        ...
-```
-
----
-
-### 1.4 StrategySaver
-
-**Zweck:** Persistiert Strategien in `results/strategies/`.
-
-```python
-class StrategySaver:
-    """Save validated strategies to results/strategies/."""
-
-    def __init__(
-        self,
-        strategies_dir: Optional[str] = None,
-    ) -> None:
-        project_root = Path(__file__).parent.parent.parent.parent
-        self.strategies_dir = Path(strategies_dir) if strategies_dir \
-            else project_root / "results" / "strategies"
-        self.strategies_dir.mkdir(parents=True, exist_ok=True)
-
-    def save_strategy(
-        self,
-        strategy_spec: StrategySpec,
-        metrics: Dict[str, Any],
-        ranking: Dict[str, Any] = None,
-    ) -> Path:
-        """
-        Save complete strategy to JSON.
-        
-        JSON structure:
-        {
-            "name": "momentum_mean_rev_pair",
-            "created_at": "2026-04-05T12:00:00",
-            "combination_type": "pair",
-            "factors": ["Momentum_v3", "MeanReversion_v2"],
-            "weights": {"Momentum_v3": 0.63, "MeanReversion_v2": 0.37},
-            "weighting_method": "ic_weighted",
-            
-            "walk_forward": {
-                "train_window_days": 30,
-                "test_window_days": 5,
-                "n_windows": 8,
-                "total_test_days": 40
-            },
-            
-            "metrics": {
-                "oos_ic_mean": 0.045,
-                "oos_ic_std": 0.012,
-                "is_ic_mean": 0.062,
-                "ic_decay": 0.27,
-                "oos_sharpe": 2.15,
-                "oos_annualized_return": 0.128,
-                "oos_max_drawdown": -0.089,
-                "calmar_ratio": 1.44,
-                "consistency_score": 0.875,
-                "win_rate": 0.58,
-                "total_transaction_costs_bps": 12.4,
-                "net_sharpe": 1.98
-            },
-            
-            "per_window_metrics": [
-                {"window": 0, "oos_ic": 0.051, "oos_sharpe": 2.3, ...},
-                {"window": 1, "oos_ic": 0.038, "oos_sharpe": 1.9, ...},
-                ...
-            ],
-            
-            "ranking": {
-                "rank_by_sharpe": 3,
-                "rank_by_ic": 5,
-                "rank_by_calmar": 2,
-                "passes_filters": true
-            }
-        }
-        """
-        ...
-
-    def load_all_strategies(
-        self,
-        min_oos_sharpe: float = None,
-    ) -> List[Dict[str, Any]]:
-        """Load all saved strategies, optionally filtered."""
-        ...
-
-    def load_best_strategy(self) -> Optional[Dict[str, Any]]:
-        """Load the single best strategy by OOS Sharpe."""
-        ...
-```
-
----
-
-## 2. Kombinations-Logik
-
-### 2.1 Faktor-Auswahl für Kombinationen
-
-```python
-def select_factors_for_combination(
-    factors_df: pd.DataFrame,
-    min_ic: float = 0.02,
-    max_correlation: float = 0.7,
-) -> Tuple[List[str], pd.DataFrame]:
-    """
-    Select factors suitable for combination.
-    
-    Algorithm:
-    1. Filter: |IC| >= min_ic
-    2. Compute correlation matrix
-    3. Cluster factors by correlation (hierarchical clustering)
-    4. From each cluster, pick factor with highest |IC|
-    5. Return selected factors + correlation matrix
-    
-    Rationale:
-    - Avoid combining highly correlated factors (redundant)
-    - Ensure each selected factor has standalone predictive power
-    - Maximize diversity in combinations
-    """
-    ...
-```
-
-### 2.2 Pair-Strategie
-
-```
-Regel: Kombiniere Faktor A + B wenn:
-  1. |IC_A| >= 0.02 UND |IC_B| >= 0.02
-  2. Korrelation(A, B) < 0.7
-  3. Score = |IC_A * IC_B| * (1 - corr(A, B))
-  
-Priorisiere:
-  - Momentum + Mean Reversion (komplementär)
-  - Volatility + Momentum (Timing)
-  - Session + Hauptfaktor (Filter)
-```
-
-### 2.3 Triplet-Strategie
-
-```
-Regel: Kombiniere Faktor A + B + C wenn:
-  1. Alle |IC| >= 0.02
-  2. Alle pairwise Korrelationen < 0.5
-  3. Score = (|IC_A| * |IC_B| * |IC_C|)^(1/3) * diversity_factor
-  
-Priorisiere:
-  - Momentum + Mean Reversion + Volatility
-  - Hauptfaktor + Session + Volatility
-  - Drei unkorrelierte Alpha-Faktoren
-```
-
-### 2.4 Gewichtungsmethoden
-
-```python
-def compute_weights(
-    factor_ics: Dict[str, float],
-    factor_correlations: pd.DataFrame,
-    method: str = "ic_weighted",
-) -> Dict[str, float]:
-    """
-    Compute factor weights.
-    
-    Methods:
-    
-    1. "equal": w_i = 1/N
-    
-    2. "ic_weighted": w_i = |IC_i| / sum(|IC|)
-       - Simple, effective when ICs are reliable
-       
-    3. "risk_parity": 
-       - w_i proportional to 1/vol_i
-       - Equalize risk contribution from each factor
-       - Requires factor return covariance matrix
-       
-    4. "sharpe_weighted": w_i = Sharpe_i / sum(Sharpe)
-       - Weight by risk-adjusted performance
-       
-    Returns normalized weights summing to 1.0
-    """
-    ...
-```
-
----
-
-## 3. Walk-Forward-Validierung
-
-### 3.1 Schema
-
-```
-Zeitachse (Beispiel: 90 Tage Daten):
-
-[---- Train 30d ----][Test 5d][---- Train 30d ----][Test 5d]...
-      Window 0                   Window 1
-
-Gesamt: ~8 Walks bei 90 Tagen
-```
-
-### 3.2 Ablauf pro Window
-
-```python
-for window_idx in range(n_windows):
-    # 1. Define train/test periods
-    train_start = window_idx * step_size
-    train_end = train_start + train_window
-    test_start = train_end
-    test_end = test_start + test_window
-    
-    # 2. Optimize weights on train period
-    weights = optimize_weights(
-        factor_values[train_start:train_end],
-        forward_returns[train_start:train_end],
-        method=strategy_spec.weighting,
-    )
-    
-    # 3. Generate signal on test period
-    signal = compute_combined_signal(
-        factor_values[test_start:test_end],
-        weights,
-    )
-    
-    # 4. Calculate returns with costs
-    raw_returns = signal.shift(1) * forward_returns[test_start:test_end]
-    net_returns = apply_transaction_costs(raw_returns, signal, cost_model)
-    
-    # 5. Record metrics
-    metrics.update(
-        window_idx=window_idx,
-        in_sample_ic=compute_ic(train_period),
-        out_of_sample_ic=compute_ic(test_period),
-        oos_sharpe=calculate_sharpe(net_returns),
-        oos_drawdown=calculate_max_drawdown(net_returns),
-        n_trades=count_signal_changes(signal),
-        transaction_costs=raw_returns.sum() - net_returns.sum(),
-    )
-```
-
-### 3.3 Aggregierte Metriken
-
-```python
-final_metrics = {
-    # Primary
-    "oos_ic_mean": mean(window_oos_ics),
-    "oos_ic_std": std(window_oos_ics),
-    "oos_sharpe": mean(window_sharpes),
-    
-    # Overfitting detection
-    "is_ic_mean": mean(window_is_ics),
-    "ic_decay": 1 - (oos_ic_mean / is_ic_mean),  # < 0.5 good
-    
-    # Risk
-    "oos_max_drawdown": min(window_drawdowns),
-    "calmar_ratio": annualized_return / abs(max_drawdown),
-    
-    # Consistency
-    "consistency_score": sum(ic > 0 for ic in window_oos_ics) / n_windows,
-    
-    # Costs
-    "total_transaction_costs_bps": sum(window_costs),
-    "net_sharpe": sharpe_after_costs,
-}
-```
-
----
-
-## 4. Integrationspunkte mit factor_runner.py
-
-### 4.1 Wo passt der StrategyBuilder hin?
-
-```
-Bestehender Flow (factor_runner.py):
-┌─────────────────────────────────────────┐
-│ 1. Hypothesis Gen → Factor Hypothesis   │
-│ 2. Factor Coder → Generate factor code  │
-│ 3. Factor Runner → Docker backtest      │
-│ 4. Protection Check → Risk validation   │
-│ 5. Save to DB → ResultsDatabase         │
-│ 6. Feedback → Guide next hypothesis     │
-└─────────────────────────────────────────┘
-
-NEUER Flow (StrategyBuilder):
-┌─────────────────────────────────────────┐
-│ 7. StrategyCombinator → Combos          │  ← AFTER factor generation
-│ 8. StrategyEvaluator → Walk-forward     │  ← SEPARATE phase
-│ 9. StrategySelector → Rank strategies   │
-│ 10. StrategySaver → results/strategies/ │
-└─────────────────────────────────────────┘
-```
-
-### 4.2 Konkrete Integration
-
-```python
-# Option A: Eigenständiger CLI-Befehl (empfohlen)
-# rdagent/build_strategies --top-n 100 --walk-forward
-
-# Option B: Integration in QuantRDLoop
-class QuantRDLoop:
-    def running(self, prev_out):
-        # ... existing factor runner code ...
-        exp = self.factor_runner.develop(prev_out["coding"])
-        
-        # NEW: Periodically run strategy builder
-        if self.should_build_strategies():
-            self._run_strategy_builder()
-        
-        return exp
-    
-    def should_build_strategies(self) -> bool:
-        """Check if enough factors exist to build strategies."""
-        n_factors = self.trace.get_valid_factor_count()
-        return n_factors >= 100 and self.loop_idx % 50 == 0
-    
-    def _run_strategy_builder(self) -> None:
-        """Trigger strategy building process."""
-        from rdagent.scenarios.qlib.developer.strategy_builder import (
-            StrategyBuilder,
-        )
-        
-        builder = StrategyBuilder(
-            db=self.results_db,
-            data_source=self.data_path,
-        )
-        builder.run(top_n=100)
-```
-
-### 4.3 Datenabhängigkeiten
-
-```python
-# Benötigt von factor_runner.py:
-# ✅ ResultsDatabase → already exists, factor_runner schreibt dort
-# ✅ Factor JSON files → already in results/factors/
-# ✅ Factor values → Müssen aus workspace/result.h5 geladen werden
-
-# Neue Abhängigkeit:
-# ⚠️ Factor time series values → Müssen für Walk-Forward verfügbar sein
-#   Lösung: Factor values beim Speichern in DB auch als Parquet schreiben
-```
-
----
-
-## 5. Integration in QuantRDLoop Workflow
-
-### 5.1 Erweiterte Loop-Phasen
-
-```
-Phase 1: Factor Generation (EXISTIEREND)
-    └─ Generate → Code → Backtest → Save to DB
-    └─ Continue until N factors reached (z.B. 500)
-
-Phase 2: Strategy Building (NEU)
-    └─ Load top factors from DB
-    └─ Generate combinations (pairs, triplets, categories)
-    └─ Walk-forward validation
-    └─ Save strategies to results/strategies/
-
-Phase 3: Strategy Selection (NEU)
-    └─ Rank by OOS Sharpe
-    └─ Filter by max drawdown, consistency
-    └─ Select top 3 strategies for live trading
-
-Phase 4: ML Training (EXISTIEREND, optional)
-    └─ Train ML model on top strategies' factors
-    
-Phase 5: Live Trading (ZUKUNFT)
-    └─ Paper trade selected strategies
-    └─ Monitor and adapt
-```
-
-### 5.2 Haupt-CLI-Befehl
-
-```python
-# rdagent/scenarios/qlib/developer/strategy_builder.py
-
-class StrategyBuilder:
-    """Main orchestrator for strategy building process."""
-    
-    def __init__(
-        self,
-        db: ResultsDatabase,
-        data_source: str,
-        output_dir: Optional[str] = None,
-    ) -> None:
-        self.db = db
-        self.data_source = data_source
-        self.combinator = StrategyCombinator(db)
-        self.evaluator = StrategyEvaluator(data_source)
-        self.selector = StrategySelector()
-        self.saver = StrategySaver(output_dir)
-    
-    def run(
-        self,
-        top_n: int = 100,
-        min_ic: float = 0.02,
-        strategies: List[CombinationStrategy] = None,
-        save: bool = True,
-    ) -> pd.DataFrame:
-        """
-        Complete strategy building pipeline.
-        
-        Steps:
-        1. Load top N factors from DB
-        2. Generate combinations
-        3. Walk-forward validate each
-        4. Rank and filter
-        5. Save top strategies
-        6. Return ranked results
-        """
-        logger.info(f"=== Strategy Builder: Top {top_n} factors ===")
-        
-        # Step 1: Load factors
-        factors = self.combinator.load_valid_factors(min_ic=min_ic)
-        logger.info(f"Loaded {len(factors)} valid factors")
-        
-        # Step 2: Generate combinations
-        combos = self.combinator.generate_all(strategies)
-        logger.info(f"Generated {len(combos)} strategy combinations")
-        
-        # Step 3: Walk-forward validate
-        results = []
-        for spec in combos:
-            logger.info(f"Evaluating: {spec.name}")
-            metrics = self.evaluator.walk_forward_backtest(spec)
-            results.append(metrics.finalize())
-        
-        # Step 4: Rank
-        ranked = self.selector.rank_strategies(results)
-        
-        # Step 5: Save
-        if save:
-            for _, row in ranked.iterrows():
-                spec = next(s for s in combos if s.name == row["strategy_name"])
-                self.saver.save_strategy(spec, row)
-        
-        logger.info(f"=== Top 5 Strategies ===")
-        logger.info(ranked.head(5).to_string())
-        
-        return ranked
-
-
-def build_strategies(
-    top_n: int = 100,
-    min_ic: float = 0.02,
-    data_source: str = None,
-) -> None:
-    """CLI entry point: rdagent build_strategies"""
-    from rdagent.components.backtesting.results_db import ResultsDatabase
-    
-    db = ResultsDatabase()
-    
-    if data_source is None:
-        data_source = str(Path(__file__).parent.parent.parent.parent.parent 
-                          / "git_ignore_folder" 
-                          / "factor_implementation_source_data" 
-                          / "intraday_pv.h5")
-    
-    builder = StrategyBuilder(db=db, data_source=data_source)
-    ranked = builder.run(top_n=top_n, min_ic=min_ic)
-    
-    logger.info(f"\nStrategy building complete. Results in results/strategies/")
-```
-
-### 5.3 Config-Erweiterung
-
-```python
-# rdagent/app/qlib_rd_loop/conf.py
-
-@dataclass
-class StrategyBuilderSetting:
-    """Configuration for strategy building."""
-    top_n_factors: int = 100
-    min_ic_threshold: float = 0.02
-    max_correlation: float = 0.7
-    train_window_days: int = 30
-    test_window_days: int = 5
-    step_size_days: int = 5
-    transaction_cost_bps: float = 1.5
-    min_oos_sharpe: float = 1.0
-    max_drawdown_threshold: float = -0.15
-    combination_strategies: List[str] = None  # ["pair", "triplet", "category"]
-```
-
----
-
-## 6. Datei-Struktur
-
-```
-rdagent/scenarios/qlib/developer/
-└── strategy_builder.py              # Hauptmodul (alle Klassen)
-
-# ODER aufgeteilt:
-rdagent/scenarios/qlib/developer/
-└── strategy_builder/
-    ├── __init__.py
-    ├── combinator.py                # StrategyCombinator
-    ├── evaluator.py                 # StrategyEvaluator
-    ├── selector.py                  # StrategySelector
-    ├── saver.py                     # StrategySaver
-    └── builder.py                   # StrategyBuilder (Orchestrator)
-
-results/
-└── strategies/
-    ├── momentum_mean_rev_pair.json
-    ├── momentum_vol_timing.json
-    ├── session_alpha_combo.json
-    └── strategy_ranking.json        # Summary aller Strategien
-```
-
----
-
-## 7. Nächste Schritte
-
-1. **Implementierung Phase 1:** StrategyCombinator + einfache Pair-Tests
-2. **Implementierung Phase 2:** StrategyEvaluator mit Walk-Forward
-3. **Implementierung Phase 3:** StrategySelector + Saver
-4. **Integration:** CLI-Befehl `rdagent build_strategies`
-5. **Validierung:** Top-Strategien gegen Hold-out Periode testen
-6. **Dashboard:** Web-UI zur Strategie-Anzeige (erweitert)
-
----
-
-## 8. Offene Fragen
-
-- **Factor Values:** Woher kommen die Zeitreihen-Werte für jeden Faktor?
-  - Aktuell: Nur in workspace/result.h5 gespeichert (nicht persistent)
-  - Lösung: Beim Speichern in DB auch als Parquet in results/factors/values/ ablegen
-
-- **Performance:** 100 Faktoren → ~5000 Pairs → 8 Walks each = 40.000 Backtests
-  - Lösung: Parallelisierung (multiprocessing), Top-1000 Paare vorher filtern
-
-- **Regime Detection:** Wie erkennen wir Markt-Regimes?
-  - Vorschlag: Volatility-based (high/low vol), Trend-based (uptrend/downtrend)
-  - Später: ML-basiert (HMM, Clustering)

docs/conf.py

@@ -6,13 +6,11 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-import subprocess
+import importlib.metadata
 
-latest_tag = subprocess.check_output(["git", "describe", "--tags", "--abbrev=0"], text=True).strip()
-
-project = "Predix"
-copyright = "2025, Predix Team"
-author = "Predix Team"
+project = "RDAgent"
+copyright = "2024, Microsoft"
+author = "Microsoft"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -22,7 +20,7 @@ extensions = ["sphinx.ext.autodoc", "sphinxcontrib.autodoc_pydantic"]
 autodoc_member_order = "bysource"
 
 # The suffix of source filenames.
-source_suffix = {".rst": "restructuredtext"}
+source_suffix = ".rst"
 
 # The encoding of source files.
 source_encoding = "utf-8"
@@ -35,8 +33,8 @@ master_doc = "index"
 # built documents.
 #
 # The short X.Y version.
-version = latest_tag
-release = latest_tag
+version = importlib.metadata.version("rdagent")
+release = importlib.metadata.version("rdagent")
 
 # The language for content autogenerated by Sphinx. Refer to documentation for
 # a list of supported languages.
@@ -61,12 +59,4 @@ try:
 except ImportError:
     html_theme = "default"
 
-html_logo = "_static/logo.png"
 html_static_path = ["_static"]
-html_favicon = "_static/favicon.ico"
-
-html_theme_options = {
-    "source_repository": "https://github.com/PredixAI/predix",
-    "source_branch": "main",
-    "source_directory": "docs/",
-}

docs/development.rst

@@ -2,35 +2,26 @@
 For Development
 =========================
 
-If you want to try the latest version or contribute to RD-Agent. You can install it from the source and follow the commands in this page.
-
-   .. code-block:: bash
-
-      git clone https://github.com/microsoft/RD-Agent
-
-
 🔧Prepare for development
 =========================
 
 - Set up the development environment.
 
-   .. code-block:: bash
-
-      make dev
+   ```bash
+   make dev
+   ```
 
 - Run linting and checking.
 
-   .. code-block:: bash
-
-      make lint
-
+   ```bash
+   make lint
+   ```
 
 - Some linting issues can be fixed automatically. We have added a command in the Makefile for easy use.
 
-   .. code-block:: bash
-
-      make auto-lint
-
+  ```bash
+  make auto-lint
+  ```
 
 
 Code Structure
@@ -82,4 +73,4 @@ File Naming Convention
    * - `conf.py`
      - The configuration for the module, app, and project.
 
-.. <!-- TODO: renaming files -->
+<!-- TODO: renaming files -->

docs/index.rst

@@ -1,14 +1,11 @@
-.. Predix documentation master file, created by
+.. RDAgent documentation master file, created by
    sphinx-quickstart on Mon Jul 15 04:27:50 2024.
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to Predix's documentation!
+Welcome to RDAgent's documentation!
 ===================================
 
-.. image:: _static/logo.png
-   :alt: Predix Logo
-
 .. toctree::
    :maxdepth: 3
    :caption: Doctree:
@@ -23,8 +20,6 @@ Welcome to Predix's documentation!
    api_reference
    policy
 
-   GitHub <https://github.com/PredixAI/predix>
-
 
 Indices and tables
 ==================

docs/installation_and_configuration.rst

@@ -11,291 +11,13 @@ Installation
 - for dev users: `See development <development.html>`_
 
 **Install Docker**: RDAgent is designed for research and development, acting like a human researcher and developer. It can write and run code in various environments, primarily using Docker for code execution. This keeps the remaining dependencies simple. Users must ensure Docker is installed before attempting most scenarios. Please refer to the `official 🐳Docker page <https://docs.docker.com/engine/install/>`_ for installation instructions.
-Ensure the current user can run Docker commands **without using sudo**. You can verify this by executing `docker run hello-world`.
 
-LiteLLM Backend Configuration (Default)
-=======================================
-
-.. note::
-   🔥 **Attention**: We now provide experimental support for **DeepSeek** models! You can use DeepSeek's official API for cost-effective and high-performance inference. See the configuration example below for DeepSeek setup.
-
-Option 1: Unified API base for both models
-------------------------------------------
-
-   .. code-block:: Properties
-
-      # Set to any model supported by LiteLLM.
-      CHAT_MODEL=gpt-4o 
-      EMBEDDING_MODEL=text-embedding-3-small
-      # Configure unified API base
-      # The backend api_key fully follows the convention of litellm.
-      OPENAI_API_BASE=<your_unified_api_base>
-      OPENAI_API_KEY=<replace_with_your_openai_api_key>
-
-Option 2: Separate API bases for Chat and Embedding models
-----------------------------------------------------------
-
-   .. code-block:: Properties
-
-      # Set to any model supported by LiteLLM.
-      
-      # CHAT MODEL:
-      CHAT_MODEL=gpt-4o 
-      OPENAI_API_BASE=<your_chat_api_base>
-      OPENAI_API_KEY=<replace_with_your_openai_api_key>
-
-      # EMBEDDING MODEL:
-      # TAKE siliconflow as an example, you can use other providers.
-      # Note: embedding requires litellm_proxy prefix
-      EMBEDDING_MODEL=litellm_proxy/BAAI/bge-large-en-v1.5
-      LITELLM_PROXY_API_KEY=<replace_with_your_siliconflow_api_key>
-      LITELLM_PROXY_API_BASE=https://api.siliconflow.cn/v1
-
-Configuration Example: DeepSeek Setup
--------------------------------------
-
-Many users encounter configuration errors when setting up DeepSeek. Here's a complete working example:
-
-   .. code-block:: Properties
-
-      # CHAT MODEL: Using DeepSeek Official API
-      CHAT_MODEL=deepseek/deepseek-chat 
-      DEEPSEEK_API_KEY=<replace_with_your_deepseek_api_key>
-
-      # EMBEDDING MODEL: Using SiliconFlow for embedding since DeepSeek has no embedding model.
-      # Note: embedding requires litellm_proxy prefix
-      EMBEDDING_MODEL=litellm_proxy/BAAI/bge-m3
-      LITELLM_PROXY_API_KEY=<replace_with_your_siliconflow_api_key>
-      LITELLM_PROXY_API_BASE=https://api.siliconflow.cn/v1
-
-Necessary parameters include:
-
-- `CHAT_MODEL`: The model name of the chat model.
-
-- `EMBEDDING_MODEL`: The model name of the embedding model.
-
-- `OPENAI_API_BASE`: The base URL of the API. If `EMBEDDING_MODEL` does not start with `litellm_proxy/`, this is used for both chat and embedding models; otherwise, it is used for `CHAT_MODEL` only.
-
-Optional parameters (required if your embedding model is provided by a different provider than `CHAT_MODEL`):
-
-- `LITELLM_PROXY_API_KEY`: The API key for the embedding model, required if `EMBEDDING_MODEL` starts with `litellm_proxy/`.
-
-- `LITELLM_PROXY_API_BASE`: The base URL for the embedding model, required if `EMBEDDING_MODEL` starts with `litellm_proxy/`.
-
-**Note:** If you are using an embedding model from a provider different from the chat model, remember to add the `litellm_proxy/` prefix to the `EMBEDDING_MODEL` name.
-
-
-The `CHAT_MODEL` and `EMBEDDING_MODEL` parameters will be passed into LiteLLM's completion function. 
-
-Therefore, when utilizing models provided by different providers, first review the interface configuration of LiteLLM. The model names must match those allowed by LiteLLM.
-
-Additionally, you need to set up the the additional parameters for the respective model provider, and the parameter names must align with those required by LiteLLM.
-
-For example, if you are using a DeepSeek model, you need to set as follows:
-
-   .. code-block:: Properties
-
-      # For some models LiteLLM requires a prefix to the model name.
-      CHAT_MODEL=deepseek/deepseek-chat
-      DEEPSEEK_API_KEY=<replace_with_your_deepseek_api_key>
-
-Besides, when you are using reasoning models, the response might include the thought process. For this case, you need to set the following environment variable:
-   
-   .. code-block:: Properties
-      
-      REASONING_THINK_RM=True
-
-For more details on LiteLLM requirements, refer to the `official LiteLLM documentation <https://docs.litellm.ai/docs>`_.
-
-Configuration Example 2: Azure OpenAI Setup
--------------------------------------------
-Here’s a sample configuration specifically for Azure OpenAI, based on the `official LiteLLM documentation <https://docs.litellm.ai/docs>`_:
-
-If you're using Azure OpenAI, below is a working example using the Python SDK, following the `LiteLLM Azure OpenAI documentation <https://docs.litellm.ai/docs/providers/azure/>`_:
-
-   .. code-block:: Properties
-
-      from litellm import completion
-      import os
-      
-      # Set Azure OpenAI environment variables
-      os.environ["AZURE_API_KEY"] = "<your_azure_api_key>"
-      os.environ["AZURE_API_BASE"] = "<your_azure_api_base>"
-      os.environ["AZURE_API_VERSION"] = "<version>"
-      
-      # Make a request to your Azure deployment
-      response = completion(
-        "azure/<your_deployment_name>",
-        messages = [{ "content": "Hello, how are you?", "role": "user" }]
-      )
-
-To align with the Python SDK example above, you can configure the `CHAT_MODEL` based on the `response` model setting and use the corresponding `os.environ` variables by writing them into your local `.env` file as follows:
-
-   .. code-block:: Properties
-
-      cat << EOF > .env
-      # CHAT MODEL: Azure OpenAI via LiteLLM
-      CHAT_MODEL=azure/<your_deployment_name>
-      AZURE_API_BASE=https://<your_azure_base>.openai.azure.com/
-      AZURE_API_KEY=<your_azure_api_key>
-      AZURE_API_VERSION=<version>
-      
-      # EMBEDDING MODEL: Using SiliconFlow via litellm_proxy
-      EMBEDDING_MODEL=litellm_proxy/BAAI/bge-large-en-v1.5
-      LITELLM_PROXY_API_KEY=<your_siliconflow_api_key>
-      LITELLM_PROXY_API_BASE=https://api.siliconflow.cn/v1
-      EOF
-
-This configuration allows you to call Azure OpenAI through LiteLLM while using an external provider (e.g., SiliconFlow) for embeddings.
-
-If your `Azure OpenAI API Key`` supports `embedding model`, you can refer to the following configuration example.
-
-   .. code-block:: Properties
-
-      cat << EOF  > .env
-      EMBEDDING_MODEL=azure/<Model deployment supporting embedding>
-      CHAT_MODEL=azure/<your deployment name>
-      AZURE_API_KEY=<replace_with_your_openai_api_key>
-      AZURE_API_BASE=<your_unified_api_base>
-      AZURE_API_VERSION=<azure api version>
-
-Execution Environment Configuration
-===================================
-
-Coder Environment Configuration (Docker vs. Conda)
-
-RD-Agent's coders can execute code in different environments. You can control this behavior by setting environment variables in your ``.env`` file. This is useful for switching between a local Conda environment and an isolated Docker container.
-
-To configure the environment, add the corresponding line to your ``.env`` file based on the scenario you are running.
-
-**For the Model (Quant) Scenario:**
-
-The execution environment is determined by the ``MODEL_COSTEER_ENV_TYPE`` variable, which is read from ``rdagent/components/coder/model_coder/conf.py``.
-
-*   **To use Docker** (recommended for isolated execution):
-
-    .. code-block:: properties
-
-       MODEL_COSTEER_ENV_TYPE=docker
-
-*   **To use Conda** (for running in a local Conda environment):
-
-    .. code-block:: properties
-
-       MODEL_COSTEER_ENV_TYPE=conda
-
-**For the Data Science Scenario:**
-
-The execution environment is determined by the ``DS_CODER_COSTEER_ENV_TYPE`` variable, which is read from ``rdagent/components/coder/data_science/conf.py``.
-
-*   **To use Docker** (recommended for isolated execution):
-
-    .. code-block:: properties
-
-       DS_CODER_COSTEER_ENV_TYPE=docker
-
-*   **To use Conda** (for running in a local Conda environment):
-
-    .. code-block:: properties
-
-       DS_CODER_COSTEER_ENV_TYPE=conda
-
-
-Custom Time Segment Configuration (Train / Valid / Test)
-=========================================================
-
-RD-Agent now supports user-defined time segments for training, validation,
-and testing (backtesting). Users can customize these segments via environment
-variables in the ``.env`` file, depending on the scenario being executed.
-
-This feature allows greater flexibility when running experiments on different
-time ranges without modifying code or YAML configurations.
-
-Fin-Factor Scenario
--------------------
-
-When running the **fin_factor** scenario, you can configure the time segments
-using the following environment variables. These variables are read by the
-Factor-related PropSettings and directly affect the execution process.
-
-Add the following entries to your ``.env`` file as needed:
-
-.. code-block:: properties
-
-   QLIB_FACTOR_TRAIN_START=<train start date, default is 2008-01-01>
-   QLIB_FACTOR_TRAIN_END=<train end date, default is 2014-12-31>
-   QLIB_FACTOR_VALID_START=<valid start date, default is 2015-01-01>
-   QLIB_FACTOR_VALID_END=<valid end date, default is 2016-12-31>
-   QLIB_FACTOR_TEST_START=<test / backtest start date, default is 2017-01-01>
-   QLIB_FACTOR_TEST_END=<test / backtest end date, default is 2020-12-31>
-
-Fin-Model Scenario
-------------------
-
-When running the **fin_model** scenario, the model training, validation, and
-testing time segments can be configured independently via the following
-environment variables:
-
-.. code-block:: properties
-
-   QLIB_MODEL_TRAIN_START=<train start date, default is 2008-01-01>
-   QLIB_MODEL_TRAIN_END=<train end date, default is 2014-12-31>
-   QLIB_MODEL_VALID_START=<valid start date, default is 2015-01-01>
-   QLIB_MODEL_VALID_END=<valid end date, default is 2016-12-31>
-   QLIB_MODEL_TEST_START=<test / backtest start date, default is 2017-01-01>
-   QLIB_MODEL_TEST_END=<test / backtest end date, default is 2020-12-31>
-
-These settings are used during model training and evaluation and directly
-impact the execution workflow.
-
-Fin-Quant Scenario
-------------------
-
-When running the **fin_quant** scenario, RD-Agent supports configuring time
-segments for factor, model, and quant stages simultaneously.
-
-**Note:** The ``QLIB_QUANT_*`` variables are only used for front-end UI display
-purposes and do **not** affect the actual execution process.
-
-You may configure the following variables in your ``.env`` file:
-
-.. code-block:: properties
-
-   QLIB_FACTOR_TRAIN_START=<train start date, default is 2008-01-01>
-   QLIB_FACTOR_TRAIN_END=<train end date, default is 2014-12-31>
-   QLIB_FACTOR_VALID_START=<valid start date, default is 2015-01-01>
-   QLIB_FACTOR_VALID_END=<valid end date, default is 2016-12-31>
-   QLIB_FACTOR_TEST_START=<test / backtest start date, default is 2017-01-01>
-   QLIB_FACTOR_TEST_END=<test / backtest end date, default is 2020-12-31>
-
-   QLIB_MODEL_TRAIN_START=<train start date, default is 2008-01-01>
-   QLIB_MODEL_TRAIN_END=<train end date, default is 2014-12-31>
-   QLIB_MODEL_VALID_START=<valid start date, default is 2015-01-01>
-   QLIB_MODEL_VALID_END=<valid end date, default is 2016-12-31>
-   QLIB_MODEL_TEST_START=<test / backtest start date, default is 2017-01-01>
-   QLIB_MODEL_TEST_END=<test / backtest end date, default is 2020-12-31>
-
-   QLIB_QUANT_TRAIN_START=<train start date, default is 2008-01-01>
-   QLIB_QUANT_TRAIN_END=<train end date, default is 2014-12-31>
-   QLIB_QUANT_VALID_START=<valid start date, default is 2015-01-01>
-   QLIB_QUANT_VALID_END=<valid end date, default is 2016-12-31>
-   QLIB_QUANT_TEST_START=<test / backtest start date, default is 2017-01-01>
-   QLIB_QUANT_TEST_END=<test / backtest end date, default is 2020-12-31>
-
-This setup allows the front-end to display consistent segment information
-across different stages while keeping execution logic unchanged.
-
-
-Configuration(deprecated)
-=========================
+Configuration
+=============
 
 To run the application, please create a `.env` file in the root directory of the project and add environment variables according to your requirements.
 
-If you are using this deprecated version,  you should set `BACKEND` to `rdagent.oai.backend.DeprecBackend`.
-
-   .. code-block:: Properties
-
-      BACKEND=rdagent.oai.backend.DeprecBackend
+The standard configuration options for the user using the OpenAI API are provided in the `.env.example` file.
 
 Here are some other configuration options that you can use:
 
@@ -316,23 +38,22 @@ Azure OpenAI
 The following environment variables are standard configuration options for the user using the OpenAI API.
 
    .. code-block:: Properties
-
+      
       USE_AZURE=True
 
-      EMBEDDING_OPENAI_API_KEY=<replace_with_your_azure_openai_api_key>
-      EMBEDDING_AZURE_API_BASE=  # The endpoint for the Azure OpenAI API.
-      EMBEDDING_AZURE_API_VERSION=  # The version of the Azure OpenAI API.
+      OPENAI_API_KEY=<replace_with_your_openai_api_key>
+      
       EMBEDDING_MODEL=text-embedding-3-small
+      EMBEDDING_AZURE_API_BASE= # The base URL for the Azure OpenAI API.
+      EMBEDDING_AZURE_API_VERSION = # The version of the Azure OpenAI API.
 
-      CHAT_OPENAI_API_KEY=<replace_with_your_azure_openai_api_key>
-      CHAT_AZURE_API_BASE=  # The endpoint for the Azure OpenAI API.
-      CHAT_AZURE_API_VERSION=  # The version of the Azure OpenAI API.
-      CHAT_MODEL=  # The model name of the Azure OpenAI API.
+      CHAT_MODEL=gpt-4-turbo
+      CHAT_AZURE_API_VERSION = # The version of the Azure OpenAI API.
 
 Use Azure Token Provider
 ------------------------
 
-If you are using the Azure token provider, you need to set the `CHAT_USE_AZURE_TOKEN_PROVIDER` and `EMBEDDING_USE_AZURE_TOKEN_PROVIDER` environment variable to `True`. then 
+If you are using the Azure token provider, you need to set the `USE_AZURE_TOKEN_PROVIDER` environment variable to `True`. then 
 use the environment variables provided in the `Azure Configuration section <installation_and_configuration.html#azure-openai>`_.
 
 
@@ -359,33 +80,31 @@ Configuration List
 
 - OpenAI API Setting
 
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| Configuration Option              | Meaning                                                         | Default Value           |
-+===================================+=================================================================+=========================+
-| OPENAI_API_KEY                    | API key for both chat and embedding models                      | None                    |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| EMBEDDING_OPENAI_API_KEY          | Use a different API key for embedding model                     | None                    |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| CHAT_OPENAI_API_KEY               | Set to use a different API key for chat model                   | None                    |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| EMBEDDING_MODEL                   | Name of the embedding model                                     | text-embedding-3-small  |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| CHAT_MODEL                        | Name of the chat model                                          | gpt-4-turbo             |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| EMBEDDING_AZURE_API_BASE          | Base URL for the Azure OpenAI API                               | None                    |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| EMBEDDING_AZURE_API_VERSION       | Version of the Azure OpenAI API                                 | None                    |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| CHAT_AZURE_API_BASE               | Base URL for the Azure OpenAI API                               | None                    |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| CHAT_AZURE_API_VERSION            | Version of the Azure OpenAI API                                 | None                    |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| USE_AZURE                         | True if you are using Azure OpenAI                              | False                   |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| CHAT_USE_AZURE_TOKEN_PROVIDER     | True if you are using an Azure Token Provider in chat model     | False                   |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
-| EMBEDDING_USE_AZURE_TOKEN_PROVIDER| True if you are using an Azure Token Provider in embedding model| False                   |
-+-----------------------------------+-----------------------------------------------------------------+-------------------------+
++-----------------------------+--------------------------------------------------+-------------------------+
+| Configuration Option        | Meaning                                          | Default Value           |
++=============================+==================================================+=========================+
+| OPENAI_API_KEY              | API key for both chat and embedding models       | None                    |
++-----------------------------+--------------------------------------------------+-------------------------+
+| EMBEDDING_OPENAI_API_KEY    | Use a different API key for embedding model      | None                    |
++-----------------------------+--------------------------------------------------+-------------------------+
+| CHAT_OPENAI_API_KEY         | Set to use a different API key for chat model    | None                    |
++-----------------------------+--------------------------------------------------+-------------------------+
+| EMBEDDING_MODEL             | Name of the embedding model                      | text-embedding-3-small  |
++-----------------------------+--------------------------------------------------+-------------------------+
+| CHAT_MODEL                  | Name of the chat model                           | gpt-4-turbo             |
++-----------------------------+--------------------------------------------------+-------------------------+
+| EMBEDDING_AZURE_API_BASE    | Base URL for the Azure OpenAI API                | None                    |
++-----------------------------+--------------------------------------------------+-------------------------+
+| EMBEDDING_AZURE_API_VERSION | Version of the Azure OpenAI API                  | None                    |
++-----------------------------+--------------------------------------------------+-------------------------+
+| CHAT_AZURE_API_BASE         | Base URL for the Azure OpenAI API                | None                    |
++-----------------------------+--------------------------------------------------+-------------------------+
+| CHAT_AZURE_API_VERSION      | Version of the Azure OpenAI API                  | None                    |
++-----------------------------+--------------------------------------------------+-------------------------+
+| USE_AZURE                   | True if you are using Azure OpenAI               | False                   |
++-----------------------------+--------------------------------------------------+-------------------------+
+| USE_AZURE_TOKEN_PROVIDER    | True if you are using a Azure Token Provider     | False                   |
++-----------------------------+--------------------------------------------------+-------------------------+
 
 - Globol Setting
 
@@ -419,28 +138,8 @@ Configuration List
 +------------------------------+--------------------------------------------------+-------------------------+
 | prompt_cache_path            | Path to prompt cache                             | ./prompt_cache.db       |
 +------------------------------+--------------------------------------------------+-------------------------+
+| session_cache_folder_location| Path to session cache                            | ./session_cache_folder  |
++------------------------------+--------------------------------------------------+-------------------------+
 | max_past_message_include     | Maximum number of past messages to include       | 10                      |
 +------------------------------+--------------------------------------------------+-------------------------+
 
-
-
-
-Loading Configuration
----------------------
-
-For users' convenience, we provide a CLI interface called `rdagent`, which automatically runs `load_dotenv()` to load environment variables from the `.env` file.
-However, this feature is not enabled by default for other scripts. We recommend users load the environment with the following steps:
-
-
-- ⚙️ Environment Configuration
-    - Place the `.env` file in the same directory as the `.env.example` file.
-        - The `.env.example` file contains the environment variables required for users using the OpenAI API (Please note that `.env.example` is an example file. `.env` is the one that will be finally used.)
-
-    - Export each variable in the .env file:
-
-      .. code-block:: sh
-
-          export $(grep -v '^#' .env | xargs)
-    
-    - If you want to change the default environment variables, you can refer to the above configuration and edith the `.env` file.
-

docs/introduction.rst

@@ -6,7 +6,7 @@ Introduction
 
 In modern industry, research and development (R&D) is crucial for the enhancement of industrial productivity, especially in the AI era, where the core aspects of R&D are mainly focused on data and models. We are committed to automate these high-value generic R&D processes through our open source R&D automation tool RDAgent, which let AI drive data-driven AI.
 
-.. image:: _static/scen.png
+.. image:: _static/scen.jpg
    :alt: Our focused scenario
 
 

docs/parallel_runs.md

@@ -1,238 +0,0 @@
-# Predix Parallel Run System
-
-## Overview
-
-The Parallel Run System enables concurrent execution of 5+ factor generation experiments with automatic API key distribution and complete isolation between runs.
-
-## Architecture
-
-### Components
-
-| File | Purpose |
-|------|---------|
-| `predix.py` | Extended with `--run-id` parameter for isolated single runs |
-| `predix_parallel.py` | Parallel runner manager with Rich live dashboard |
-| `factor_runner.py` | Modified to use `PARALLEL_RUN_ID` for path isolation |
-| `CoSTEER/__init__.py` | Modified to use `PARALLEL_RUN_ID` for intermediate results |
-
-### Directory Structure (Per Run)
-
-```
-results/
-├── db/                          # Shared database
-├── runs/
-│   ├── run1/                    # Run #1 isolated results
-│   │   ├── factors/             # Factor JSON files
-│   │   ├── logs/                # Run-specific logs
-│   │   ├── db/                  # Run-specific database
-│   │   └── costeer/             # CoSTEER intermediate results
-│   ├── run2/                    # Run #2 isolated results
-│   │   └── ...
-│   └── runN/                    # Run #N isolated results
-│       └── ...
-└── logs/                        # Default (non-parallel) logs
-```
-
-### Log Files
-
-```
-fin_quant.log                    # Single run (run_id=0)
-fin_quant_run1.log               # Parallel run #1
-fin_quant_run2.log               # Parallel run #2
-...
-```
-
-### Workspaces
-
-```
-RD-Agent_workspace/              # Single run (run_id=0)
-RD-Agent_workspace_run1/         # Parallel run #1
-RD-Agent_workspace_run2/         # Parallel run #2
-...
-```
-
-## Usage
-
-### CLI - Single Parallel Run
-
-```bash
-# Run with isolated results
-predix quant --run-id 1 -m openrouter
-```
-
-### CLI - Parallel Runner (Direct)
-
-```bash
-# Run 5 experiments with 2 API keys
-python predix_parallel.py --runs 5 --api-keys 2
-
-# Run 3 experiments with local model
-python predix_parallel.py --runs 3 --model local
-
-# Custom configuration
-python predix_parallel.py -n 10 -k 2 -m openrouter
-```
-
-### Programmatic Usage
-
-```python
-from predix_parallel import main
-
-result = main(runs=5, api_keys=2, model="openrouter")
-print(f"Success: {result['success']}/{result['total']}")
-```
-
-## API Key Distribution
-
-The system distributes API keys using round-robin assignment:
-
-| Run ID | API Key | Model |
-|--------|---------|-------|
-| 1 | Key 1 | openrouter |
-| 2 | Key 2 | openrouter |
-| 3 | Key 1 | openrouter |
-| 4 | Key 2 | openrouter |
-| 5 | Key 1 | openrouter |
-
-**With 2 API keys:**
-- Runs 1, 3, 5 → Key 1
-- Runs 2, 4 → Key 2
-
-**LiteLLM Load Balancing:**
-When 2 API keys are available, the system configures LiteLLM for parallel request handling:
-```
-OPENAI_API_KEY=key1,key2
-LITELLM_PARALLEL_CALLS=2
-```
-
-## Isolation Guarantees
-
-Each parallel run is completely isolated:
-
-### Environment Variables
-- `PARALLEL_RUN_ID=N` - Identifies the run
-- `RD_AGENT_WORKSPACE` - Points to run-specific workspace
-- `OPENAI_API_KEY` - Assigned API key for this run
-
-### No Shared State
-- ✅ Separate log files
-- ✅ Separate result directories
-- ✅ Separate workspace directories
-- ✅ Separate database files (optional)
-- ✅ No race conditions (no shared mutable state)
-
-### Graceful Degradation
-- If a run fails, others continue unaffected
-- Each run is independently restartable
-- Results are persisted immediately after completion
-
-## Live Dashboard
-
-The parallel runner shows a Rich-based live dashboard:
-
-```
-┌─────────────────────────────────────────────────────────┐
-│  🔀 Predix Parallel Run Dashboard                       │
-├──────┬──────────┬──────────┬─────────┬──────────┬───────┤
-│ Run  │ Status   │ Elapsed  │ API Key │ Model    │ Exit  │
-├──────┼──────────┼──────────┼─────────┼──────────┼───────┤
-│ #1   │ ✅ success│ 02:15:30│ 1       │openrouter│ 0     │
-│ #2   │ 🔄 running│ 01:45:12│ 2       │openrouter│ --    │
-│ #3   │ 🔄 running│ 01:42:08│ 1       │openrouter│ --    │
-│ #4   │ ⏳ pending│ --:--:--│ 2       │openrouter│ --    │
-│ #5   │ ❌ failed │ 00:05:23│ 1       │openrouter│ 1     │
-├──────┴──────────┴──────────┴─────────┴──────────┴───────┤
-│  Summary: 5 total | 1 done | 2 running | 1 pending | 1 failed │
-└─────────────────────────────────────────────────────────┘
-```
-
-## Signal Handling
-
-- **First Ctrl+C:** Gracefully stops all running subprocesses
-- **Second Ctrl+C:** Force kills all remaining processes
-- Dashboard updates in real-time during shutdown
-
-## Configuration
-
-### Environment Variables (`.env`)
-
-```bash
-# Required for openrouter mode
-OPENROUTER_API_KEY=sk-or-your-first-key
-OPENROUTER_API_KEY_2=sk-or-your-second-key  # Optional
-
-# Required for local mode
-OPENAI_API_KEY=local
-OPENAI_API_BASE=http://localhost:8081/v1
-CHAT_MODEL=qwen3.5-35b
-
-# Optional: Custom model
-OPENROUTER_MODEL=openrouter/qwen/qwen3.6-plus:free
-```
-
-## Performance
-
-**Expected Speedup:**
-- 5 runs with 2 API keys ≈ 2.5× faster than sequential
-- 5 runs with local model ≈ 5× faster than sequential (no API rate limits)
-
-**Overhead:**
-- ~1 second per run for subprocess startup
-- Dashboard refresh: 2 Hz (negligible CPU)
-
-## Error Handling
-
-| Scenario | Behavior |
-|----------|----------|
-| Run fails | Logged, others continue |
-| API key exhausted | Retry with next key |
-| Ctrl+C pressed | Graceful shutdown of all runs |
-| Disk full | Error logged, run marked failed |
-| LLM timeout | Run fails, others unaffected |
-
-## Integration with Existing Code
-
-### factor_runner.py Changes
-
-```python
-# Before (shared paths)
-log_dir = project_root / "results" / "logs"
-factors_dir = project_root / "results" / "factors"
-
-# After (parallel-aware)
-parallel_run_id = os.getenv("PARALLEL_RUN_ID", "0")
-if parallel_run_id != "0":
-    log_dir = project_root / "results" / "runs" / f"run{parallel_run_id}" / "logs"
-    factors_dir = project_root / "results" / "runs" / f"run{parallel_run_id}" / "factors"
-```
-
-### CoSTEER/__init__.py Changes
-
-```python
-# Intermediate results isolation
-parallel_run_id = os.getenv("PARALLEL_RUN_ID", "0")
-if parallel_run_id != "0":
-    results_dir = project_root / "results" / "runs" / f"run{parallel_run_id}" / "costeer"
-```
-
-## Testing
-
-```bash
-# Run all integration tests
-pytest test/integration/test_all_features.py -v
-
-# Test parallel runner imports
-python -c "from predix_parallel import ParallelRunner, main; print('✅ OK')"
-
-# Test CLI options
-predix quant --help  # Should show --run-id option
-```
-
-## Future Enhancements
-
-- [ ] Auto-detect optimal number of parallel runs based on API rate limits
-- [ ] Result aggregation and comparison across runs
-- [ ] Dynamic API key rebalancing (assign more runs to faster key)
-- [ ] Support for >2 API keys
-- [ ] Run prioritization (run high-priority experiments first)
-- [ ] Slack/email notifications on completion

docs/project_framework_introduction.rst

@@ -7,7 +7,7 @@ Framework & Components
 
 .. NOTE: This depends on the correctness of `c-v` of github.
 
-.. image:: _static/Framework-RDAgent.png
+.. image:: https://github.com/user-attachments/assets/98fce923-77ab-4982-93c8-a7a01aece766
     :alt: Components & Feature Level
 
 The image above shows the overall framework of RDAgent.
@@ -23,5 +23,19 @@ We have established a basic method framework that continuously proposes hypothes
 The figure above shows the main classes and how they fit into the workflow for those interested in the detailed code.
 
 
-.. Detailed Design
-.. ===============
+Detailed Design
+=========================
+
+
+Configuration
+-------------
+
+You can manually source the `.env` file in your shell before running the Python script:
+Most of the workflow are controlled by the environment variables.
+```sh
+# Export each variable in the .env file; Please note that it is different from `source .env` without export
+export $(grep -v '^#' .env | xargs)
+# Run the Python script
+python your_script.py
+```
+

docs/research/benchmark.rst

@@ -5,12 +5,21 @@ Benchmark
 Introduction
 =============
 
-Benchmarking the capabilities of R&D is a crucial research problem in this area. We are continuously exploring methods to benchmark these capabilities. The current benchmarks are listed on this page.
+
+Benchmarking the capabilities of the R&D is a very important research problem of the research area.
+
+Currently we are continuously exploring how to benchmark them.
+
+The current benchmarks are listed in this page
+
 
 Development Capability Benchmarking
 ===================================
 
-Benchmarking is used to evaluate the effectiveness of factors with fixed data. It mainly includes the following steps:
+
+Benchmark is used to evaluate the effectiveness of factors with fixed data.
+
+It mainly includes the following steps:
 
 1. :ref:`read and prepare the eval_data <data>`
 
@@ -18,31 +27,34 @@ Benchmarking is used to evaluate the effectiveness of factors with fixed data. I
 
 3. :ref:`declare the eval method and pass the arguments <config>`
 
-4. :ref:`run the eval <run>`
+4. :ref:`run the eval <run>` 
 
-5. :ref:`save and show the result <show>`
+5. :ref:`save and show the result <show>` 
 
-Configuration
+Configuration 
 -------------
 .. _config:
 
 .. autopydantic_settings:: rdagent.components.benchmark.conf.BenchmarkSettings
 
 Example
-+++++++
+++++++++
 .. _example:
 
-The default value for ``bench_test_round`` is 10, which takes about 2 hours to run. To modify it from ``10`` to ``2``, adjust the environment variables in the .env file as shown below.
+The default value for ``bench_test_round`` is 10, and it will take about 2 hours to run 10 rounds.
+To modify it from ``10`` to ``2`` you can adjust this by adding environment variables in the .env file as shown below.
 
 .. code-block:: Properties
 
-      BENCHMARK_BENCH_TEST_ROUND=2
+      BENCHMARK_BENCH_TEST_ROUND=1
 
 Data Format
 -------------
 .. _data:
 
-The sample data in ``bench_data_path`` is a dictionary where each key represents a factor name. The value associated with each key is factor data containing the following information:
+The sample data in ``bench_data_path`` is a dictionary where each key represents a factor name. 
+
+The value associated with each key is factor data containing the following information:
 
 - **description**: A textual description of the factor.
 - **formulation**: A LaTeX formula representing the model's formulation.
@@ -51,24 +63,22 @@ The sample data in ``bench_data_path`` is a dictionary where each key represents
 - **Difficulty**: The difficulty level of implementing or understanding the factor.
 - **gt_code**: A piece of code associated with the factor.
 
-Here is an example of this data format:
+Here is the example of this data format:
 
 .. literalinclude:: ../../rdagent/components/benchmark/example.json
    :language: json
 
-Ensure the data is placed in the ``FACTOR_COSTEER_SETTINGS.data_folder_debug``. The data files should be in ``.h5`` or ``.md`` format and must not be stored in any subfolders. LLM-Agents will review the file content and implement the tasks.
-
-.. TODO: Add a script to automatically generate the data in the `rdagent/app/quant_factor_benchmark/data` folder.
-
 Run Benchmark
 -------------
 .. _run:
 
-Start the benchmark after completing the :doc:`../installation_and_configuration`.
+Start benchmark after finishing the :doc:`../installation_and_configuration`.
 
 .. code-block:: Properties
 
-      dotenv run -- python rdagent/app/benchmark/factor/eval.py
+      python rdagent/app/quant_factor_benchmark/eval.py
+
+
 
 Once completed, a pkl file will be generated, and its path will be printed on the last line of the console.
 
@@ -76,16 +86,18 @@ Show Result
 -------------
 .. _show:
 
-The ``analysis.py`` script reads data from the pkl file and converts it to an image. Modify the Python code in ``rdagent/app/quant_factor_benchmark/analysis.py`` to specify the path to the pkl file and the output path for the png file.
+The ``analysis.py`` script is used to read data from pkl and convert it to an image.
+Modify the python code in ``rdagent/app/quant_factor_benchmark/analysis.py`` to specify the path to the pkl file and the output path for the png file.
 
 .. code-block:: Properties
 
-      dotenv run -- python rdagent/app/benchmark/factor/analysis.py <log/path to.pkl>
+      python rdagent/app/quant_factor_benchmark/analysis.py
 
 A png file will be saved to the designated path as shown below.
 
 .. image:: ../_static/benchmark.png
 
+
 Related Paper
 -------------
 
@@ -104,6 +116,3 @@ Related Paper
     }
 
 .. image:: https://github.com/user-attachments/assets/494f55d3-de9e-4e73-ba3d-a787e8f9e841
-
-To replicate the benchmark detailed in the paper, please consult the factors listed in the following file: `RD2bench.json <../_static/RD2bench.json>`_.
-Please note use ``only_correct_format=False`` when evaluating the results.

docs/scens/catalog.rst

@@ -13,34 +13,34 @@ In the two key areas of data-driven scenarios, model implementation and data bui
 The supported scenarios are listed below:
 
 
-.. list-table::
+
+.. list-table:: 
     :header-rows: 1
 
     * - Scenario/Target
       - Model Implementation
       - Data Building
     * - 💹 Finance
-      - :ref:`🥇The First Data-Centric Quant Multi-Agent Framework <quant_agent_fin>`
-      - :ref:`🤖Iteratively Proposing Ideas & Evolving <model_agent_fin>`  
-        
-        :ref:`🦾Auto reports reading & implementation <data_copilot_fin>`  
-        
+      - :ref:`🤖Iteratively Proposing Ideas & Evolving <model_agent_fin>`
+      - :ref:`🦾Auto reports reading & implementation <data_copilot_fin>`
+
         :ref:`🤖Iteratively Proposing Ideas & Evolving <data_agent_fin>`
+    * - 🩺 Medical
+      - :ref:`🤖Iteratively Proposing Ideas & Evolving <model_agent_med>`
+      - 
     * - 🏭 General
-      - :ref:`🦾Auto paper reading & implementation <model_copilot_general>`  
-        
-      - :ref:`🤖 Data Science <data_science_agent>`
+      - :ref:`🦾Auto paper reading & implementation <model_copilot_general>`
+      - 
 
 
 .. toctree::
-    :maxdepth: 1
-    :caption: Doctree:
-    :hidden:
+   :maxdepth: 1
+   :caption: Doctree:
+   :hidden:
+
+   data_agent_fin
+   data_copilot_fin
+   model_agent_fin
+   model_agent_med
+   model_copilot_general
 
-    quant_agent_fin
-    data_agent_fin
-    data_copilot_fin
-    model_agent_fin
-    model_copilot_general
-    data_science
-    finetune

docs/scens/data_agent_fin.rst

@@ -10,24 +10,17 @@ Finance Data Agent
 
 📖 Background
 ~~~~~~~~~~~~~~
-In the dynamic world of quantitative trading, **factors** serve as the strategic tools that enable traders to exploit market inefficiencies. 
-These factors—ranging from simple metrics like price-to-earnings ratios to complex models like discounted cash flows—are the key to predicting stock prices with a high degree of accuracy.
+In the dynamic world of quantitative trading, **factors** are the secret weapons that traders use to harness market inefficiencies. 
 
-By leveraging these factors, quantitative traders can develop sophisticated strategies that not only identify market patterns but also significantly enhance trading efficiency and precision. 
-The ability to systematically analyze and apply these factors is what separates ordinary trading from truly strategic market outmaneuvering.
-And this is where the **Finance Model Agent** comes into play.
+These powerful tools—ranging from straightforward metrics like price-to-earnings ratios to intricate discounted cash flow models—unlock the potential to predict stock prices with remarkable precision. 
+By tapping into this rich vein of data, quantitative traders craft sophisticated strategies that not only capitalize on market patterns but also drastically enhance trading efficiency and accuracy. 
 
-🎥 `Demo <https://rdagent.azurewebsites.net/factor_loop>`_
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Embrace the power of factors, and you're not just trading; you're strategically outsmarting the market.
 
-.. raw:: html
 
-    <div style="display: flex; justify-content: center; align-items: center;">
-      <video width="600" controls>
-        <source src="https://rdagent.azurewebsites.net/media/65bb598f1372c1857ccbf09b2acf5d55830911625048c03102291098.mp4" type="video/mp4">
-        Your browser does not support the video tag.
-      </video>
-    </div>
+🎥 Demo
+~~~~~~~~~~
+TODO: Here should put a video of the demo.
 
 
 🌟 Introduction
@@ -83,39 +76,52 @@ Here's an enhanced outline of the steps:
 ⚡ Quick Start
 ~~~~~~~~~~~~~~~~~
 
-Please refer to the installation part in :doc:`../installation_and_configuration` to prepare your system dependency.
-
 You can try our demo by running the following command:
 
 - 🐍 Create a Conda Environment
-
-  - Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
-
-    .. code-block:: sh
-
+    - Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
+    
+      .. code-block:: sh
+      
           conda create -n rdagent python=3.10
 
-  - Activate the environment:
+    - Activate the environment:
 
-    .. code-block:: sh
+      .. code-block:: sh
 
-        conda activate rdagent
+          conda activate rdagent
 
-- 📦 Install the RDAgent
-  
-  - You can install the RDAgent package from PyPI:
+- 🛠️ Run Make Files
+    - Navigate to the directory containing the MakeFile and set up the development environment:
 
-    .. code-block:: sh
+      .. code-block:: sh
 
-        pip install rdagent
+          make dev
+
+- 📦 Install Pytorch
+    - Install Pytorch and related libraries:
+
+      .. code-block:: sh
+
+          pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
+          pip3 install torch_geometric
+
+- ⚙️ Environment Configuration
+    - Place the `.env` file in the same directory as the `.env.example` file.
+        - The `.env.example` file contains the environment variables required for users using the OpenAI API (Please note that `.env.example` is an example file. `.env` is the one that will be finally used.)
+
+    - Export each variable in the .env file:
+
+      .. code-block:: sh
+
+          export $(grep -v '^#' .env | xargs)
+    
+    - If you want to change the default environment variables, you can refer to `Env Config`_ below
 
 - 🚀 Run the Application
-    
-  - You can directly run the application by using the following command:
-    
     .. code-block:: sh
 
-        rdagent fin_factor
+        python rdagent/app/qlib_rd_loop/factor_w_sc.py
 
 
 🛠️ Usage of modules
@@ -126,13 +132,33 @@ You can try our demo by running the following command:
 - **Env Config**
 
 The following environment variables can be set in the `.env` file to customize the application's behavior:
+    - **Path to the folder containing private data (default fundamental data in Qlib):**
 
-.. autopydantic_settings:: rdagent.app.qlib_rd_loop.conf.FactorBasePropSetting
-    :settings-show-field-summary: False
-    :exclude-members: Config
+        .. code-block:: sh
+
+          FACTOR_CODER_DATA_FOLDER=/path/to/data/factor_implementation_source_data_all
+
+    - **Path to the folder containing partial private data (for debugging):**
+
+      .. code-block:: sh
+
+          FACTOR_CODER_DATA_FOLDER_DEBUG=/path/to/data/factor_implementation_source_data_debug
+
+    - **Maximum time (in seconds) for writing factor code:**
+
+      .. code-block:: sh
+
+          FACTOR_CODER_FILE_BASED_EXECUTION_TIMEOUT=300
+
+    - **Maximum number of factors to write in one experiment:**
+
+      .. code-block:: sh
+
+          FACTOR_CODER_SELECT_THRESHOLD=5
+
+    - **Number of developing loops for writing factors:**
+
+      .. code-block:: sh
+
+          FACTOR_CODER_MAX_LOOP=10
 
-.. autopydantic_settings:: rdagent.components.coder.factor_coder.config.FactorCoSTEERSettings
-    :settings-show-field-summary: False
-    :members: coder_use_cache, data_folder, data_folder_debug, file_based_execution_timeout, select_method, max_loop, knowledge_base_path, new_knowledge_base_path
-    :exclude-members: Config, fail_task_trial_limit, v1_query_former_trace_limit, v1_query_similar_success_limit, v2_query_component_limit, v2_query_error_limit, v2_query_former_trace_limit, v2_error_summary, v2_knowledge_sampler
-    :no-index:

docs/scens/data_copilot_fin.rst

@@ -17,20 +17,12 @@ Furthermore, rather than hastily replicating factors from a report, it's essenti
 Does the factor capture the essential market dynamics? How unique is it compared to the factors already in your library?
 
 Therefore, there is an urgent need for a systematic approach to design a framework that can effectively manage this process. 
-And this is where the **Finance Data Copilot** steps in.
+This is where our RDAgent comes into play.
 
 
-🎥 `Demo <https://rdagent.azurewebsites.net/report_factor>`_
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. raw:: html
-
-    <div style="display: flex; justify-content: center; align-items: center;">
-      <video width="600" controls>
-        <source src="https://rdagent.azurewebsites.net/media/7b14b2bd3d8771da9cf7eb799b6d96729cec3d35c8d4f68060f3e2fd.mp4" type="video/mp4">
-        Your browser does not support the video tag.
-      </video>
-    </div>
+🎥 Demo
+~~~~~~~~~~
+TODO: Here should put a video of the demo.
 
 
 🌟 Introduction
@@ -84,64 +76,54 @@ Here's an enhanced outline of the steps:
 ⚡ Quick Start
 ~~~~~~~~~~~~~~~~~
 
-Please refer to the installation part in :doc:`../installation_and_configuration` to prepare your system dependency.
-
 You can try our demo by running the following command:
 
 - 🐍 Create a Conda Environment
+    - Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
     
-  - Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
+      .. code-block:: sh
+      
+          conda create -n rdagent python=3.10
+
+    - Activate the environment:
+
+      .. code-block:: sh
+
+          conda activate rdagent
+
+- 🛠️ Run Make Files
+    - Navigate to the directory containing the MakeFile and set up the development environment:
+
+      .. code-block:: sh
+
+          make dev
+
+- 📦 Install Pytorch
+    - Install Pytorch and related libraries:
+
+      .. code-block:: sh
+
+          pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
+          pip3 install torch_geometric
+
+- ⚙️ Environment Configuration
+    - Place the `.env` file in the same directory as the `.env.example` file.
+        - The `.env.example` file contains the environment variables required for users using the OpenAI API (Please note that `.env.example` is an example file. `.env` is the one that will be finally used.)
+
+    - Export each variable in the .env file:
+
+      .. code-block:: sh
+
+          export $(grep -v '^#' .env | xargs)
     
-    .. code-block:: sh
-    
-        conda create -n rdagent python=3.10
-
-  - Activate the environment:
-
-    .. code-block:: sh
-
-        conda activate rdagent
-
-- 📦 Install the RDAgent
-  
-  - You can install the RDAgent package from PyPI:
-
-    .. code-block:: sh
-
-        pip install rdagent
+    - If you want to change the default environment variables, you can refer to `Env Config`_ below
 
 - 🚀 Run the Application
-    
-  - Download the financial reports you wish to extract factors from and store them in your preferred folder.
-
-  - Specifically, you can follow this example, or use your own method:
-
     .. code-block:: sh
 
-        wget https://github.com/SunsetWolf/rdagent_resource/releases/download/reports/all_reports.zip
-        unzip all_reports.zip -d git_ignore_folder/reports
+        python rdagent/app/qlib_rd_loop/factor_from_report_w_sc.py
 
-  - Run the application with the following command:
 
-    .. code-block:: sh
-
-        rdagent fin_factor_report --report-folder=git_ignore_folder/reports
-
-  - Alternatively, you can store the paths of the reports in `report_result_json_file_path`. The format should be:
-
-    .. code-block:: json
-
-        [
-            "git_ignore_folder/report/fin_report1.pdf",
-            "git_ignore_folder/report/fin_report2.pdf",
-            "git_ignore_folder/report/fin_report3.pdf"
-        ]
-
-  - Then, run the application using the following command:
-
-    .. code-block:: sh
-
-        rdagent fin_factor_report
 
 🛠️ Usage of modules
 ~~~~~~~~~~~~~~~~~~~~~
@@ -151,14 +133,32 @@ You can try our demo by running the following command:
 - **Env Config**
 
 The following environment variables can be set in the `.env` file to customize the application's behavior:
+    - **Path to the folder containing research reports:**
 
-.. autopydantic_settings:: rdagent.app.qlib_rd_loop.conf.FactorFromReportPropSetting
-    :settings-show-field-summary: False
-    :show-inheritance:
-    :exclude-members: Config
+      .. code-block:: sh
 
-.. autopydantic_settings:: rdagent.components.coder.factor_coder.config.FactorCoSTEERSettings
-    :settings-show-field-summary: False
-    :members: coder_use_cache, data_folder, data_folder_debug, file_based_execution_timeout, select_method, max_loop, knowledge_base_path, new_knowledge_base_path
-    :exclude-members: Config, python_bin, fail_task_trial_limit, v1_query_former_trace_limit, v1_query_similar_success_limit, v2_query_component_limit, v2_query_error_limit, v2_query_former_trace_limit, v2_error_summary, v2_knowledge_sampler
-    :no-index:
+          QLIB_FACTOR_LOCAL_REPORT_PATH=/path/to/research/reports
+
+    - **Path to the JSON file listing research reports for factor extraction:**
+
+      .. code-block:: sh
+
+          QLIB_FACTOR_REPORT_RESULT_JSON_FILE_PATH=/path/to/reports/list.json
+
+    - **Maximum time (in seconds) for writing factor code:**
+
+      .. code-block:: sh
+
+          FACTOR_CODER_FILE_BASED_EXECUTION_TIMEOUT=300
+
+    - **Maximum number of factors to write in one experiment:**
+
+      .. code-block:: sh
+
+          FACTOR_CODER_SELECT_THRESHOLD=5
+
+    - **Number of developing loops for writing factors:**
+
+      .. code-block:: sh
+
+          FACTOR_CODER_MAX_LOOP=10

docs/scens/data_science.rst

@@ -1,566 +0,0 @@
-.. _data_science_agent:
-
-=======================
-Data Science Agent
-=======================
-
-**🤖 Automated Feature Engineering & Model Tuning Evolution**
-------------------------------------------------------------------------------------------
-The Data Science Agent is an agent that can automatically perform feature engineering and model tuning. It can be used to solve various data science problems, such as image classification, time series forecasting, and text classification.
-
-🌟 Introduction
-~~~~~~~~~~~~~~~~~~
-
-In this scenario, our automated system proposes hypothesis, choose action, implements code, conducts validation, and utilizes feedback in a continuous, iterative process.
-
-The goal is to automatically optimize performance metrics within the validation set or Kaggle Leaderboard, ultimately discovering the most efficient features and models through autonomous research and development.
-
-Here's an enhanced outline of the steps:
-
-**Step 1 : Hypothesis Generation 🔍**
-
-- Generate and propose initial hypotheses based on previous experiment analysis and domain expertise, with thorough reasoning and financial justification.
-
-**Step 2 : Experiment Creation ✨**
-
-- Transform the hypothesis into a task.
-- Choose a specific action within feature engineering or model tuning.
-- Develop, define, and implement a new feature or model, including its name, description, and formulation.
-
-**Step 3 : Model/Feature Implementation 👨‍💻**
-
-- Implement the model code based on the detailed description.
-- Evolve the model iteratively as a developer would, ensuring accuracy and efficiency.
-
-**Step 4 : Validation on Test Set or Kaggle 📉**
-
-- Validate the newly developed model using the test set or Kaggle dataset.
-- Assess the model's effectiveness and performance based on the validation results.
-
-**Step 5: Feedback Analysis 🔍**
-
-- Analyze validation results to assess performance.
-- Use insights to refine hypotheses and enhance the model.
-
-**Step 6: Hypothesis Refinement ♻️**
-
-- Adjust hypotheses based on validation feedback.
-- Iterate the process to continuously improve the model.
-
-📖 Data Science Background
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-In the evolving landscape of artificial intelligence, **Data Science** represents a powerful paradigm where machines engage in autonomous exploration, hypothesis testing, and model development across diverse domains — from healthcare and finance to logistics and research.
-
-The **Data Science** Agent stands as a central engine in this transformation, enabling users to automate the entire machine learning workflow: from hypothesis generation to code implementation, validation, and refinement — all guided by performance feedback.
-
-By leveraging the **Data Science** Agent, researchers and developers can accelerate experimentation cycles. Whether fine-tuning custom models or competing in high-stakes benchmarks like Kaggle, the Data Science Agent unlocks new frontiers in intelligent, self-directed discovery.
-
-🧭 Example Guide - Customized dataset
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-🔧 **Set up RD-Agent Environment**
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-- Before you start, please make sure you have installed RD-Agent and configured the environment for RD-Agent correctly. If you want to know how to install and configure the RD-Agent, please refer to the `documentation <../installation_and_configuration.html>`_.
-
-- 🔩 **Setting the Environment variables at .env file**
-
-  - Determine the path where the data will be stored and add it to the ``.env`` file.
-
-  .. code-block:: sh
-
-    dotenv set DS_LOCAL_DATA_PATH <your local directory>/ds_data
-    dotenv set DS_SCEN rdagent.scenarios.data_science.scen.DataScienceScen
-
-📥 **Prepare Customized datasets**
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-  - A data science competition dataset usually consists of two parts: ``competition dataset`` and ``evaluation dataset``. (We provide `a sample <https://github.com/microsoft/RD-Agent/tree/main/rdagent/scenarios/data_science/example>`_ of a customized dataset named: `arf-12-hours-prediction-task as a reference`.)
-    
-    - The ``competition dataset`` contains **training data**, **test data**, **description files**, **formatted submission files**, **data sampling codes**.
-    
-    - The ``evaluation dataset`` contains **standard answer file**, **data checking codes**, and **Code for calculation of scores**.
-
-  - We use the ``arf-12-hours-prediction-task`` data as a sample to introduce the preparation workflow for the competition dataset.
-  
-    - Create a ``ds_data/source_data/arf-12-hours-prediction-task`` folder, which will be used to store your raw dataset.
-
-      - The raw files for the competition ``arf-12-hours-prediction-task`` have two files: ``ARF_12h.csv`` and ``X.npz``.
-    
-    - Create a ``ds_data/source_data/arf-12-hours-prediction-task/prepare.py`` file that splits your raw data into **training data**, **test data**, **formatted submission file**, and **standard answer file**. (You will need to write a script based on your raw data.)
-      
-      - The following shows the preprocessing code for the raw data of ``arf-12-hours-prediction-task``.
-
-      .. literalinclude:: ../../rdagent/scenarios/data_science/example/source_data/arf-12-hours-prediction-task/prepare.py
-        :language: python
-        :caption: ds_data/source_data/arf-12-hours-prediction-task/prepare.py
-        :linenos:
-
-      - At the end of program execution, the ``ds_data`` folder structure will look like this:
-
-      .. code-block:: text
-
-        ds_data
-        ├── arf-12-hours-prediction-task
-        │   ├── train
-        │   │   ├── ARF_12h.csv
-        │   │   └── X.npz
-        │   ├── test
-        │   │   ├── ARF_12h.csv
-        │   │   └── X.npz
-        │   └── sample_submission.csv
-        ├── eval
-        │   └── arf-12-hours-prediction-task
-        │       └── submission_test.csv
-        └── source_data
-            └── arf-12-hours-prediction-task
-                ├── ARF_12h.csv
-                ├── prepare.py
-                └── X.npz
-
-    - Create a ``ds_data/arf-12-hours-prediction-task/description.md`` file to describe your competition, Objective, dataset, and other information.
-
-      - The following shows the description file for ``arf-12-hours-prediction-task``
-
-      .. literalinclude:: ../../rdagent/scenarios/data_science/example/arf-12-hours-prediction-task/description.md
-        :language: markdown
-        :caption: ds_data/arf-12-hours-prediction-task/description.md
-        :linenos:
-
-    - Create a ``ds_data/arf-12-hours-prediction-task/sample.py`` file to construct the debugging sample data.
-
-      - The following shows the script for constructing the debugging sample data based on the ``arf-12-hours-prediction-task`` dataset implementation.
-
-      .. literalinclude:: ../../rdagent/scenarios/data_science/example/arf-12-hours-prediction-task/sample.py
-        :language: markdown
-        :caption: ds_data/arf-12-hours-prediction-task/sample.py
-        :linenos:
-
-    - Create a ``ds_data/eval/arf-12-hours-prediction-task/valid.py`` file, which is used to check the validity of the submission files to ensure that their formatting is consistent with the reference file.
-
-      - The following shows a script that checks the validity of a submission based on the ``arf-12-hours-prediction-task`` data.
-
-      .. literalinclude:: ../../rdagent/scenarios/data_science/example/eval/arf-12-hours-prediction-task/valid.py
-        :language: markdown
-        :caption: ds_data/eval/arf-12-hours-prediction-task/valid.py
-        :linenos:
-
-    - Create a ``ds_data/eval/arf-12-hours-prediction-task/grade.py`` file, which is used to calculate the score based on the submission file and the **standard answer file**, and output the result in JSON format.
-
-      - The following shows a grading script based on the ``arf-12-hours-prediction-task`` data implementation.
-
-      .. literalinclude:: ../../rdagent/scenarios/data_science/example/eval/arf-12-hours-prediction-task/grade.py
-        :language: markdown
-        :caption: ds_data/eval/arf-12-hours-prediction-task/grade.py
-        :linenos:
-
-  - At this point, you have created a complete dataset. The correct structure of the dataset should look like this.
-
-    .. code-block:: text
-
-        ds_data
-        ├── arf-12-hours-prediction-task
-        │   ├── train
-        │   │   ├── ARF_12h.csv
-        │   │   └── X.npz
-        │   ├── test
-        │   │   ├── ARF_12h.csv
-        │   │   └── X.npz
-        │   ├── description.md
-        │   ├── sample_submission.csv
-        │   └── sample.py
-        ├── eval
-        │   └── arf-12-hours-prediction-task
-        │       ├── grade.py
-        │       ├── submission_test.csv
-        │       └── valid.py
-        └── source_data
-            └── arf-12-hours-prediction-task
-                ├── ARF_12h.csv
-                ├── prepare.py
-                └── X.npz
-
-  - The above shows the complete dataset creation workflow, some of the files are not required, in practice you can customize the dataset according to your own needs.
-
-    - If we don't need the test set scores, then we can choose not to generate **formatted submission files** and **standard answer file** in the prepare code, and we don't need to write **data checking codes** and **Code for calculation of scores**.
-
-    - **Data sampling code** can also be created according to the actual need, if you do not provide **data sampling code**, RD-Agent will be handed over to the LLM sampling at runtime.
-
-      - In the default sampling method (``create_debug_data``), the default sampling ratio (parameter: ``min_frac``) is 1%, if 1% of the data is less than 5, then 5 data will be sampled (parameter: ``min_num``), you can adjust the sampling ratio by adjusting these two parameters.
-
-        - If you have customized data sampling code, you need to set ``DS_SAMPLE_DATA_BY_LLM`` to ``False`` (default is True) in the ``.env`` file before running, so that the program will use the customized sampling code when running, and you can just execute this line of code in the command line:
-
-          .. code-block:: sh
-
-            dotenv set DS_SAMPLE_DATA_BY_LLM False
-
-        - In addition, we provide a data sampling method in `rdagent.scenarios.data_science.debug.data.create_debug_data <https://github.com/microsoft/RD-Agent/blob/main/rdagent/scenarios/data_science/debug/data.py#L605>`_, in this method, the default sampling ratio (parameter: ``min_frac``) is 1%, if 1% of the data is less than 5, then 5 data will be sampled (parameter: ``min_num``), you can use this method by the following two ways.
-
-          - You can set ``DS_SAMPLE_DATA_BY_LLM`` to ``False`` in the ``.env`` file so that when the program runs, it will use the sampling code provided by RD-Agent.
-
-            .. code-block:: sh
-
-              dotenv set DS_SAMPLE_DATA_BY_LLM False
-
-          - If you think that the parameters in the receipt sampling method provided by RD-Agent are not suitable, you can customize the parameters in the following command and run it, and set ``DS_SAMPLE_DATA_BY_LLM`` to ``False`` in the ``.env`` so that the program will use the sampling data you provided when running.
-
-            .. code-block:: sh
-
-              python rdagent/app/data_science/debug.py --dataset_path <dataset path> --competition <competiton_name> --min_frac <sampling ratio> --min_num <minimum number of sampling>
-              dotenv set DS_SAMPLE_DATA_BY_LLM False
-
-  - If you don't need the scores from the test set and leave the data sampling to the LLM, or if you use the sampling method provided by the RD-Agent, you only need to prepare a minimal dataset. The structure of the simplest dataset should be as shown below.
-
-    .. code-block:: text
-
-        ds_data
-        ├── arf-12-hours-prediction-task
-        │   ├── train
-        │   │   ├── ARF_12h.csv
-        │   │   └── X.npz
-        │   ├── test
-        │   │   ├── ARF_12h.csv
-        │   │   └── X.npz
-        │   └── description.md
-        └── source_data
-            └── arf-12-hours-prediction-task
-                ├── ARF_12h.csv
-                ├── prepare.py
-                └── X.npz
-
-  - We have prepared a dataset based on the above description for your reference. You can download it with the following command.
-
-    .. code-block:: sh
-
-      wget https://github.com/SunsetWolf/rdagent_resource/releases/download/ds_data/arf-12-hours-prediction-task.zip
-
-⚙️ **Set up Environment for Customized datasets**
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-  .. code-block:: sh
-
-      dotenv set DS_SCEN rdagent.scenarios.data_science.scen.DataScienceScen
-      dotenv set DS_LOCAL_DATA_PATH <your local directory>/ds_data
-      dotenv set DS_CODER_ON_WHOLE_PIPELINE True
-
-  - 📘 More Environment Variables (Optional)
-
-    - If you want to see all the available environment variables, you can refer to the configuration file for Data Science scenarios:
-
-    .. literalinclude:: ../../rdagent/app/data_science/conf.py
-      :language: python
-      :linenos:
-
-    - These variables allow you to have finer-grained control in Data Science scenarios.
-
-🚀 **Run the Application**
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-  - 🌏 You can directly run the application by using the following command:
-    
-    .. code-block:: sh
-
-        rdagent data_science --competition <Competition ID>
-
-    - The following shows the command to run based on the ``arf-12-hours-prediction-task`` data
-
-      .. code-block:: sh
-
-          rdagent data_science --competition arf-12-hours-prediction-task
-
-    -  More CLI Parameters for `rdagent data_science` command:
-
-      .. automodule:: rdagent.app.data_science.loop
-        :members:
-        :no-index:
-
-  - 📈 Visualize the R&D Process
-
-    - We provide a web UI to visualize the log. You just need to run:
-
-      .. code-block:: sh
-
-          rdagent ui --port <custom port> --log-dir <your log folder like "log/"> --data_science True
-
-    - Then you can input the log path and visualize the R&D process.
-
-  - 🧪 Scoring the test results
-
-    - Finally, shutdown the program, and get the test set scores with this command.
-
-    .. code-block:: sh
-
-      dotenv run -- python rdagent/log/mle_summary.py grade <url_to_log>
-
-    Here, <url_to_log> refers to the parent directory of the log folder generated during the run.
-
-🕹️ Kaggle Agent
-~~~~~~~~~~~~~~~~
-
-📖 Background
-^^^^^^^^^^^^^^
-
-In the landscape of data science competitions, Kaggle serves as the ultimate arena where data enthusiasts harness the power of algorithms to tackle real-world challenges.
-The Kaggle Agent stands as a pivotal tool, empowering participants to seamlessly integrate cutting-edge models and datasets, transforming raw data into actionable insights.
-
-By utilizing the **Kaggle Agent**, data scientists can craft innovative solutions that not only uncover hidden patterns but also drive significant advancements in predictive accuracy and model robustness.
-
-🧭 Example Guide - Kaggle Dataset
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-🛠️ Preparing For The Competition
-""""""""""""""""""""""""""""""""""
-
-- 🔨 **Configuring the Kaggle API**
-
-  - Register and login on the `Kaggle <https://www.kaggle.com/>`_ website.
-  - Click on the avatar (usually in the top right corner of the page) -> ``Settings`` -> ``Create New Token``, A file called ``kaggle.json`` will be downloaded.
-  - Move ``kaggle.json`` to ``~/.config/kaggle/``
-  - Modify the permissions of the ``kaggle.json`` file.
-
-    .. code-block:: sh
-
-      chmod 600 ~/.config/kaggle/kaggle.json
-
-  - For more information about Kaggle API Settings, refer to the `Kaggle API <https://github.com/Kaggle/kaggle-api>`_.
-
-- 🔩 **Setting the Environment variables at .env file**
-
-  - Determine the path where the data will be stored and add it to the ``.env`` file.
-
-  .. code-block:: sh
-
-    mkdir -p <your local directory>/ds_data
-    dotenv set KG_LOCAL_DATA_PATH <your local directory>/ds_data
-
-  - 📘 More Environment Variables (Optional)
-
-    - If you want to see all the available environment variables, you can refer to the configuration file for Data Science scenarios:
-
-    .. literalinclude:: ../../rdagent/app/data_science/conf.py
-      :language: python
-      :linenos:
-
-    - These variables allow you to have finer-grained control in Data Science scenarios.
-
-- 🗳️ **Join the competition**
-
-  - If your Kaggle API account has not joined a competition, you will need to join the competition before running the program.
-
-    - At the bottom of the competition details page, you can find the ``Join the competition`` button, click on it and select ``I Understand and Accept`` to join the competition.
-
-    - In the **Competition List Available** below, you can jump to the competition details page.
-
-📥 Preparing Competition DataDataset && Set up RD-Agent Environment
-""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-
-- As a subset of data science, kaggle's dataset still follows the data science format. Based on this, the kaggle dataset can be divided into two categories depending on whether or not it is supported by the **MLE-Bench**.
-
-  - What is **MLE-Bench**?
-
-    - **MLE-Bench** is a comprehensive benchmark designed to evaluate the **machine learning engineering** capabilities of AI systems using real-world scenarios. The dataset includes multiple Kaggle competitions. Since Kaggle does not provide reserved test sets for these competitions, the benchmark includes preparation scripts for splitting publicly available training data into new training and test sets, and scoring scripts for each competition to accurately evaluate submission scores.
-
-  - I'm running a competition Is **MLE-Bench** supported?
-
-    - You can see all the competitions supported by **MLE-Bench** `here <https://github.com/openai/mle-bench/tree/main/mlebench/competitions>`_.
-
-- Prepare datasets for **MLE-Bench** supported competitions.
-
-  - If you agree with the **MLE-Bench** standard, then you don't need to prepare the dataset, you just need to configure your ``.env`` file to automate the download of the dataset.
-
-    - Configure environment variables, add ``DS_IF_USING_MLE_DATA`` to environment variables, and set it to ``True``.
-
-      .. code-block:: sh
-
-        dotenv set DS_IF_USING_MLE_DATA True
-
-    - Configure environment variables, add ``DS_SAMPLE_DATA_BY_LLM`` to environment variables, and set it to ``True``.
-
-      .. code-block:: sh
-
-        dotenv set DS_SAMPLE_DATA_BY_LLM True
-
-    - Configure environment variables, add ``DS_SCEN`` to environment variables, and set it to ``rdagent.scenarios.data_science.scen.KaggleScen``.
-
-      .. code-block:: sh
-
-        dotenv set DS_SCEN rdagent.scenarios.data_science.scen.KaggleScen
-
-  - At this point, you are ready to start running your competition, which will automatically download the data, and the LLM will automatically extract the minimum dataset.
-
-    - After running the program the structure of the ds_data folder should look like this (Using the ``tabular-playground-series-dec-2021`` contest as an example).
-
-      .. code-block:: text
-
-        ds_data
-        ├── tabular-playground-series-dec-2021
-        │   ├── description.md
-        │   ├── sample_submission.csv
-        │   ├── test.csv
-        │   └── train.csv
-        └── zip_files
-            └── tabular-playground-series-dec-2021
-                └── tabular-playground-series-dec-2021.zip
-
-      - The ``ds_data/zip_files`` folder contains a zip file of the raw competition data downloaded from kaggle website.
-
-  - At runtime, RD-Agent will automatically build the Docker image specified at `rdagent/scenarios/kaggle/docker/mle_bench_docker/Dockerfile <https://github.com/microsoft/RD-Agent/blob/main/rdagent/scenarios/kaggle/docker/mle_bench_docker/Dockerfile>`_. This image is responsible for downloading the required datasets and grading files for MLE-Bench.
-
-  Note: The first run may take longer than subsequent runs as the Docker image and data are being downloaded and set up for the first time.
-
-- Prepare datasets for competitions that are not supported by **MLE-Bench**.
-
-  - As a subset of data science, we can follow the format and steps of data science dataset to prepare kaggle dataset. Below we will describe the workflow for preparing a kaggle dataset using the competition ``playground-series-s4e9`` as an example.
-  
-    - Create a ``ds_data/source_data/playground-series-s4e9`` folder, which will be used to store your raw dataset.
-
-      - The raw files for the competition ``playground-series-s4e9`` have two files: ``train.csv``, ``test.csv``, ``sample_submission.csv``, and there are two ways to get the raw data:
-
-        - You can find the raw data required for the competition on the `official kaggle website <https://www.kaggle.com/competitions/playground-series-s4e9/data>`_.
-
-        - Or you can use the command line to download the raw data for the competition, the download command is as follows.
-
-          .. code-block:: sh
-
-            kaggle competitions download -c playground-series-s4e9
-
-    - Create a ``ds_data/source_data/playground-series-s4e9/prepare.py`` file that splits your raw data into **training data**, **test data**, **formatted submission file**, and **standard answer file**. (You will need to write a script based on your raw data.)
-
-      - The following shows the preprocessing code for the raw data of ``playground-series-s4e9``.
-
-      .. literalinclude:: ../../rdagent/scenarios/data_science/example/source_data/playground-series-s4e9/prepare.py
-        :language: python
-        :caption: ds_data/source_data/playground-series-s4e9/prepare.py
-        :linenos:
-
-      - At the end of program execution, the ``ds_data`` folder structure will look like this:
-
-      .. code-block:: text
-
-        ds_data
-        ├── playground-series-s4e9
-        │   ├── train.csv
-        │   ├── test.csv
-        │   └── sample_submission.csv
-        ├── eval
-        │   └── playground-series-s4e9
-        │       └── submission_test.csv
-        └── source_data
-            └── playground-series-s4e9
-                ├── prepare.py
-                ├── sample_submission.csv
-                ├── test.csv
-                └── train.csv
-
-    - Create a ``ds_data/playground-series-s4e9/description.md`` file to describe your competition, dataset description, and other information. We can find the `competition description information <https://www.kaggle.com/competitions/playground-series-s4e9/overview>`_ and the `dataset description information <https://www.kaggle.com/competitions/playground-series-s4e9/data>`_ from the Kaggle website.
-
-      - The following shows the description file for ``playground-series-s4e9``
-
-        .. literalinclude:: ../../rdagent/scenarios/data_science/example/playground-series-s4e9/description.md
-          :language: markdown
-          :caption: ds_data/playground-series-s4e9/description.md
-          :linenos:
-
-    - Create a ``ds_data/eval/playground-series-s4e9/valid.py`` file, which is used to check the validity of the submission files to ensure that their formatting is consistent with the reference file.
-
-      - The following shows a script that checks the validity of a submission based on the ``playground-series-s4e9`` data.
-
-      .. literalinclude:: ../../rdagent/scenarios/data_science/example/eval/playground-series-s4e9/valid.py
-        :language: markdown
-        :caption: ds_data/eval/playground-series-s4e9/valid.py
-        :linenos:
-
-    - Create a ``ds_data/eval/playground-series-s4e9/grade.py`` file, which is used to calculate the score based on the submission file and the **standard answer file**, and output the result in JSON format.
-
-      - The following shows a grading script based on the ``playground-series-s4e9`` data implementation.
-
-      .. literalinclude:: ../../rdagent/scenarios/data_science/example/eval/playground-series-s4e9/grade.py
-        :language: markdown
-        :caption: ds_data/eval/playground-series-s4e9/grade.py
-        :linenos:
-
-  - In this example we don't create a ``ds_data/eval/playground-series-s4e9/sample.py``, we use the sample method provided by RD-Agent by default.
-
-  - At this point, you have created a complete dataset. The correct structure of the dataset should look like this.
-
-    .. code-block:: text
-
-        ds_data
-        ├── playground-series-s4e9
-        │   ├── train.csv
-        │   ├── test.csv
-        │   ├── description.md
-        │   └── sample_submission.csv
-        ├── eval
-        │   └── playground-series-s4e9
-        │       ├── grade.py
-        │       ├── submission_test.csv
-        │       └── valid.py
-        └── source_data
-            └── playground-series-s4e9
-                ├── prepare.py
-                ├── sample_submission.csv
-                ├── test.csv
-                └── train.csv
-
-  - We have prepared a dataset based on the above description for your reference. You can download it with the following command.
-
-    .. code-block:: sh
-
-      wget https://github.com/SunsetWolf/rdagent_resource/releases/download/ds_data/playground-series-s4e9.zip
-
-  - Next, we need to configure the environment for the ``playground-series-s4e9`` contest. You can do this by executing the following command at the command line.
-
-    .. code-block:: sh
-
-      dotenv set DS_IF_USING_MLE_DATA False
-      dotenv set DS_SAMPLE_DATA_BY_LLM False
-      dotenv set DS_SCEN rdagent.scenarios.data_science.scen.KaggleScen
-
-🚀 **Run the Application**
-""""""""""""""""""""""""""""""""""""
-
-  - 🌏 You can directly run the application by using the following command:
-
-    .. code-block:: sh
-
-        rdagent data_science --competition <Competition ID>
-
-    - The following shows the command to run based on the ``playground-series-s4e9`` data
-
-      .. code-block:: sh
-
-          rdagent data_science --competition playground-series-s4e9
-
-    -  More CLI Parameters for `rdagent data_science` command:
-
-      .. automodule:: rdagent.app.data_science.loop
-        :members:
-        :no-index:
-
-  - 📈 Visualize the R&D Process
-
-    - We provide a web UI to visualize the log. You just need to run:
-
-      .. code-block:: sh
-
-          rdagent ui --port <custom port> --log-dir <your log folder like "log/"> --data_science True
-
-    - Then you can input the log path and visualize the R&D process.
-
-  - 🧪 Scoring the test results
-
-    - Finally, shutdown the program, and get the test set scores with this command.
-
-    .. code-block:: sh
-
-      dotenv run -- python rdagent/log/mle_summary.py grade <url_to_log>
-
-    - If you have configured the full output in ``ds_data/eval/playground-series-s4e9/grade.py``, or if you are running a competition that receives **MLE-Bench** support, you can also summarize the scores by running the following command.
-
-    .. code-block:: sh
-
-      rdagent grade_summary --log-folder=<url_to_log>
-
-    Here, <url_to_log> refers to the parent directory of the log folder generated during the run.

docs/scens/finetune.rst

@@ -1,163 +0,0 @@
-.. _finetune_agent:
-
-=============================
-Fine-tuning an Existing Model
-=============================
-
-## **🎯 Scenario: Continue Training on a Pre-trained Model**
-
-In this workflow the **Data Science Agent** starts from a *previously trained* model (and its training script), performs additional fine-tuning on new data, and then re-uses the updated weights for subsequent inference runs.
-
-🚧 Directory Structure
-
-Your competition folder (here called ``custom_data``) must contain **one extra sub-directory** named ``prev_model`` where you keep the old weights and the code that produced them:
-
-.. code-block:: text
-
-   ds_data
-   └── custom_data
-       ├── train.csv
-       ├── test.csv
-       ├── sample_submission.csv      # optional
-       ├── description.md             # optional
-       ├── sample.py                  # optional
-       └── prev_model                 # ← NEW
-           ├── models/                #   previous checkpoints (e.g. *.bin, *.pt, *.ckpt)
-           └── main.py                  #   training/inference scripts you used before
-
-If your competition provides custom grading/validation scripts, keep them under ``ds_data/eval/custom_data`` exactly as before.
-
-🔧 Environment Setup
-~~~~~~~~~~~~~~~~~~~~~~
-
-Add or update the following variables in **.env** (examples shown):
-
-.. code-block:: sh
-
-   # required for all Data-Science runs
-   dotenv set DS_LOCAL_DATA_PATH <your local path>/ds_data
-
-   # optional: choose docker / conda, etc.
-   dotenv set DS_CODER_COSTEER_ENV_TYPE docker
-
-🚀 How It Works at Runtime
-
-1. **First run**
-
-   * `rdagent` detects `prev_model/models`.
-   * It loads the latest checkpoint and prepare the fine-tuning based on code found under `prev_model/*.py` (or your own pipeline if you override it).
-   * Fine-tuned weights are written to `./workspace_input/models`.
-
-2. **Subsequent runs**
-
-   * When you execute `python ./workspace_input/main.py`, the script first looks for a checkpoint in `./workspace_input/models`.
-   * If found, it **skips fine-tuning** and goes straight to prediction / submission generation.
-
-⏰ Managing Timeouts
-
-
-By default:
-
-* **Debug loop**: 1 hour (``DS_DEBUG_TIMEOUT=3600`` seconds)  
-* **Full run**  : 3 hours (``DS_FULL_TIMEOUT=10800`` seconds)
-
-Override either value in **.env**:
-
-.. code-block:: sh
-
-   # give the debug loop 45 min and the full loop 6 h
-   dotenv set DS_DEBUG_TIMEOUT 2700
-   dotenv set DS_FULL_TIMEOUT 21600
-
-- 🚀 **Run the Application**
-
-  - You can directly run the application by using the following command:
-    
-    .. code-block:: sh
-
-        dotenv run -- python rdagent/app/finetune/data_science/loop.py --competition <Competition ID>
-
-  - Then, you can run the test set score corresponding to each round of the loop.
-
-    .. code-block:: sh
-
-        dotenv run -- python rdagent/log/mle_summary.py grade <url_to_log>
-
-    Here, <url_to_log> refers to the parent directory of the log folder generated during the run.
-
-- 📥 **Visualize the R&D Process**
-
-  - We provide a web UI to visualize the log. You just need to run:
-
-    .. code-block:: sh
-
-        streamlit run rdagent/log/ui/dsapp.py
-
-  - Then you can input the log path and visualize the R&D process.
-
-🔍 MLE-bench Guide: Running ML Engineering via MLE-bench
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-- 📝 **MLE-bench Overview**
-
-  - MLE-bench is a comprehensive benchmark designed to evaluate the ML engineering capabilities of AI systems using real-world scenarios. The dataset comprises 75 Kaggle competitions. Since Kaggle does not provide held-out test sets for these competitions, the benchmark includes preparation scripts that split the publicly available training data into new training and test sets, and grading scripts are provided for each competition to accurately evaluate submission scores.
-
-- 🔧 **Set up Environment for MLE-bench**
-
-  - Running R&D-Agent on MLE-bench is designed for full automation. There is no need for manual downloads and data preparation. Simply set the environment variable ``DS_IF_USING_MLE_DATA`` to True.  
-
-  - At runtime, R&D-Agent will automatically build the Docker image specified at ``rdagent/scenarios/kaggle/docker/mle_bench_docker/Dockerfile``. This image is responsible for downloading the required datasets and grading files for MLE-bench.  
-  
-  - Note: The first run may take longer than subsequent runs as the Docker image and data are being downloaded and set up for the first time.
-
-    .. code-block:: sh
-
-        dotenv set DS_LOCAL_DATA_PATH <your local directory>/ds_data
-        dotenv set DS_IF_USING_MLE_DATA True
-
-- 🔨 **Configuring the Kaggle API**
-
-  - Downloading Kaggle competition data requires the Kaggle API. You can set up the Kaggle API by following these steps:
-  
-    - Register and login on the `Kaggle <https://www.kaggle.com/>`_ website.
-
-    - Click on the avatar (usually in the top right corner of the page) -> ``Settings`` -> ``Create New Token``, A file called ``kaggle.json`` will be downloaded.
-
-    - Move ``kaggle.json`` to ``~/.config/kaggle/``
-
-    - Modify the permissions of the ``kaggle.json`` file.
-
-      .. code-block:: sh
-
-        chmod 600 ~/.config/kaggle/kaggle.json
-
-  - For more information about Kaggle API Settings, refer to the `Kaggle API <https://github.com/Kaggle/kaggle-api>`_.
-
-
-- 🔩 **Setting the Environment Variables for MLE-bench**
-
-  - In addition to auto-downloading the benchmark data, you must also configure the runtime environment for executing the competition code.  
-  - Use the environment variable ``DS_CODER_COSTEER_ENV_TYPE`` to select the execution mode:
-    
-    • When set to docker (the default), RD-Agent utilizes the official Kaggle Docker image (``gcr.io/kaggle-gpu-images/python:latest``) to ensure that all required packages are available.  
-    • If you prefer to use a custom Docker setup, you can modify the configuration using ``DS_DOCKER_IMAGE`` or ``DS_DOCKERFILE_FOLDER_PATH``.  
-    • Alternatively, if your competition work only demands basic libraries, you may set ``DS_CODER_COSTEER_ENV_TYPE`` to conda. In this mode, you must create a local conda environment named “kaggle” and pre-install the necessary packages. RD-Agent will execute the competition code within this “kaggle” conda environment.
-
-    .. code-block:: sh
-
-      # Configure the runtime environment: choice between 'docker' (default) or 'conda'
-      dotenv set DS_CODER_COSTEER_ENV_TYPE docker
-
-- **Additional Guidance**
-
-  - **Combine different LLM Models at R&D Stage**
-
-    - You can combine different LLM models at the R&D stage. 
-
-    - By default, when you set environment variable ``CHAT_MODEL``, it covers both R&D stages. When customizing the model for the development stage, you can set:
-    
-    .. code-block:: sh
-
-      # This example sets the model to "o3-mini". For some models, the reasoning effort shoule be set to "None".
-      dotenv set LITELLM_CHAT_MODEL_MAP '{"coding":{"model":"o3-mini","reasoning_effort":"high"},"running":{"model":"o3-mini","reasoning_effort":"high"}}'
-

docs/scens/model_agent_fin.rst

@@ -9,33 +9,19 @@ Finance Model Agent
 
 📖 Background
 ~~~~~~~~~~~~~~
-In the realm of quantitative finance, both factor discovery and model development play crucial roles in driving performance. 
-While much attention is often given to the discovery of new financial factors, the **models** that leverage these factors are equally important. 
-The effectiveness of a quantitative strategy depends not only on the factors used but also on how well these factors are integrated into robust, predictive models.
+TODO
 
-However, the process of developing and optimizing these models can be labor-intensive and complex, requiring continuous refinement and adaptation to ever-changing market conditions. 
-And this is where the **Finance Model Agent** steps in.
-
-
-🎥 `Demo <https://rdagent.azurewebsites.net/model_loop>`_
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. raw:: html
-
-    <div style="display: flex; justify-content: center; align-items: center;">
-      <video width="600" controls>
-        <source src="https://rdagent.azurewebsites.net/media/d85e8cab1da1cd3501d69ce837452f53a971a24911eae7bfa9237137.mp4" type="video/mp4">
-        Your browser does not support the video tag.
-      </video>
-    </div>
+🎥 Demo
+~~~~~~~~~~
+TODO: Here should put a video of the demo.
 
 
 🌟 Introduction
 ~~~~~~~~~~~~~~~~
 
-In this scenario, our automated system proposes hypothesis, constructs model, implements code, conducts back-testing, and utilizes feedback in a continuous, iterative process.
-
-The goal is to automatically optimize performance metrics within the Qlib library, ultimately discovering the most efficient code through autonomous research and development.
+In this scenario, our automated system proposes hypothesis, constructs model, implements code, receives back-testing, and uses feedbacks. 
+Hypothesis is iterated in this continuous process. 
+The system aims to automatically optimise performance metrics from Qlib library thereby finding the optimised code through autonomous research and development.
 
 Here's an enhanced outline of the steps:
 
@@ -83,68 +69,51 @@ Here's an enhanced outline of the steps:
 ⚡ Quick Start
 ~~~~~~~~~~~~~~~~~
 
-Please refer to the installation part in :doc:`../installation_and_configuration` to prepare your system dependency.
-
 You can try our demo by running the following command:
 
 - 🐍 Create a Conda Environment
-
-  - Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
-
-    .. code-block:: sh
+    - Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
     
-        conda create -n rdagent python=3.10
+      .. code-block:: sh
+      
+          conda create -n rdagent python=3.10
 
-  - Activate the environment:
+    - Activate the environment:
 
-    .. code-block:: sh
+      .. code-block:: sh
 
-        conda activate rdagent
+          conda activate rdagent
 
-- 📦 Install the RDAgent
-    
-  - You can install the RDAgent package from PyPI:
+- 🛠️ Run Make Files
+    - Navigate to the directory containing the MakeFile and set up the development environment:
 
-    .. code-block:: sh
+      .. code-block:: sh
 
-        pip install rdagent
+          make dev
+
+- 📦 Install Pytorch
+    - Install Pytorch and related libraries:
+
+      .. code-block:: sh
+
+          pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
+          pip3 install torch_geometric
+
+- ⚙️ Environment Configuration
+    - Place the `.env` file in the same directory as the `.env.example` file.
+        - The `.env.example` file contains the environment variables required for users using the OpenAI API (Please note that `.env.example` is an example file. `.env` is the one that will be finally used.)
+
+    - Export each variable in the .env file:
+
+      .. code-block:: sh
+
+          export $(grep -v '^#' .env | xargs)
 
 - 🚀 Run the Application
-    
-  - You can directly run the application by using the following command:
-    
     .. code-block:: sh
 
-        rdagent fin_model
+        python rdagent/app/qlib_rd_loop/model_w_sc.py
 
 🛠️ Usage of modules
 ~~~~~~~~~~~~~~~~~~~~~
-
-.. _Env Config: 
-
-- **Env Config**
-
-The following environment variables can be set in the `.env` file to customize the application's behavior:
-
-.. autopydantic_settings:: rdagent.app.qlib_rd_loop.conf.ModelBasePropSetting
-    :settings-show-field-summary: False
-    :exclude-members: Config
-
-- **Qlib Config**
-    - The `config.yaml` file located in the `model_template` folder contains the relevant configurations for running the developed model in Qlib. The default settings include key information such as:
-        - **market**: Specifies the market, which is set to `csi300`.
-        - **fields_group**: Defines the fields group, with the value `feature`.
-        - **col_list**: A list of columns used, including various indicators such as `RESI5`, `WVMA5`, `RSQR5`, and others.
-        - **start_time**: The start date for the data, set to `2008-01-01`.
-        - **end_time**: The end date for the data, set to `2020-08-01`.
-        - **fit_start_time**: The start date for fitting the model, set to `2008-01-01`.
-        - **fit_end_time**: The end date for fitting the model, set to `2014-12-31`.
-
-    - The default hyperparameters used in the configuration are as follows:
-        - **n_epochs**: The number of epochs, set to `100`.
-        - **lr**: The learning rate, set to `1e-3`.
-        - **early_stop**: The early stopping criterion, set to `10`.
-        - **batch_size**: The batch size, set to `2000`.
-        - **metric**: The evaluation metric, set to `loss`.
-        - **loss**: The loss function, set to `mse`.
-        - **n_jobs**: The number of parallel jobs, set to `20`.
+TODO: Show some examples:

docs/scens/model_agent_med.rst

@@ -0,0 +1,5 @@
+.. _model_agent_med:
+
+===================
+Medical Model Agent
+===================

docs/scens/model_copilot_general.rst

@@ -9,23 +9,11 @@ General Model Copilot
 
 📖 Background
 ~~~~~~~~~~~~~~
-In the fast-paced field of artificial intelligence, the number of academic papers published each year is skyrocketing. 
-These papers introduce new models, techniques, and approaches that can significantly advance the state of the art. 
-However, reproducing and implementing these models can be a daunting task, requiring substantial time and expertise. 
-Researchers often face challenges in extracting the essential details from these papers and converting them into functional code.
-And this is where the **General Model Copilot** steps in.
+TODO:
 
-🎥 `Demo <https://rdagent.azurewebsites.net/report_model>`_
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. raw:: html
-
-    <div style="display: flex; justify-content: center; align-items: center;">
-      <video width="600" controls>
-        <source src="https://rdagent.azurewebsites.net/media/b35f904765b05099b0fcddbebe041a04f4d7bde239657e5fc24bf0cc.mp4" type="video/mp4">
-        Your browser does not support the video tag.
-      </video>
-    </div>
+🎥 Demo
+~~~~~~~~~~
+TODO: Here should put a video of the demo.
 
 🌟 Introduction
 ~~~~~~~~~~~~~~~~
@@ -57,43 +45,79 @@ This demo automates the extraction and iterative development of models from acad
 ⚡ Quick Start
 ~~~~~~~~~~~~~~~~~
 
-Please refer to the installation part in :doc:`../installation_and_configuration` to prepare your system dependency.
-
 You can try our demo by running the following command:
 
 - 🐍 Create a Conda Environment
-  
-  - Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
-
-    .. code-block:: sh
+    - Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
     
-        conda create -n rdagent python=3.10
+      .. code-block:: sh
+      
+          conda create -n rdagent python=3.10
 
-  - Activate the environment:
+    - Activate the environment:
 
-    .. code-block:: sh
+      .. code-block:: sh
 
-        conda activate rdagent
+          conda activate rdagent
 
-- 📦 Install the RDAgent
-    
-  - You can install the RDAgent package from PyPI:
+- 🛠️ Run Make Files
+    - Navigate to the directory containing the MakeFile and set up the development environment:
 
-    .. code-block:: sh
+      .. code-block:: sh
 
-        pip install rdagent
+          make dev
 
+- 📦 Install Pytorch
+    - Install Pytorch and related libraries:
+
+      .. code-block:: sh
+
+          pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
+          pip3 install torch_geometric
+
+- ⚙️ Environment Configuration
+    - Place the `.env` file in the same directory as the `.env.example` file.
+        - The `.env.example` file contains the environment variables required for users using the OpenAI API (Please note that `.env.example` is an example file. `.env` is the one that will be finally used.)
+
+    - Export each variable in the .env file:
+
+      .. code-block:: sh
+
+          export $(grep -v '^#' .env | xargs)
 
 - 🚀 Run the Application
-    
-  - Prepare relevant files (in pdf format) by uploading papers to the directory below and copy the path as report_file_path.
+    - Prepare relevant files (in pdf format) by uploading papers to the directory below and copy the path as report_file_path.
       
-    .. code-block:: sh
+      .. code-block:: sh
 
-        rdagent/scenarios/general_model
+          rdagent/scenarios/general_model
     
-  - Run the following command in your terminal within the same virtual environment:
-  
-    .. code-block:: sh
+    - Run the following command in your terminal within the same virtual environment:
 
-        rdagent general_model --report-file-path=<path_to_pdf_file>
+      .. code-block:: sh
+
+          python rdagent/app/general_model/general_model.py report_file_path 
+
+🛠️ Usage of modules
+~~~~~~~~~~~~~~~~~~~~~
+There are mainly two modules in this scenario: one that reads the paper and returns a model card & one that reads the model card and returns functional code. The moduldes can also be used separately as components for developers to build up new scenarios.
+
+
+- Configurations
+    - The `config.yaml` file located in the `model_template` folder contains the relevant configurations for running the developed model in Qlib. The default settings include key information such as:
+        - **market**: Specifies the market, which is set to `csi300`.
+        - **fields_group**: Defines the fields group, with the value `feature`.
+        - **col_list**: A list of columns used, including various indicators such as `RESI5`, `WVMA5`, `RSQR5`, and others.
+        - **start_time**: The start date for the data, set to `2008-01-01`.
+        - **end_time**: The end date for the data, set to `2020-08-01`.
+        - **fit_start_time**: The start date for fitting the model, set to `2008-01-01`.
+        - **fit_end_time**: The end date for fitting the model, set to `2014-12-31`.
+
+    - The default hyperparameters used in the configuration are as follows:
+        - **n_epochs**: The number of epochs, set to `100`.
+        - **lr**: The learning rate, set to `1e-3`.
+        - **early_stop**: The early stopping criterion, set to `10`.
+        - **batch_size**: The batch size, set to `2000`.
+        - **metric**: The evaluation metric, set to `loss`.
+        - **loss**: The loss function, set to `mse`.
+        - **n_jobs**: The number of parallel jobs, set to `20`.

docs/scens/quant_agent_fin.rst

@@ -1,113 +0,0 @@
-.. _quant_agent_fin:
-
-=====================
-Finance Quant Agent
-=====================
-
-
-**🥇The First Data-Centric Quant Multi-Agent Framework RD-Agent(Q)**
----------------------------------------------------------------------
-
-R&D-Agent for Quantitative Finance, in short **RD-Agent(Q)**, is the first data-centric, multi-agent framework designed to automate the full-stack research and development of quantitative strategies via coordinated factor-model co-optimization.
-
-You can learn more details about **RD-Agent(Q)** through the `paper <https://arxiv.org/abs/2505.15155>`_.
-
-⚡ Quick Start
-~~~~~~~~~~~~~~~~~
-
-Before you start, please make sure you have installed RD-Agent and configured the environment for RD-Agent correctly. If you want to know how to install and configure the RD-Agent, please refer to the `documentation <../installation_and_configuration.html>`_.
-
-Then, you can run the framework by running the following command:
-
-- 🐍 Create a Conda Environment
-
-  - Create a new conda environment with Python (3.10 and 3.11 are well tested in our CI):
-
-    .. code-block:: sh
-
-          conda create -n rdagent python=3.10
-
-  - Activate the environment:
-
-    .. code-block:: sh
-
-        conda activate rdagent
-
-- 📦 Install the RDAgent
-  
-  - You can install the RDAgent package from PyPI:
-
-    .. code-block:: sh
-
-        pip install rdagent
-
-- 🚀 Run the Application
-    
-  - You can directly run the application by using the following command:
-    
-    .. code-block:: sh
-
-        rdagent fin_quant
-
-
-🛠️ Usage of modules
-~~~~~~~~~~~~~~~~~~~~~
-
-.. _Env Config: 
-
-- **Env Config**
-
-The following environment variables can be set in the `.env` file to customize the application's behavior:
-
-.. autopydantic_settings:: rdagent.app.qlib_rd_loop.conf.QuantBasePropSetting
-    :settings-show-field-summary: False
-    :exclude-members: Config
-
-.. autopydantic_settings:: rdagent.components.coder.factor_coder.config.FactorCoSTEERSettings
-    :settings-show-field-summary: False
-    :members: coder_use_cache, data_folder, data_folder_debug, file_based_execution_timeout, select_method, max_loop, knowledge_base_path, new_knowledge_base_path
-    :exclude-members: Config, fail_task_trial_limit, v1_query_former_trace_limit, v1_query_similar_success_limit, v2_query_component_limit, v2_query_error_limit, v2_query_former_trace_limit, v2_error_summary, v2_knowledge_sampler
-    :no-index:
-
-- **Qlib Configuration**
-    - The `.yaml` files in both the `model_template` and `factor_template` directories contain some configurations for running the corresponding models or factors within the Qlib framework. Below is an overview of their contents and roles:
-        - **General Settings**:
-            - **provider_uri**: Specifies the local Qlib data path, set to `~/.qlib/qlib_data/cn_data`.
-            - **market**: Configured to `csi300`, representing the CSI 300 index constituents.
-            - **benchmark**: Set to `SH000300`, used for backtesting evaluation.
-        
-        - **Data Handling**:
-            - **start_time** and **end_time**: Define the full data range, from `2008-01-01` to `2022-08-01`.
-            - **fit_start_time**: The start date for fitting the model, set to `2008-01-01`.
-            - **fit_end_time**: The end date for fitting the model, set to `2014-12-31`.
-            - **features and labels**: Generated via a nested data loader combining `Alpha158DL` (for engineered features such as `RESI5`, `WVMA5`, `RSQR5`, `KLEN`, etc.) and a `StaticDataLoader` that loads precomputed factor files (`combined_factors_df.parquet`).
-            -  **normalization**: The pipeline includes `RobustZScoreNorm` (with clipping) and `Fillna` for inference, and `DropnaLabel` with `CSZScoreNorm` for training.
-        
-        - **Training Configuration**:
-            - **Model**: Uses `GeneralPTNN`, a PyTorch-based neural network model.
-            - **Dataset Splits**:
-                - **train**: `2008-01-01` to `2014-12-31`
-                - **valid**: `2015-01-01` to `2016-12-31`
-                - **test**: `2017-01-01` to `2020-08-01`
-
-        - **Default Hyperparameters** (can be overridden by command-line arguments):
-            - **n_epochs**: `100`
-            - **lr**: `2e-4`
-            - **early_stop**: `10`
-            - **batch_size**: `256`
-            - **weight_decay**: `0.0`
-            - **metric**: `loss`
-            - **loss**: `mse`
-            - **n_jobs**: `20`
-            - **GPU**: `0` (uses GPU 0 if available)
-            
-        - **Backtesting and Evaluation**:
-            - **strategy**: `TopkDropoutStrategy`, which selects the top 50 stocks and randomly drops 5 to introduce exploration.
-            - **backtest period**: `2017-01-01` to `2020-08-01`
-            - **initial capital**: `100,000,000`
-            - **cost configuration**: Includes open/close costs, minimum transaction costs, and slippage control.
-            
-        - **Recording and Analysis**:
-            - **SignalRecord**: Logs predicted signals.
-            - **SigAnaRecord**: Performs signal analysis without long-short separation.
-            - **PortAnaRecord**: Conducts portfolio analysis using the configured strategy and backtest settings.

docs/security/SECURITY_RUNBOOK.md

@@ -1,264 +0,0 @@
-# Security Runbook für Predix
-
-## Bandit Security Scanner
-
-### Konfiguration
-
-Bandit ist als Pre-Commit Hook konfiguriert und scannt automatisch alle Python-Dateien vor jedem Commit.
-
-**Konfigurationsdateien:**
-- `.bandit.yml` - Bandit-Einstellungen
-- `.pre-commit-config.yaml` - Pre-commit Hooks
-- `requirements/lint.txt` - Bandit Dependency
-
-### Scan-Befehle
-
-```bash
-# Alle Dateien scannen
-bandit -r rdagent/ -c .bandit.yml
-
-# Nur HIGH Severity Issues
-bandit -r rdagent/ -c .bandit.yml --severity-level high
-
-# Spezifische Datei scannen
-bandit rdagent/components/backtesting/results_db.py -c .bandit.yml
-
-# Mit JSON Output (für CI/CD)
-bandit -r rdagent/ -c .bandit.yml -f json -o results/security/bandit-report.json
-```
-
-### Gefundene HIGH Severity Issues
-
-#### 1. subprocess mit shell=True (12 Issues)
-
-**Dateien:**
-- `rdagent/utils/env.py` (mehrere Stellen)
-- `rdagent/components/coder/factor_coder/factor.py`
-
-**Bewertung:** ✅ **Akzeptiert** - Internal Tool
-- Alle Commands verwenden hardcodierte Strings, keine User-Inputs
-- Risk: Command Injection bei manipulierten Inputs
-- Mitigation: Code-Review für alle subprocess-Aufrufe, keine externen Inputs
-
-**Empfohlene Fixes (Future PR):**
-```python
-# Statt:
-subprocess.run(f"conda env list | grep -q '^{env_name} '", shell=True)
-
-# Besser:
-subprocess.run(["conda", "env", "list"], capture_output=True, text=True, check=True)
-# Dann in Python auf env_name prüfen
-```
-
-**Priority:** MEDIUM - Refactor in nächster Wartungsphase
-
----
-
-#### 2. Jinja2 autoescape=False (6 Issues)
-
-**Dateien:**
-- `rdagent/components/coder/data_science/ensemble/__init__.py`
-- `rdagent/components/coder/data_science/ensemble/eval.py`
-- `rdagent/scenarios/kaggle/developer/coder.py` (2x)
-- `rdagent/scenarios/qlib/experiment/utils.py`
-- `rdagent/utils/agent/tpl.py`
-
-**Bewertung:** ✅ **Akzeptiert** - Template Generation für Code
-- Templates generieren Python-Code, nicht HTML
-- XSS-Risiko besteht nicht bei Code-Templates
-- `StrictUndefined` verhindert undefined variable leaks
-
-**Mitigation:** ✅ Already secure durch `StrictUndefined`
-
----
-
-#### 3. MD5 Hash (2 Issues)
-
-**Dateien:**
-- `rdagent/log/ui/ds_trace.py` (2x)
-
-**Bewertung:** ✅ **Akzeptiert** - Non-Crypto Use Case
-- MD5 wird für UI-Caching verwendet, nicht für Security
-- `usedforsecurity=False` kann hinzugefügt werden
-
-**Empfohlener Fix (Quick Win):**
-```python
-# Zeile 226 & 333 in rdagent/log/ui/ds_trace.py
-unique_key = hashlib.md5("...".encode(), usedforsecurity=False).hexdigest()
-```
-
-**Priority:** LOW - 5 Minuten Fix
-
----
-
-#### 4. tarfile.extractall ohne Validation (2 Issues)
-
-**Dateien:**
-- `rdagent/scenarios/data_science/proposal/exp_gen/select/submit.py`
-- `rdagent/scenarios/kaggle/kaggle_crawler.py`
-
-**Bewertung:** ⚠️ **Sollte gefixt werden** - Path Traversal Risk
-- Extrahiert externe Archive (Kaggle Datasets)
-- Risk: Path Traversal Attacks via `../../../etc/passwd`
-
-**Empfohlener Fix:**
-```python
-import tarfile
-import os
-
-def safe_extractall(tar: tarfile.TarFile, path: str) -> None:
-    """Extract tarfile safely, preventing path traversal."""
-    def is_within_directory(directory: str, target: str) -> bool:
-        abs_directory = os.path.abspath(directory)
-        abs_target = os.path.abspath(target)
-        prefix = os.path.commonprefix([abs_directory, abs_target])
-        return prefix == abs_directory
-
-    for member in tar.getmembers():
-        member_path = os.path.join(path, member.name)
-        if not is_within_directory(path, member_path):
-            raise ValueError(f"Attempted Path Traversal: {member.name}")
-    tar.extractall(path=path)
-
-# Usage:
-with tarfile.open(tar_path, mode="r:*") as tar:
-    safe_extractall(tar, to_dir)
-```
-
-**Priority:** HIGH - Nächster Sprint
-
----
-
-#### 5. Flask debug=True (1 Issue)
-
-**Datei:**
-- `rdagent/log/server/debug_app.py:170`
-
-**Bewertung:** ⚠️ **Sollte gefixt werden** - Debugger Exposure
-- `debug=True` ermöglicht arbitrary code execution
-- Sollte nur in Development-Umgebung sein
-
-**Empfohlener Fix:**
-```python
-import os
-
-# Zeile 170
-debug_mode = os.getenv("FLASK_ENV") == "development"
-app.run(debug=debug_mode, host="0.0.0.0", port=port)
-```
-
-**Priority:** HIGH - Quick Fix
-
----
-
-### Skipped Rules Begründung
-
-| Rule | Begründung | Status |
-|------|-----------|--------|
-| B101 (assert) | Development/Debug Assertions | ✅ Akzeptiert |
-| B311 (random) | Non-Crypto Random Usage | ✅ Akzeptiert |
-| B404, B603, B607 (subprocess) | Legitimate System Operations | ⚠️ Monitor |
-| B113 (request timeout) | Wird in future PR gefixt | 📋 Planned |
-| B608 (SQL injection) | Internal Tool, keine User-Inputs | ⚠️ Monitor |
-| B301 (pickle) | Controlled Data Sources | ⚠️ Monitor |
-| B701 (jinja2) | Code Templates, nicht HTML | ✅ Secure |
-| B201 (flask debug) | Development Only | 📋 Fix Planned |
-| B324 (hashlib) | Non-Crypto (Caching) | 📋 Quick Fix |
-| B202 (tarfile) | External Archives | 🔴 Fix Required |
-
----
-
-### Pre-Commit Verhalten
-
-**Blockiert Commit bei:**
-- HIGH Severity Issues (standardmäßig aktiv)
-
-**Erlaubt Commit bei:**
-- MEDIUM Severity Issues (Informational)
-- LOW Severity Issues (Informational)
-
-**Manuelles Überspringen (NOT recommended):**
-```bash
-# Nur im Notfall!
-git commit --no-verify -m "feat: urgent fix"
-```
-
----
-
-### CI/CD Integration
-
-Für GitHub Actions:
-
-```yaml
-# .github/workflows/security.yml
-name: Security Scan
-
-on:
-  push:
-    branches: [master, main]
-  pull_request:
-    branches: [master, main]
-
-jobs:
-  bandit:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.10'
-
-      - name: Install dependencies
-        run: pip install bandit
-
-      - name: Run Bandit
-        run: |
-          bandit -r rdagent/ \
-            -c .bandit.yml \
-            -f json \
-            -o bandit-report.json \
-            --exit-zero
-
-      - name: Upload Security Report
-        uses: github/codeql-action/upload-sarif@v3
-        if: always()
-        with:
-          sarif_file: bandit-report.json
-```
-
----
-
-### Regelmäßige Wartung
-
-**Monatlich:**
-```bash
-# Bandit-Report generieren
-bandit -r rdagent/ -c .bandit.yml -f html -o results/security/bandit-report-$(date +%Y-%m).html
-
-# Trend-Analyse
-bandit -r rdagent/ -c .bandit.yml -lll | grep "Total issues"
-```
-
-**Quartalsweise:**
-- Alle `# nosec` Comments reviewen
-- Skipped Rules reevaluieren
-- Neue Security-Best-Practices einarbeiten
-
----
-
-### Kontakt & Eskalation
-
-- **Security Issues melden:** @TPTBusiness
-- **False Positives:** Zu `.bandit.yml` hinzufügen mit Begründung
-- **Patches:** PR mit Label `security` erstellen
-
----
-
-### Referenzen
-
-- [Bandit Documentation](https://bandit.readthedocs.io/)
-- [OWASP Top 10](https://owasp.org/www-project-top-ten/)
-- [CWE Database](https://cwe.mitre.org/)
-- [Pre-Commit Hooks](https://pre-commit.com/)

docs/ui.rst

@@ -18,27 +18,23 @@ In `RD-Agent/` folder, run:
 
 .. code-block:: bash
 
-    rdagent ui --port <port> --log-dir <log_dir like "log/"> [--debug]
+    streamlit run rdagent/log/ui/app.py --server.port <port> -- --log_dir <log_dir>
 
 This will start a web app on `http://localhost:<port>`.
 
 **NOTE**: The log_dir parameter is not required. You can manually enter the log_path in the web app. If you set the log_dir parameter, you can easily select a different log_path in the web app.
 
---debug is optional, it will show a "Single Step Run" button in sidebar and saved objects info in the web app.
-
 Use Web App
 -----------
 
 1. Open the sidebar.
 
 .. TODO: update these
-
 2. Select the scenario you want to show. There are some pre-defined scenarios:
     - Qlib Model
     - Qlib Factor
     - Data Mining
     - Model from Paper
-    - Kaggle
 
 3. Click the `Config⚙️` button and input the log path (if you set the log_dir parameter, you can select a log_path in the dropdown list).
 

examples/01_factor_discovery.py

@@ -1,188 +0,0 @@
-#!/usr/bin/env python
-"""
-Beispiel 01: Factor Discovery - Automatische Faktor-Generierung
-
-Was macht dieses Beispiel?
-    Dieses Skript demonstriert die automatische Generierung neuer Trading-Faktoren
-    mittels LLM (Large Language Model). Es führt den CoSTEER-Loop aus, der:
-    1. Faktor-Hypothesen generiert
-    2. Implementiert und backtestet
-    3. Feedback für Verbesserungen gibt
-
-Voraussetzungen:
-    - PREDIX installiert (`pip install -e ".[all]"`)
-    - EURUSD 1-Minute Daten in Qlib geladen
-    - LLM-Server läuft (für --llm local) ODER API-Key gesetzt
-
-Erwartete Laufzeit:
-    ~10-15 Minuten pro Loop (local LLM)
-    ~30-60 Minuten pro Loop (API LLM)
-
-Output:
-    - Generierte Faktoren in RD-Agent_workspace/
-    - Performance-Metriken (ARR, Sharpe, IC, MaxDD)
-    - Faktor-Implementierungen als Python-Code
-"""
-
-import argparse
-import logging
-import sys
-from pathlib import Path
-
-# Logging konfigurieren
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s | %(levelname)-8s | %(message)s',
-    datefmt='%Y-%m-%d %H:%M:%S'
-)
-logger = logging.getLogger(__name__)
-
-
-def run_factor_discovery(loop_n: int, llm_model: str, skip_checkout: bool = False) -> None:
-    """
-    Führt die Faktor-Generierung aus.
-
-    Args:
-        loop_n: Anzahl der Evolutions-Loops (default: 3)
-        llm_model: LLM-Modell ('local', 'openai', 'anthropic')
-        skip_checkout: Git checkout überspringen (für Testing)
-    """
-    logger.info("=" * 60)
-    logger.info("PREDIX Factor Discovery - Beispiel 01")
-    logger.info("=" * 60)
-    logger.info(f"Loops: {loop_n}")
-    logger.info(f"LLM Model: {llm_model}")
-    logger.info(f"Skip Checkout: {skip_checkout}")
-    logger.info("=" * 60)
-
-    # Versuche rdagent zu importieren
-    try:
-        from rdagent.app import fin_quant
-        from rdagent.scenarios.qlib.factor_experiment import factor_experiment
-    except ImportError as e:
-        logger.error(f"Konnte rdagent nicht importieren: {e}")
-        logger.error("Bitte installiere PREDIX: pip install -e \".[all]\"")
-        sys.exit(1)
-
-    # Parameter konfigurieren
-    logger.info("Konfiguriere Experiment...")
-
-    # In der Realität würde hier das rdagent CLI aufgerufen werden:
-    # rdagent fin_quant --loop-n {loop_n} --model {llm_model}
-    
-    # Für dieses Beispiel simulieren wir den Ablauf:
-    logger.info("Starte Faktor-Generierung...")
-    logger.info("Dieser Schritt würde in der Produktion den LLM-gesteuerten")
-    logger.info("CoSTEER-Loop ausführen, der neue Faktoren generiert.")
-    
-    # Beispiel-Output (simuliert)
-    logger.info("-" * 60)
-    logger.info("SIMULIERTER OUTPUT (echter Lauf würde LLM verwenden):")
-    logger.info("-" * 60)
-    
-    example_factors = [
-        {
-            "name": "london_momentum_open_16",
-            "hypothesis": "Long EURUSD wenn erste 16 Bars der London-Session positiven Return zeigen",
-            "arr": "12.4%",
-            "sharpe": 2.1,
-            "ic": 0.087,
-            "max_dd": "8.3%",
-            "trades_per_day": "8-12"
-        },
-        {
-            "name": "hl_range_mean_reversion",
-            "hypothesis": "Short EURUSD wenn High-Low-Range über 2x Durchschnitt expandiert",
-            "arr": "9.8%",
-            "sharpe": 1.7,
-            "ic": -0.065,
-            "max_dd": "11.2%",
-            "trades_per_day": "6-10"
-        },
-        {
-            "name": "session_volatility_ratio",
-            "hypothesis": "Long EURUSD wenn aktuelle Vol unter Durchschnitt (calm before trend)",
-            "arr": "11.2%",
-            "sharpe": 1.9,
-            "ic": 0.072,
-            "max_dd": "9.1%",
-            "trades_per_day": "10-14"
-        }
-    ]
-
-    for i, factor in enumerate(example_factors, 1):
-        logger.info(f"\nFaktor {i}: {factor['name']}")
-        logger.info(f"  Hypothese: {factor['hypothesis']}")
-        logger.info(f"  ARR: {factor['arr']}")
-        logger.info(f"  Sharpe: {factor['sharpe']}")
-        logger.info(f"  IC: {factor['ic']}")
-        logger.info(f"  Max DD: {factor['max_dd']}")
-        logger.info(f"  Trades/Tag: {factor['trades_per_day']}")
-
-    logger.info("-" * 60)
-    logger.info(f"Fertig! {len(example_factors)} Faktoren generiert.")
-    logger.info(f"Ergebnisse gespeichert in: RD-Agent_workspace/")
-    logger.info("-" * 60)
-
-    # Nächste Schritte
-    logger.info("\nNächste Schritte:")
-    logger.info("  1. Faktoren begutachten: ls RD-Agent_workspace/")
-    logger.info("  2. Faktoren optimieren: python examples/02_factor_evolution.py")
-    logger.info("  3. Strategie bauen: python examples/03_strategy_generation.py")
-
-
-def main():
-    """Hauptfunktion mit Argument-Parsing."""
-    parser = argparse.ArgumentParser(
-        description="Beispiel 01: Automatische Faktor-Generierung mit LLM",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Beispiele:
-  # 3 Loops mit lokalem LLM
-  python 01_factor_discovery.py --loop-n 3 --llm local
-  
-  # 10 Loops mit OpenAI API
-  python 01_factor_discovery.py --loop-n 10 --llm openai
-  
-  # Testing ohne Git-Checkout
-  python 01_factor_discovery.py --loop-n 1 --skip-checkout
-        """
-    )
-
-    parser.add_argument(
-        "--loop-n",
-        type=int,
-        default=3,
-        help="Anzahl der Evolutions-Loops (default: 3)"
-    )
-    parser.add_argument(
-        "--llm",
-        type=str,
-        choices=["local", "openai", "anthropic"],
-        default="local",
-        help="LLM-Modell für Generierung (default: local)"
-    )
-    parser.add_argument(
-        "--skip-checkout",
-        action="store_true",
-        help="Git checkout überspringen (für Testing)"
-    )
-
-    args = parser.parse_args()
-
-    try:
-        run_factor_discovery(
-            loop_n=args.loop_n,
-            llm_model=args.llm,
-            skip_checkout=args.skip_checkout
-        )
-    except KeyboardInterrupt:
-        logger.warning("\nAbgebrochen durch Benutzer.")
-        sys.exit(130)
-    except Exception as e:
-        logger.error(f"Fehler bei der Faktor-Generierung: {e}")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

examples/02_factor_evolution.py

@@ -1,254 +0,0 @@
-#!/usr/bin/env python
-"""
-Beispiel 02: Factor Evolution - Bestehende Faktoren optimieren
-
-Was macht dieses Beispiel?
-    Dieses Skript zeigt, wie man bestehende Trading-Faktoren durch Hinzufügen
-    von Session-Filtern, Regime-Filtern und anderen Techniken verbessert.
-    
-    Verbesserungstechniken:
-    1. Session-Filter (London/NY nur) - 73% Erfolgsrate
-    2. Regime-Filter (ADX-basiert) - 65% Erfolgsrate
-    3. Lookback-Optimierung - 58% Erfolgsrate
-    4. Kombination mit komplementären Faktoren - 69% Erfolgsrate
-
-Voraussetzungen:
-    - Mindestens ein generierter Faktor vorhanden (aus Beispiel 01)
-    - EURUSD 1-Minute Daten in Qlib geladen
-
-Erwartete Laufzeit:
-    ~15-20 Minuten pro Faktor
-
-Output:
-    - Optimierte Faktoren mit Before/After-Vergleich
-    - Metrik-Verbesserungen (ARR +X%, Sharpe +X.X)
-    - Implementierter Code für optimierte Faktoren
-"""
-
-import argparse
-import logging
-import sys
-
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s | %(levelname)-8s | %(message)s',
-    datefmt='%Y-%m-%d %H:%M:%S'
-)
-logger = logging.getLogger(__name__)
-
-
-# Beispiel-Faktor (wie aus Beispiel 01 generiert)
-EXAMPLE_FACTOR = {
-    "name": "momentum_16",
-    "code": """
-def calculate_momentum_16():
-    df = pd.read_hdf("intraday_pv.h5", key="data")
-    close = df['$close'].unstack(level='instrument')
-    momentum = close.pct_change(16)
-    result = momentum.stack(level='instrument')
-    factor_df = pd.DataFrame({'momentum_16': result}, index=df.index)
-    factor_df.to_hdf("result.h5", key="data", mode="w")
-""",
-    "metrics": {
-        "arr": "8.2%",
-        "sharpe": 1.3,
-        "ic": 0.054,
-        "max_dd": "12.4%",
-        "trades_per_day": 14,
-        "win_rate": "52%"
-    }
-}
-
-
-def improve_with_session_filter(factor: dict) -> dict:
-    """
-    Verbesserung: Session-Filter hinzufügen.
-    
-    Erfolgsrate: 73% (aus 11 getesteten Faktoren)
-    Durchschnittliche Verbesserung:
-      ARR: +2.8%
-      Sharpe: +0.31
-      Max-DD: -3.2%
-    """
-    improved = factor.copy()
-    improved["improvement_type"] = "session_filter"
-    improved["improvement_desc"] = "London-Session-Filter hinzugefügt (08:00-16:00 UTC)"
-    improved["improved_code"] = """
-def calculate_momentum_16_london():
-    df = pd.read_hdf("intraday_pv.h5", key="data")
-    close = df['$close'].unstack(level='instrument')
-    
-    # 16-bar momentum
-    momentum = close.pct_change(16)
-    
-    # Session-Filter: Nur London-Session (08:00-16:00 UTC)
-    hour = close.index.hour
-    london_mask = (hour >= 8) & (hour < 16)
-    momentum = momentum.where(london_mask, np.nan)
-    
-    # Stack back to MultiIndex
-    result = momentum.stack(level='instrument')
-    factor_df = pd.DataFrame({'momentum_16_london': result}, index=df.index)
-    factor_df.to_hdf("result.h5", key="data", mode="w")
-"""
-    improved["improved_metrics"] = {
-        "arr": "11.0%",
-        "sharpe": 1.6,
-        "ic": 0.071,
-        "max_dd": "9.2%",
-        "trades_per_day": 8,
-        "win_rate": "56%"
-    }
-    return improved
-
-
-def improve_with_regime_filter(factor: dict) -> dict:
-    """
-    Verbesserung: Regime-Filter (ADX-basiert) hinzufügen.
-    
-    Erfolgsrate: 65% (aus 8 getesteten Faktoren)
-    Durchschnittliche Verbesserung:
-      Sharpe: +0.34
-    """
-    improved = factor.copy()
-    improved["improvement_type"] = "regime_filter"
-    improved["improvement_desc"] = "ADX-Regime-Filter: Nur trending wenn ADX > 1.2"
-    improved["improved_code"] = """
-def calculate_momentum_16_adx():
-    df = pd.read_hdf("intraday_pv.h5", key="data")
-    close = df['$close'].unstack(level='instrument')
-    high = df['$high'].unstack(level='instrument')
-    low = df['$low'].unstack(level='instrument')
-    
-    # 16-bar momentum
-    momentum = close.pct_change(16)
-    
-    # ADX-Proxy: Short-term vs Long-term Volatility Ratio
-    hl_range = (high - low) / close
-    atr_short = hl_range.rolling(14).mean()
-    atr_long = hl_range.rolling(42).mean()
-    adx_proxy = atr_short / (atr_long + 1e-8)
-    
-    # Regime-Filter: Nur wenn trending (ADX > 1.2)
-    is_trending = adx_proxy > 1.2
-    momentum = momentum.where(is_trending, np.nan)
-    
-    result = momentum.stack(level='instrument')
-    factor_df = pd.DataFrame({'momentum_16_adx': result}, index=df.index)
-    factor_df.to_hdf("result.h5", key="data", mode="w")
-"""
-    improved["improved_metrics"] = {
-        "arr": "10.5%",
-        "sharpe": 1.7,
-        "ic": 0.068,
-        "max_dd": "8.8%",
-        "trades_per_day": 9,
-        "win_rate": "58%"
-    }
-    return improved
-
-
-def run_factor_evolution(factor_name: str, improvement_type: str) -> None:
-    """
-    Führt die Faktor-Optimierung aus.
-
-    Args:
-        factor_name: Name des zu optimierenden Faktors
-        improvement_type: Art der Verbesserung ('session_filter', 'regime_filter', 'both')
-    """
-    logger.info("=" * 60)
-    logger.info("PREDIX Factor Evolution - Beispiel 02")
-    logger.info("=" * 60)
-    logger.info(f"Faktor: {factor_name}")
-    logger.info(f"Verbesserung: {improvement_type}")
-    logger.info("=" * 60)
-
-    # Zeige Original-Faktor
-    logger.info("\nORIGINAL FAKTOR:")
-    logger.info(f"  Name: {EXAMPLE_FACTOR['name']}")
-    logger.info(f"  ARR: {EXAMPLE_FACTOR['metrics']['arr']}")
-    logger.info(f"  Sharpe: {EXAMPLE_FACTOR['metrics']['sharpe']}")
-    logger.info(f"  IC: {EXAMPLE_FACTOR['metrics']['ic']}")
-    logger.info(f"  Max DD: {EXAMPLE_FACTOR['metrics']['max_dd']}")
-
-    # Wende Verbesserungen an
-    logger.info("\n" + "-" * 60)
-    logger.info("VERBESSERUNGEN")
-    logger.info("-" * 60)
-
-    if improvement_type in ["session_filter", "both"]:
-        improved_session = improve_with_session_filter(EXAMPLE_FACTOR)
-        logger.info(f"\n✓ Session-Filter angewendet:")
-        logger.info(f"  Typ: {improved_session['improvement_desc']}")
-        logger.info(f"  ARR: {EXAMPLE_FACTOR['metrics']['arr']} → {improved_session['improved_metrics']['arr']}")
-        logger.info(f"  Sharpe: {EXAMPLE_FACTOR['metrics']['sharpe']} → {improved_session['improved_metrics']['sharpe']}")
-        logger.info(f"  Max DD: {EXAMPLE_FACTOR['metrics']['max_dd']} → {improved_session['improved_metrics']['max_dd']}")
-
-    if improvement_type in ["regime_filter", "both"]:
-        improved_regime = improve_with_regime_filter(EXAMPLE_FACTOR)
-        logger.info(f"\n✓ Regime-Filter angewendet:")
-        logger.info(f"  Typ: {improved_regime['improvement_desc']}")
-        logger.info(f"  ARR: {EXAMPLE_FACTOR['metrics']['arr']} → {improved_regime['improved_metrics']['arr']}")
-        logger.info(f"  Sharpe: {EXAMPLE_FACTOR['metrics']['sharpe']} → {improved_regime['improved_metrics']['sharpe']}")
-        logger.info(f"  Max DD: {EXAMPLE_FACTOR['metrics']['max_dd']} → {improved_regime['improved_metrics']['max_dd']}")
-
-    # Zusammenfassung
-    logger.info("\n" + "=" * 60)
-    logger.info("ZUSAMMENFASSUNG")
-    logger.info("=" * 60)
-    logger.info(f"Beste Verbesserung: {improvement_type}")
-    logger.info(f"Ergebnisse gespeichert in: RD-Agent_workspace/")
-    logger.info("\nNächste Schritte:")
-    logger.info("  1. Optimierten Faktor begutachten: cat RD-Agent_workspace/evolved_factor.py")
-    logger.info("  2. Strategie bauen: python examples/03_strategy_generation.py")
-
-
-def main():
-    """Hauptfunktion mit Argument-Parsing."""
-    parser = argparse.ArgumentParser(
-        description="Beispiel 02: Faktor-Optimierung mit Filtern",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Beispiele:
-  # Session-Filter anwenden
-  python 02_factor_evolution.py --factor momentum_16 --improve session_filter
-  
-  # Regime-Filter anwenden
-  python 02_factor_evolution.py --factor momentum_16 --improve regime_filter
-  
-  # Beide Filter kombinieren
-  python 02_factor_evolution.py --factor momentum_16 --improve both
-        """
-    )
-
-    parser.add_argument(
-        "--factor",
-        type=str,
-        default="momentum_16",
-        help="Name des zu optimierenden Faktors (default: momentum_16)"
-    )
-    parser.add_argument(
-        "--improve",
-        type=str,
-        choices=["session_filter", "regime_filter", "both"],
-        default="both",
-        help="Art der Verbesserung (default: both)"
-    )
-
-    args = parser.parse_args()
-
-    try:
-        run_factor_evolution(
-            factor_name=args.factor,
-            improvement_type=args.improve
-        )
-    except KeyboardInterrupt:
-        logger.warning("\nAbgebrochen durch Benutzer.")
-        sys.exit(130)
-    except Exception as e:
-        logger.error(f"Fehler bei der Faktor-Evolution: {e}")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

examples/03_strategy_generation.py

@@ -1,190 +0,0 @@
-#!/usr/bin/env python
-"""
-Beispiel 03: Strategy Generation - Faktoren zu Strategien kombinieren
-
-Was macht dieses Beispiel?
-    Dieses Skript zeigt, wie man mehrere Trading-Faktoren zu einer robusten
-    Strategie kombiniert. Dabei wird die IC-weighted Combination verwendet,
-    die Faktoren nach ihrer prädiktiven Kraft (Information Coefficient) gewichtet.
-    
-    WICHTIG: Faktoren mit negativem IC müssen invertiert werden!
-
-Voraussetzungen:
-    - Mindestens 2-3 generierte Faktoren (aus Beispiel 01)
-    - Faktoren sollten unkorreliert sein (Korrelation < 0.6)
-
-Erwartete Laufzeit:
-    ~3-5 Minuten
-
-Output:
-    - IC-weighted Faktor-Kombination
-    - Signal-Verteilung (Long/Short/Neutral)
-    - Composite Signal Code
-"""
-
-import argparse
-import logging
-import sys
-
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s | %(levelname)-8s | %(message)s',
-    datefmt='%Y-%m-%d %H:%M:%S'
-)
-logger = logging.getLogger(__name__)
-
-
-def run_strategy_generation(factors: list, use_ai: bool = False) -> None:
-    """
-    Kombiniert Faktoren zu einer Strategie.
-
-    Args:
-        factors: Liste der Faktor-Namen
-        use_ai: KI-gestützte Strategiegenerierung (StrategyCoSTEER)
-    """
-    logger.info("=" * 60)
-    logger.info("PREDIX Strategy Generation - Beispiel 03")
-    logger.info("=" * 60)
-    logger.info(f"Faktoren: {', '.join(factors)}")
-    logger.info(f"KI-gestützt: {use_ai}")
-    logger.info("=" * 60)
-
-    # Beispiel-Faktoren mit IC-Werten
-    example_factors_data = {
-        "momentum_16": {
-            "ic": 0.074,
-            "sharpe": 1.6,
-            "arr": "10.2%",
-            "type": "trend_following"
-        },
-        "hl_range_reversal": {
-            "ic": -0.065,
-            "sharpe": 1.4,
-            "arr": "8.5%",
-            "type": "mean_reversion"
-        },
-        "session_alpha": {
-            "ic": 0.082,
-            "sharpe": 1.8,
-            "arr": "11.8%",
-            "type": "session_timing"
-        }
-    }
-
-    # IC-Weights berechnen (negative IC invertieren!)
-    logger.info("\nFAKTOR-ANALYSE:")
-    logger.info("-" * 60)
-    
-    total_abs_ic = 0
-    for factor_name in factors:
-        if factor_name in example_factors_data:
-            data = example_factors_data[factor_name]
-            logger.info(f"  {factor_name}:")
-            logger.info(f"    IC: {data['ic']}")
-            logger.info(f"    Typ: {data['type']}")
-            logger.info(f"    Sharpe: {data['sharpe']}")
-            total_abs_ic += abs(data['ic'])
-
-    # Normalize weights
-    logger.info("\nIC-WEIGHTED COMBINATION:")
-    logger.info("-" * 60)
-    
-    weights = {}
-    for factor_name in factors:
-        if factor_name in example_factors_data:
-            ic = example_factors_data[factor_name]['ic']
-            # Negative IC invertieren
-            weight = ic / total_abs_ic
-            weights[factor_name] = weight
-            logger.info(f"  {factor_name}: {weight:.3f} (IC: {ic})")
-
-    # Strategie-Code generieren
-    strategy_code = f"""
-import pandas as pd
-import numpy as np
-
-# UNSTACK für cross-sectionale Operationen
-factor_matrix = factors.unstack(level='instrument')
-
-# Rolling Z-Score Normalisierung (Window=20)
-z = (factor_matrix - factor_matrix.rolling(20).mean()) / (factor_matrix.rolling(20).std() + 1e-8)
-
-# IC-weighted Combination (negative IC invertiert!)
-composite = ({weights.get('momentum_16', 0):.3f} * z['momentum_16']
-             {weights.get('hl_range_reversal', 0):+.3f} * z['hl_range_reversal']
-             {weights.get('session_alpha', 0):+.3f} * z['session_alpha'])
-
-# STACK back zu MultiIndex
-composite = composite.stack(level='instrument')
-
-# Signal-Generierung mit Thresholds
-signal = pd.Series(0, index=factors.index)
-signal[composite > 0.5] = 1   # LONG
-signal[composite < -0.5] = -1  # SHORT
-signal.name = 'signal'
-"""
-
-    logger.info("\nSTRATEGIE-CODE:")
-    logger.info("-" * 60)
-    logger.info(strategy_code)
-
-    # Erwartete Performance
-    logger.info("\nERWARTETE PERFORMANCE:")
-    logger.info("-" * 60)
-    logger.info("  ARR: 12-15%")
-    logger.info("  Sharpe: 2.0-2.4")
-    logger.info("  Max DD: 7-9%")
-    logger.info("  Trades/Tag: 10-14")
-    logger.info("  Win Rate: 55-58%")
-
-    logger.info("\n" + "=" * 60)
-    logger.info("FERTIG!")
-    logger.info("=" * 60)
-    logger.info("Strategie gespeichert in: RD-Agent_workspace/strategy.py")
-    logger.info("\nNächste Schritte:")
-    logger.info("  1. Backtest durchführen: python examples/04_backtest_simple.py")
-    logger.info("  2. Strategie optimieren: rdagent build_strategies_ai")
-
-
-def main():
-    """Hauptfunktion mit Argument-Parsing."""
-    parser = argparse.ArgumentParser(
-        description="Beispiel 03: Faktoren zu Strategie kombinieren",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Beispiele:
-  # 3 Faktoren kombinieren
-  python 03_strategy_generation.py --factors momentum_16,hl_range_reversal,session_alpha
-  
-  # Mit KI-gestützter Generierung
-  python 03_strategy_generation.py --factors momentum_16,session_alpha --ai
-        """
-    )
-
-    parser.add_argument(
-        "--factors",
-        type=str,
-        default="momentum_16,hl_range_reversal,session_alpha",
-        help="Kommagetrennte Liste der Faktoren (default: momentum_16,hl_range_reversal,session_alpha)"
-    )
-    parser.add_argument(
-        "--ai",
-        action="store_true",
-        help="KI-gestützte Strategiegenerierung (StrategyCoSTEER)"
-    )
-
-    args = parser.parse_args()
-    factors = [f.strip() for f in args.factors.split(',')]
-
-    try:
-        run_strategy_generation(factors=factors, use_ai=args.ai)
-    except KeyboardInterrupt:
-        logger.warning("\nAbgebrochen durch Benutzer.")
-        sys.exit(130)
-    except Exception as e:
-        logger.error(f"Fehler bei der Strategie-Generierung: {e}")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

examples/04_backtest_simple.py

@@ -1,280 +0,0 @@
-#!/usr/bin/env python
-"""
-Beispiel 04: Backtest - Trading-Strategie auf historischen Daten testen
-
-Was macht dieses Beispiel?
-    Dieses Skript führt einen Backtest einer Trading-Strategie auf historischen
-    EUR/USD 1-Minute Daten durch. Es berechnet Key-Metriiken wie ARR, Sharpe,
-    Max Drawdown, Win Rate und zeigt die Equity-Kurve.
-
-Voraussetzungen:
-    - EURUSD 1-Minute Daten in Qlib geladen
-    - Strategie-File vorhanden (aus Beispiel 03 oder eigenem Code)
-
-Erwartete Laufzeit:
-    ~2-5 Minuten (abhä  ngig vom Datenzeitraum)
-
-Output:
-    - Key-Metriiken: ARR, Sharpe, MaxDD, WinRate, Profit Factor
-    - Trade-Statistik (Anzahl Trades, avg Hold Time)
-    - Equity Curve (optional als Plotly Chart)
-"""
-
-import argparse
-import logging
-import sys
-from datetime import datetime
-
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s | %(levelname)-8s | %(message)s',
-    datefmt='%Y-%m-%d %H:%M:%S'
-)
-logger = logging.getLogger(__name__)
-
-
-def run_backtest(strategy: str, start_date: str, end_date: str, plot: bool = False) -> None:
-    """
-    Führt den Backtest aus.
-
-    Args:
-        strategy: Strategie-Name ('momentum', 'reversal', 'combined', oder eigener Pfad)
-        start_date: Startdatum (YYYY-MM-DD)
-        end_date: Enddatum (YYYY-MM-DD)
-        plot: Equity Curve als Plotly Chart anzeigen
-    """
-    logger.info("=" * 60)
-    logger.info("PREDIX Backtest - Beispiel 04")
-    logger.info("=" * 60)
-    logger.info(f"Strategie: {strategy}")
-    logger.info(f"Zeitraum: {start_date} bis {end_date}")
-    logger.info(f"Plot anzeigen: {plot}")
-    logger.info("=" * 60)
-
-    # Simulierter Backtest (in Produktion: Echte Backtest-Engine)
-    logger.info("\nLade Daten...")
-    logger.info(f"  Instrument: EURUSD")
-    logger.info(f"  Zeitrahmen: 1 Minute")
-    logger.info(f"  Von: {start_date}")
-    logger.info(f"  Bis: {end_date}")
-
-    logger.info("\nStarte Backtest...")
-
-    # Beispiel-Ergebnisse (simuliert)
-    results = {
-        "momentum": {
-            "arr": "12.4%",
-            "sharpe": 2.1,
-            "max_dd": "8.3%",
-            "win_rate": "56.2%",
-            "profit_factor": 1.8,
-            "total_trades": 4521,
-            "trades_per_day": 12,
-            "avg_hold_time": "24 min",
-            "avg_win": "0.00042",
-            "avg_loss": "-0.00031",
-            "best_trade": "0.00187",
-            "worst_trade": "-0.00142",
-            "consecutive_wins": 12,
-            "consecutive_losses": 5,
-            "calmar_ratio": 1.49,
-            "sortino_ratio": 2.8
-        },
-        "reversal": {
-            "arr": "9.8%",
-            "sharpe": 1.7,
-            "max_dd": "11.2%",
-            "win_rate": "61.3%",
-            "profit_factor": 1.6,
-            "total_trades": 3210,
-            "trades_per_day": 8,
-            "avg_hold_time": "18 min",
-            "avg_win": "0.00035",
-            "avg_loss": "-0.00028",
-            "best_trade": "0.00124",
-            "worst_trade": "-0.00098",
-            "consecutive_wins": 15,
-            "consecutive_losses": 4,
-            "calmar_ratio": 0.87,
-            "sortino_ratio": 2.2
-        },
-        "combined": {
-            "arr": "14.2%",
-            "sharpe": 2.3,
-            "max_dd": "7.8%",
-            "win_rate": "58.1%",
-            "profit_factor": 1.9,
-            "total_trades": 5180,
-            "trades_per_day": 14,
-            "avg_hold_time": "22 min",
-            "avg_win": "0.00048",
-            "avg_loss": "-0.00029",
-            "best_trade": "0.00201",
-            "worst_trade": "-0.00118",
-            "consecutive_wins": 14,
-            "consecutive_losses": 4,
-            "calmar_ratio": 1.82,
-            "sortino_ratio": 3.1
-        }
-    }
-
-    if strategy not in results:
-        logger.warning(f"Strategie '{strategy}' nicht gefunden. Verwende 'combined' als Default.")
-        strategy = "combined"
-
-    r = results[strategy]
-
-    # Ergebnisse anzeigen
-    logger.info("\n" + "=" * 60)
-    logger.info("BACKTEST ERGEBNISSE")
-    logger.info("=" * 60)
-
-    logger.info("\n📊 KEY-METRIKEN:")
-    logger.info(f"  ARR (Annualized Return):  {r['arr']}")
-    logger.info(f"  Sharpe Ratio:             {r['sharpe']}")
-    logger.info(f"  Sortino Ratio:            {r['sortino_ratio']}")
-    logger.info(f"  Calmar Ratio:             {r['calmar_ratio']}")
-    logger.info(f"  Max Drawdown:             {r['max_dd']}")
-    logger.info(f"  Profit Factor:            {r['profit_factor']}")
-
-    logger.info("\n📈 TRADE-STATISTIK:")
-    logger.info(f"  Total Trades:             {r['total_trades']}")
-    logger.info(f"  Trades/Tag:               {r['trades_per_day']}")
-    logger.info(f"  Win Rate:                 {r['win_rate']}")
-    logger.info(f"  Avg Hold Time:            {r['avg_hold_time']}")
-    logger.info(f"  Avg Win:                  {r['avg_win']}")
-    logger.info(f"  Avg Loss:                 {r['avg_loss']}")
-
-    logger.info("\n🏆 EXTREME:")
-    logger.info(f"  Best Trade:               {r['best_trade']}")
-    logger.info(f"  Worst Trade:              {r['worst_trade']}")
-    logger.info(f"  Consecutive Wins:         {r['consecutive_wins']}")
-    logger.info(f"  Consecutive Losses:       {r['consecutive_losses']}")
-
-    # Bewertung
-    logger.info("\n" + "-" * 60)
-    logger.info("BEWERTUNG:")
-    logger.info("-" * 60)
-
-    sharpe = r['sharpe']
-    if sharpe >= 2.0:
-        logger.info("  ✅ Sharpe > 2.0: Ausgezeichnete risikobereinigte Rendite")
-    elif sharpe >= 1.5:
-        logger.info("  ✓ Sharpe > 1.5: Gute risikobereinigte Rendite")
-    elif sharpe >= 1.0:
-        logger.info("  ⚠ Sharpe > 1.0: Akzeptabel, aber verbesserungsfä  hig")
-    else:
-        logger.info("  ❌ Sharpe < 1.0: Zu riskant für die Rendite")
-
-    max_dd = float(r['max_dd'].replace('%', ''))
-    if max_dd < 10:
-        logger.info("  ✅ Max DD < 10%: Gutes Risikomanagement")
-    elif max_dd < 15:
-        logger.info("  ✓ Max DD < 15%: Akzeptabel")
-    else:
-        logger.info("  ⚠ Max DD > 15%: Hohes Drawdown-Risiko")
-
-    # Plot (optional)
-    if plot:
-        logger.info("\n📊 Equity Curve wird generiert...")
-        try:
-            import plotly.graph_objects as go
-            import numpy as np
-
-            # Simulierte Equity Curve
-            np.random.seed(42)
-            days = 252 * 5  # 5 Jahre
-            daily_returns = np.random.normal(0.0005, 0.008, days)
-            equity = np.cumprod(1 + daily_returns)
-
-            fig = go.Figure()
-            fig.add_trace(go.Scatter(
-                x=list(range(days)),
-                y=equity,
-                mode='lines',
-                name='Equity',
-                line=dict(color='#2E86AB', width=2)
-            ))
-            fig.update_layout(
-                title='PREDIX Backtest - Equity Curve',
-                xaxis_title='Trading Days',
-                yaxis_title='Portfolio Value',
-                template='plotly_dark',
-                height=500
-            )
-            fig.write_html('equity_curve.html')
-            logger.info("  ✅ Equity Curve gespeichert: equity_curve.html")
-        except ImportError:
-            logger.warning("  ⚠ Plotly nicht installiert: pip install plotly")
-
-    logger.info("\n" + "=" * 60)
-    logger.info("FERTIG!")
-    logger.info("=" * 60)
-    logger.info("\nNächste Schritte:")
-    logger.info("  1. Strategie optimieren: python examples/05_model_training.py")
-    logger.info("  2. RL Agent trainieren: python examples/06_rl_trading_agent.py")
-    logger.info("  3. Live Trading: rdagent quant --live")
-
-
-def main():
-    """Hauptfunktion mit Argument-Parsing."""
-    parser = argparse.ArgumentParser(
-        description="Beispiel 04: Backtest einer Trading-Strategie",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Beispiele:
-  # Momentum-Strategie testen
-  python 04_backtest_simple.py --strategy momentum
-  
-  # Kombinierte Strategie mit Plot
-  python 04_backtest_simple.py --strategy combined --plot
-  
-  # Eigener Zeitraum
-  python 04_backtest_simple.py --strategy momentum --start 2022-01-01 --end 2025-12-31
-        """
-    )
-
-    parser.add_argument(
-        "--strategy",
-        type=str,
-        choices=["momentum", "reversal", "combined"],
-        default="combined",
-        help="Strategie-Name (default: combined)"
-    )
-    parser.add_argument(
-        "--start",
-        type=str,
-        default="2020-01-01",
-        help="Startdatum YYYY-MM-DD (default: 2020-01-01)"
-    )
-    parser.add_argument(
-        "--end",
-        type=str,
-        default="2025-12-31",
-        help="Enddatum YYYY-MM-DD (default: 2025-12-31)"
-    )
-    parser.add_argument(
-        "--plot",
-        action="store_true",
-        help="Equity Curve als Plotly Chart anzeigen"
-    )
-
-    args = parser.parse_args()
-
-    try:
-        run_backtest(
-            strategy=args.strategy,
-            start_date=args.start,
-            end_date=args.end,
-            plot=args.plot
-        )
-    except KeyboardInterrupt:
-        logger.warning("\nAbgebrochen durch Benutzer.")
-        sys.exit(130)
-    except Exception as e:
-        logger.error(f"Fehler beim Backtest: {e}")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

examples/05_model_training.py

@@ -1,316 +0,0 @@
-#!/usr/bin/env python
-"""
-Beispiel 05: Model Training - ML-Modell (LSTM/XGBoost) trainieren
-
-Was macht dieses Beispiel?
-    Dieses Skript trainiert ein ML-Modell auf Faktor-Daten für EUR/USD
-    Vorhersagen. Es unterstützt LSTM (Deep Learning) und XGBoost (Gradient Boosting).
-    
-    Der Workflow umfasst:
-    1. Daten laden & Features engineering (MultiIndex-safe)
-    2. Temporale Train/Val/Test Split (KEIN Shuffle!)
-    3. Modell-Training mit Early Stopping
-    4. Evaluation auf Test-Set
-    5. Modell speichern
-
-Voraussetzungen:
-    - Generierte Faktoren vorhanden (aus Beispiel 01)
-    - Für LSTM: PyTorch installiert (`pip install torch`)
-    - Für XGBoost: XGBoost installiert (`pip install xgboost`)
-
-Erwartete Laufzeit:
-    XGBoost: ~5-10 Minuten
-    LSTM: ~20-40 Minuten (CPU), ~5-10 Minuten (GPU)
-
-Output:
-    - Trainiertes Modell in models/
-    - Train/Val/Test Ergebnisse
-    - Feature Importance (bei XGBoost)
-"""
-
-import argparse
-import logging
-import sys
-from pathlib import Path
-
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s | %(levelname)-8s | %(message)s',
-    datefmt='%Y-%m-%d %H:%M:%S'
-)
-logger = logging.getLogger(__name__)
-
-
-def train_xgboost(features: list, target: str) -> dict:
-    """
-    Trainiert XGBoost-Modell.
-
-    Args:
-        features: Liste der Feature-Namen
-        target: Target-Variable ('fwd_sign_4', 'fwd_ret_4')
-
-    Returns:
-        Dictionary mit Trainings-Ergebnissen
-    """
-    logger.info("Starte XGBoost Training...")
-
-    # Beispiel-Code (in Produktion: Echte Implementierung)
-    training_code = """
-import pandas as pd
-import numpy as np
-from xgboost import XGBClassifier
-from sklearn.metrics import accuracy_score, classification_report
-
-# 1. Daten laden (MultiIndex-safe)
-df = pd.read_hdf("intraday_pv.h5", key="data")
-close = df['$close'].unstack(level='instrument')
-
-# 2. Features erstellen
-features = pd.DataFrame(index=close.index)
-features['ret_8'] = close.pct_change(8)
-features['ret_16'] = close.pct_change(16)
-features['ret_96'] = close.pct_change(96)
-features['hl_range'] = (df['$high'].unstack() - df['$low'].unstack()) / close
-features = features.fillna(0)
-
-# 3. Target: Forward 4-bar direction
-fwd_ret_4 = close.shift(-4) / close - 1
-target = (fwd_ret_4 > 0).astype(int)
-
-# 4. Temporale Split (KEIN Shuffle!)
-train_end = '2024-01-01'
-val_end = '2024-06-01'
-
-train_mask = features.index < train_end
-val_mask = (features.index >= train_end) & (features.index < val_end)
-test_mask = features.index >= val_end
-
-# 5. Modell trainieren
-model = XGBClassifier(
-    max_depth=4,
-    learning_rate=0.05,
-    n_estimators=200,
-    subsample=0.8,
-    colsample_bytree=0.8,
-    min_child_weight=5,
-    eval_metric='logloss',
-    early_stopping_rounds=10
-)
-
-model.fit(
-    features[train_mask], target[train_mask],
-    eval_set=[(features[val_mask], target[val_mask])],
-    verbose=False
-)
-
-# 6. Evaluation
-y_pred = model.predict(features[test_mask])
-accuracy = accuracy_score(target[test_mask], y_pred)
-print(f"Test Accuracy: {accuracy:.4f}")
-
-# 7. Feature Importance
-importance = model.feature_importances_
-for feat, imp in zip(features.columns, importance):
-    print(f"  {feat}: {imp:.4f}")
-
-# 8. Speichern
-import joblib
-joblib.dump(model, 'models/xgboost_model.pkl')
-"""
-
-    # Simulierte Ergebnisse (aus 8 echten Läufen)
-    results = {
-        "model_type": "XGBoost",
-        "accuracy": "56.1%",
-        "sharpe": 1.5,
-        "arr": "9.8%",
-        "ic": 0.067,
-        "max_dd": "9.7%",
-        "feature_importance": {
-            "ret_16": 0.28,
-            "ret_96": 0.22,
-            "hl_range": 0.18,
-            "ret_8": 0.17,
-            "rsi_14": 0.15
-        },
-        "training_time": "4 min 32 sec",
-        "model_path": "models/xgboost_model.pkl"
-    }
-
-    logger.info(f"\n{'='*60}")
-    logger.info("XGBOOST TRAINING ERGEBNISSE")
-    logger.info(f"{'='*60}")
-
-    logger.info(f"\n📊 MODEL:")
-    logger.info(f"  Typ: {results['model_type']}")
-    logger.info(f"  Target: {target}")
-    logger.info(f"  Features: {', '.join(features)}")
-
-    logger.info(f"\n🎯 TEST ERGEBNISSE:")
-    logger.info(f"  Accuracy: {results['accuracy']}")
-    logger.info(f"  Sharpe: {results['sharpe']}")
-    logger.info(f"  ARR: {results['arr']}")
-    logger.info(f"  IC: {results['ic']}")
-    logger.info(f"  Max DD: {results['max_dd']}")
-
-    logger.info(f"\n🔧 FEATURE IMPORTANCE:")
-    for feat, imp in results['feature_importance'].items():
-        bar = "█" * int(imp * 40)
-        logger.info(f"  {feat:12s}: {imp:.4f} {bar}")
-
-    logger.info(f"\n⏱️  TRAINING:")
-    logger.info(f"  Dauer: {results['training_time']}")
-    logger.info(f"  Modell: {results['model_path']}")
-
-    return results
-
-
-def train_lstm(features: list, target: str) -> dict:
-    """
-    Trainiert LSTM-Modell.
-
-    Args:
-        features: Liste der Feature-Namen
-        target: Target-Variable
-
-    Returns:
-        Dictionary mit Trainings-Ergebnissen
-    """
-    logger.info("Starte LSTM Training...")
-
-    # Simulierte Ergebnisse (aus 12 echten Läufen)
-    results = {
-        "model_type": "LSTM",
-        "seq_len": 96,
-        "hidden_size": 128,
-        "num_layers": 2,
-        "accuracy": "58.2%",
-        "sharpe": 1.8,
-        "arr": "12.1%",
-        "ic": 0.074,
-        "max_dd": "8.3%",
-        "epochs_trained": 23,
-        "early_stop_patience": 5,
-        "training_time": "18 min 45 sec",
-        "model_path": "models/lstm_model.pth"
-    }
-
-    logger.info(f"\n{'='*60}")
-    logger.info("LSTM TRAINING ERGEBNISSE")
-    logger.info(f"{'='*60}")
-
-    logger.info(f"\n📊 MODEL ARCHITEKTUR:")
-    logger.info(f"  Typ: {results['model_type']}")
-    logger.info(f"  Sequence Length: {results['seq_len']} bars")
-    logger.info(f"  Hidden Size: {results['hidden_size']}")
-    logger.info(f"  Layers: {results['num_layers']}")
-    logger.info(f"  Target: {target}")
-    logger.info(f"  Features: {', '.join(features)}")
-
-    logger.info(f"\n🎯 TEST ERGEBNISSE:")
-    logger.info(f"  Accuracy: {results['accuracy']}")
-    logger.info(f"  Sharpe: {results['sharpe']}")
-    logger.info(f"  ARR: {results['arr']}")
-    logger.info(f"  IC: {results['ic']}")
-    logger.info(f"  Max DD: {results['max_dd']}")
-
-    logger.info(f"\n⏱️  TRAINING:")
-    logger.info(f"  Epochs: {results['epochs_trained']} (Early Stop nach {results['early_stop_patience']} Patience)")
-    logger.info(f"  Dauer: {results['training_time']}")
-    logger.info(f"  Modell: {results['model_path']}")
-
-    return results
-
-
-def run_model_training(model_type: str, features: list, target: str) -> None:
-    """
-    Führt das Modell-Training aus.
-
-    Args:
-        model_type: 'xgboost' oder 'lstm'
-        features: Liste der Feature-Namen
-        target: Target-Variable
-    """
-    logger.info("=" * 60)
-    logger.info("PREDIX Model Training - Beispiel 05")
-    logger.info("=" * 60)
-    logger.info(f"Modell: {model_type}")
-    logger.info(f"Features: {', '.join(features)}")
-    logger.info(f"Target: {target}")
-    logger.info("=" * 60)
-
-    if model_type == "xgboost":
-        train_xgboost(features, target)
-    elif model_type == "lstm":
-        train_lstm(features, target)
-    else:
-        logger.error(f"Unbekannter Modell-Typ: {model_type}")
-        sys.exit(1)
-
-    logger.info("\n" + "=" * 60)
-    logger.info("FERTIG!")
-    logger.info("=" * 60)
-    logger.info("\nNächste Schritte:")
-    logger.info("  1. Modell evaluieren: rdagent evaluate --model models/{model_type}_model.*")
-    logger.info("  2. RL Agent trainieren: python examples/06_rl_trading_agent.py")
-    logger.info("  3. Live Trading: rdagent quant --live --model models/{model_type}_model.*")
-
-
-def main():
-    """Hauptfunktion mit Argument-Parsing."""
-    parser = argparse.ArgumentParser(
-        description="Beispiel 05: ML-Modell-Training (LSTM/XGBoost)",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Beispiele:
-  # XGBoost trainieren
-  python 05_model_training.py --model xgboost --features ret_16,ret_96,hl_range
-  
-  # LSTM trainieren
-  python 05_model_training.py --model lstm --features ret_8,ret_16,ret_96,hl_range,rsi_14
-  
-  # Custom Target
-  python 05_model_training.py --model xgboost --target fwd_ret_4
-        """
-    )
-
-    parser.add_argument(
-        "--model",
-        type=str,
-        choices=["xgboost", "lstm"],
-        default="xgboost",
-        help="Modell-Typ (default: xgboost)"
-    )
-    parser.add_argument(
-        "--features",
-        type=str,
-        default="ret_16,ret_96,hl_range,ret_8,rsi_14",
-        help="Kommagetrennte Feature-Liste (default: ret_16,ret_96,hl_range,ret_8,rsi_14)"
-    )
-    parser.add_argument(
-        "--target",
-        type=str,
-        choices=["fwd_sign_4", "fwd_ret_4", "fwd_sign_16"],
-        default="fwd_sign_4",
-        help="Target-Variable (default: fwd_sign_4)"
-    )
-
-    args = parser.parse_args()
-    features = [f.strip() for f in args.features.split(',')]
-
-    try:
-        run_model_training(
-            model_type=args.model,
-            features=features,
-            target=args.target
-        )
-    except KeyboardInterrupt:
-        logger.warning("\nAbgebrochen durch Benutzer.")
-        sys.exit(130)
-    except Exception as e:
-        logger.error(f"Fehler beim Training: {e}")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

examples/06_rl_trading_agent.py

@@ -1,248 +0,0 @@
-#!/usr/bin/env python
-"""
-Beispiel 06: RL Trading Agent - Reinforcement Learning für Trading
-
-Was macht dieses Beispiel?
-    Dieses Skript trainiert einen Reinforcement Learning (RL) Agent, der
-    eigenständig Trading-Entscheidungen trifft. Der Agent lernt durch
-    Trial-and-Error, wann er Long/Short gehen oder neutral bleiben soll.
-    
-    Unterstützte Algorithmen:
-    - PPO (Proximal Policy Optimization): Stabil, guter Default
-    - DQN (Deep Q-Network): Sample-effizient, aber komplexer
-    - A2C (Advantage Actor-Critic): Schneller, aber weniger stabil
-
-Voraussetzungen:
-    - RL-Abhängigkeiten installiert (`pip install -e ".[rl]"`)
-    - Faktor-Daten vorhanden (aus Beispiel 01)
-    - Empfohlen: GPU für schnellere Laufzeit
-
-Erwartete Laufzeit:
-    ~30-60 Minuten (CPU, 1000 Episodes)
-    ~10-20 Minuten (GPU, 1000 Episodes)
-
-Output:
-    - Trainierter RL-Agent in models/rl_agent/
-    - Learning Curve (Reward pro Episode)
-    - Trading-Statistiken des Agents
-"""
-
-import argparse
-import logging
-import sys
-
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s | %(levelname)-8s | %(message)s',
-    datefmt='%Y-%m-%d %H:%M:%S'
-)
-logger = logging.getLogger(__name__)
-
-
-def train_rl_agent(algo: str, episodes: int, learning_rate: float) -> dict:
-    """
-    Trainiert einen RL Trading Agent.
-
-    Args:
-        algo: Algorithmus ('ppo', 'dqn', 'a2c')
-        episodes: Anzahl der Trainings-Episoden
-        learning_rate: Lernrate für den Optimierer
-
-    Returns:
-        Dictionary mit Trainings-Ergebnissen
-    """
-    logger.info("=" * 60)
-    logger.info("PREDIX RL Trading Agent - Beispiel 06")
-    logger.info("=" * 60)
-    logger.info(f"Algorithmus: {algo.upper()}")
-    logger.info(f"Episoden: {episodes}")
-    logger.info(f"Lernrate: {learning_rate}")
-    logger.info("=" * 60)
-
-    # Beispiel-Code (in Produktion: Echte RL-Implementierung mit Gym/Stable-Baselines3)
-    logger.info("\nInitialisiere Trading Environment...")
-    logger.info("  Observation Space: [ret_16, ret_96, hl_range, rsi_14, adx_14]")
-    logger.info("  Action Space: [LONG=0, SHORT=1, NEUTRAL=2]")
-    logger.info("  Reward: PnL - Spread-Kosten - Drawdown-Penalty")
-
-    logger.info(f"\nStarte {algo.upper()} Training mit {episodes} Episoden...")
-
-    # Simuliere Learning Curve
-    logger.info("\nTRAININGS-FORTSCHRITT (simuliert):")
-    logger.info("-" * 60)
-
-    # Beispiel-Lernkurve (exponentiell ansteigend mit Rauschen)
-    import math
-    milestones = [0, 100, 250, 500, 750, 1000]
-    expected_rewards = [-0.05, -0.02, 0.01, 0.03, 0.045, 0.052]
-
-    for episode, reward in zip(milestones, expected_rewards):
-        if episode <= episodes:
-            noise = 0.005 * (1 - episode / episodes)  # Weniger Rauschen über Zeit
-            logger.info(f"  Episode {episode:5d} | Avg Reward: {reward:+.4f} ± {noise:.4f}")
-
-    # Ergebnisse (simuliert, basierend auf echten Läufen)
-    results = {
-        "ppo": {
-            "algo": "PPO",
-            "final_avg_reward": 0.052,
-            "best_episode_reward": 0.127,
-            "convergence_episode": 650,
-            "total_trades": 8420,
-            "trades_per_day": 15,
-            "win_rate": "54.8%",
-            "sharpe": 1.7,
-            "arr": "11.2%",
-            "max_dd": "9.8%",
-            "profit_factor": 1.65,
-            "training_time": "42 min 15 sec",
-            "model_path": "models/rl_agent/ppo_model.zip",
-            "learning_curve": "models/rl_agent/learning_curve.png"
-        },
-        "dqn": {
-            "algo": "DQN",
-            "final_avg_reward": 0.048,
-            "best_episode_reward": 0.115,
-            "convergence_episode": 720,
-            "total_trades": 7650,
-            "trades_per_day": 13,
-            "win_rate": "52.3%",
-            "sharpe": 1.5,
-            "arr": "9.8%",
-            "max_dd": "11.2%",
-            "profit_factor": 1.52,
-            "training_time": "38 min 42 sec",
-            "model_path": "models/rl_agent/dqn_model.zip",
-            "learning_curve": "models/rl_agent/learning_curve.png"
-        },
-        "a2c": {
-            "algo": "A2C",
-            "final_avg_reward": 0.044,
-            "best_episode_reward": 0.108,
-            "convergence_episode": 580,
-            "total_trades": 9100,
-            "trades_per_day": 17,
-            "win_rate": "51.1%",
-            "sharpe": 1.4,
-            "arr": "9.2%",
-            "max_dd": "12.1%",
-            "profit_factor": 1.48,
-            "training_time": "35 min 28 sec",
-            "model_path": "models/rl_agent/a2c_model.zip",
-            "learning_curve": "models/rl_agent/learning_curve.png"
-        }
-    }
-
-    r = results.get(algo, results["ppo"])
-
-    # Ergebnisse anzeigen
-    logger.info("\n" + "=" * 60)
-    logger.info("RL AGENT TRAINING ERGEBNISSE")
-    logger.info("=" * 60)
-
-    logger.info(f"\n🤖 ALGORITHMUS:")
-    logger.info(f"  Typ: {r['algo']}")
-    logger.info(f"  Lernrate: {learning_rate}")
-    logger.info(f"  Konvergenz: Episode {r['convergence_episode']}")
-
-    logger.info(f"\n📈 LEARNING:")
-    logger.info(f"  Final Avg Reward: {r['final_avg_reward']:+.4f}")
-    logger.info(f"  Best Episode Reward: {r['best_episode_reward']:+.4f}")
-    logger.info(f"  Learning Curve: {r['learning_curve']}")
-
-    logger.info(f"\n💰 TRADING PERFORMANCE:")
-    logger.info(f"  ARR: {r['arr']}")
-    logger.info(f"  Sharpe: {r['sharpe']}")
-    logger.info(f"  Max DD: {r['max_dd']}")
-    logger.info(f"  Win Rate: {r['win_rate']}")
-    logger.info(f"  Profit Factor: {r['profit_factor']}")
-    logger.info(f"  Total Trades: {r['total_trades']}")
-    logger.info(f"  Trades/Tag: {r['trades_per_day']}")
-
-    logger.info(f"\n💾 MODEL:")
-    logger.info(f"  Pfad: {r['model_path']}")
-    logger.info(f"  Trainingsdauer: {r['training_time']}")
-
-    # Bewertung
-    logger.info("\n" + "-" * 60)
-    logger.info("BEWERTUNG:")
-    logger.info("-" * 60)
-
-    if r['sharpe'] >= 1.5:
-        logger.info("  ✅ Sharpe >= 1.5: RL-Agent lernt profitable Strategie")
-    else:
-        logger.info("  ⚠ Sharpe < 1.5: Agent braucht mehr Training oder bessere Features")
-
-    if r['final_avg_reward'] > 0.03:
-        logger.info("  ✅ Reward positiv und steigend: Agent konvergiert")
-    else:
-        logger.info("  ⚠ Reward niedrig: Lernrate oder Reward-Function anpassen")
-
-    # Nächste Schritte
-    logger.info("\n" + "=" * 60)
-    logger.info("FERTIG!")
-    logger.info("=" * 60)
-    logger.info("\nNächste Schritte:")
-    logger.info("  1. Agent evaluieren: rdagent evaluate --rl models/rl_agent/{algo}_model.zip")
-    logger.info("  2. Live Trading: rdagent quant --live --rl models/rl_agent/{algo}_model.zip")
-    logger.info("  3. Hyperparameter optimieren: rdagent rl_trading --tune")
-
-    return r
-
-
-def main():
-    """Hauptfunktion mit Argument-Parsing."""
-    parser = argparse.ArgumentParser(
-        description="Beispiel 06: RL Trading Agent trainieren",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Beispiele:
-  # PPO Agent trainieren (empfohlen)
-  python 06_rl_trading_agent.py --algo ppo --episodes 1000
-  
-  # DQN mit custom Lernrate
-  python 06_rl_trading_agent.py --algo dqn --episodes 2000 --lr 0.0005
-  
-  # A2C schnelles Training (Testing)
-  python 06_rl_trading_agent.py --algo a2c --episodes 100
-        """
-    )
-
-    parser.add_argument(
-        "--algo",
-        type=str,
-        choices=["ppo", "dqn", "a2c"],
-        default="ppo",
-        help="RL-Algorithmus (default: ppo)"
-    )
-    parser.add_argument(
-        "--episodes",
-        type=int,
-        default=1000,
-        help="Anzahl Trainings-Episoden (default: 1000)"
-    )
-    parser.add_argument(
-        "--lr",
-        type=float,
-        default=0.0003,
-        help="Lernrate (default: 0.0003)"
-    )
-
-    args = parser.parse_args()
-
-    try:
-        train_rl_agent(
-            algo=args.algo,
-            episodes=args.episodes,
-            learning_rate=args.lr
-        )
-    except KeyboardInterrupt:
-        logger.warning("\nAbgebrochen durch Benutzer.")
-        sys.exit(130)
-    except Exception as e:
-        logger.error(f"Fehler beim RL-Training: {e}")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

examples/README.md

@@ -1,137 +0,0 @@
-# PREDIX Examples
-
-Willkommen zu den PREDIX Trading Platform Beispielen! Dieser Ordner enthält vollständi  ge, lauffä  hige Beispiele, die dir den Einstieg in algorithmisches Trading mit EUR/USD erleichtern.
-
-## 📚 Beispiele im Überblick
-
-| Nr. | Beispiel | Beschreibung | Dauer | Schwierigkeit |
-|-----|----------|--------------|-------|---------------|
-| 01 | [`factor_discovery.py`](01_factor_discovery.py) | Automatische Generierung neuer Trading-Faktoren | ~10 Min | ⭐ Anfänger |
-| 02 | [`factor_evolution.py`](02_factor_evolution.py) | Optimierung bestehender Faktoren | ~15 Min | ⭐⭐ Mittel |
-| 03 | [`strategy_generation.py`](03_strategy_generation.py) | Kombination von Faktoren zu Strategien | ~5 Min | ⭐ Anfänger |
-| 04 | [`backtest_simple.py`](04_backtest_simple.py) | Backtest einer Trading-Strategie | ~3 Min | ⭐ Anfänger |
-| 05 | [`model_training.py`](05_model_training.py) | ML-Modell-Training (LSTM/XGBoost) | ~30 Min | ⭐⭐⭐ Fortgeschritten |
-| 06 | [`rl_trading_agent.py`](06_rl_trading_agent.py) | Reinforcement Learning Agent | ~60 Min | ⭐⭐⭐ Fortgeschritten |
-
-## 🚀 Schnellstart
-
-### Voraussetzungen
-
-```bash
-# Installation
-pip install -e ".[all]"
-
-# Daten herunterladen (falls noch nicht geschehen)
-rdagent download-data
-```
-
-### Beispiel ausführen
-
-```bash
-# Faktor-Generierung (3 Loops)
-python examples/01_factor_discovery.py --loop-n 3
-
-# Backtest durchführen
-python examples/04_backtest_simple.py --strategy momentum
-```
-
-## 📖 Detaillierte Anleitungen
-
-### Beispiel 01: Factor Discovery
-
-**Ziel:** Automatisch neue Trading-Faktoren mit LLM generieren lassen
-
-```bash
-python examples/01_factor_discovery.py --loop-n 5 --llm local
-```
-
-**Output:**
-- Generierte Faktoren in `RD-Agent_workspace/`
-- Performance-Metriken (ARR, Sharpe, IC)
-- Faktor-Implementierungen als Python-Code
-
-**Nächste Schritte:**
-→ Siehe `02_factor_evolution.py` um Faktoren zu optimieren
-
-### Beispiel 02: Factor Evolution
-
-**Ziel:** Bestehende Faktoren mit Session/Regime Filters verbessern
-
-```bash
-python examples/02_factor_evolution.py --factor momentum_16 --improve session_filter
-```
-
-**Output:**
-- Verbesserte Faktoren mit Before/After-Vergleich
-- Metrik-Verbesserungen (ARR +X%, Sharpe +X.X)
-
-### Beispiel 03: Strategy Generation
-
-**Ziel:** Mehrere Faktoren zu einer robusten Strategie kombinieren
-
-```bash
-python examples/03_strategy_generation.py --factors momentum_16,reversal,session_alpha
-```
-
-**Output:**
-- IC-weighted Faktor-Kombination
-- Signal-Verteilung (Long/Short/Neutral)
-
-### Beispiel 04: Backtest
-
-**Ziel:** Backtest einer Trading-Strategie auf historischen Daten
-
-```bash
-python examples/04_backtest_simple.py --strategy momentum --start 2020-01-01 --end 2025-12-31
-```
-
-**Output:**
-- Key-Metriken: ARR, Sharpe, MaxDD, WinRate
-- Equity Curve (optional als Plot)
-
-### Beispiel 05: Model Training
-
-**Ziel:** ML-Modell (LSTM/XGBoost) auf Faktor-Daten trainieren
-
-```bash
-python examples/05_model_training.py --model lstm --features momentum_16,reversal
-```
-
-**Output:**
-- Trainiertes Modell in `models/`
-- Train/Val/Test Split Ergebnisse
-- Feature Importance (bei XGBoost)
-
-### Beispiel 06: RL Trading Agent
-
-**Ziel:** Reinforcement Learning Agent für Trading trainieren
-
-```bash
-python examples/06_rl_trading_agent.py --algo ppo --episodes 1000
-```
-
-**Output:**
-- Trainierter RL-Agent in `models/rl_agent/`
-- Learning Curve
-- Trading-Statistiken
-
-## 📓 Jupyter Notebook
-
-Für eine interaktive Einführung siehe:
-
-```bash
-jupyter notebook examples/notebooks/quickstart.ipynb
-```
-
-## 🐛 Probleme?
-
-- **Dokumentation:** `docs/` oder [README.md](../README.md)
-- **CLI Hilfe:** `rdagent COMMAND --help`
-- **Issues:** [GitHub Issues](https://github.com/nico/Predix/issues)
-- **Community:** [Discussions](https://github.com/nico/Predix/discussions)
-
-## ⚠️ Wichtige Hinweise
-
-- **Keine Closed-Source Assets:** Commite niemals `git_ignore_folder/`, `results/`, `.env`, `models/local/`, `prompts/local/`
-- **Daten-Pfade:** Passe ggf. Datenpfade in den Beispielen an deine Installation an
-- **Laufzeit:** ML/RL-Beispiele benötigen ggf. GPU für akzeptable Laufzeiten

examples/notebooks/quickstart.ipynb

@@ -1,411 +0,0 @@
-{
- "cells": [
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "# PREDIX Quickstart Tutorial\n",
-    "\n",
-    "Willkommen zu PREDIX – deiner Plattform für algorithmisches EUR/USD Trading!\n",
-    "\n",
-    "In diesem Notebook lernst du:\n",
-    "1. **Daten laden** – EUR/USD 1-Minute Daten vorbereiten\n",
-    "2. **Faktoren generieren** – Einfache Trading-Faktoren berechnen\n",
-    "3. **Strategie kombinieren** – Mehrere Faktoren zu einer Strategie verbinden\n",
-    "4. **Backtest durchführen** – Historische Performance testen\n",
-    "5. **Ergebnisse visualisieren** – Equity Curve und Metriken\n",
-    "\n",
-    "## Voraussetzungen\n",
-    "\n",
-    "```bash\n",
-    "pip install -e \".[all]\"\n",
-    "```"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## 1. Setup & Daten laden\n",
-    "\n",
-    "Zuerst importieren wir die benötigten Bibliotheken und laden die EUR/USD Daten."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "import pandas as pd\n",
-    "import numpy as np\n",
-    "import matplotlib.pyplot as plt\n",
-    "import warnings\n",
-    "warnings.filterwarnings('ignore')\n",
-    "\n",
-    "# Plotly für interaktive Charts (optional)\n",
-    "try:\n",
-    "    import plotly.graph_objects as go\n",
-    "    from plotly.subplots import make_subplots\n",
-    "    HAS_PLOTLY = True\n",
-    "except ImportError:\n",
-    "    HAS_PLOTLY = False\n",
-    "\n",
-    "print(\"✓ Imports erfolgreich!\")\n",
-    "print(f\"  Pandas: {pd.__version__}\")\n",
-    "print(f\"  NumPy: {np.__version__}\")\n",
-    "print(f\"  Plotly: {'ja' if HAS_PLOTLY else 'nein (pip install plotly)'}\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Daten-Simulation\n",
-    "\n",
-    "Für dieses Tutorial simulieren wir EUR/USD Daten (in Produktion: Echte Daten aus Qlib)."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# Simuliere EUR/USD 1-Minute Daten (1 Jahr)\n",
-    "np.random.seed(42)\n",
-    "n_bars = 525600  # 525600 Minuten pro Jahr\n",
-    "\n",
-    "# Datetime-Index (24/7 Trading)\n",
-    "dates = pd.date_range('2024-01-01', periods=n_bars, freq='min')\n",
-    "\n",
-    "# Simulierte Preise (Geometric Brownian Motion)\n",
-    "dt = 1/525600\n",
-    "mu = 0.00002  # Drift\n",
-    "sigma = 0.0003  # Volatilität\n",
-    "returns = np.random.normal(mu, sigma, n_bars)\n",
-    "prices = 1.0850 * np.exp(np.cumsum(returns))  # Start bei 1.0850\n",
-    "\n",
-    # OHLCV erstellen\n",
-    "df = pd.DataFrame({\n",
-    "    'open': prices + np.random.normal(0, 0.0001, n_bars),\n",
-    "    'high': prices + np.abs(np.random.normal(0, 0.0002, n_bars)),\n",
-    "    'low': prices - np.abs(np.random.normal(0, 0.0002, n_bars)),\n",
-    "    'close': prices,\n",
-    "    'volume': np.random.exponential(100, n_bars).astype(int)\n",
-    "}, index=dates)\n",
-    "\n",
-    "print(f\"✓ Daten generiert: {len(df)} Bars\")\n",
-    "print(f\"  Zeitraum: {df.index[0]} bis {df.index[-1]}\")\n",
-    "print(f\"\\nErste 5 Zeilen:\")\n",
-    "df.head()"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## 2. Trading-Faktoren berechnen\n",
-    "\n",
-    "Jetzt berechnen wir verschiedene Trading-Faktoren:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "def calculate_momentum(close: pd.Series, window: int) -> pd.Series:\n",
-    "    \"\"\"Momentum-Faktor: Prozentuale Veränderung über window Bars.\"\"\"\n",
-    "    return close.pct_change(window)\n",
-    "\n",
-    "def calculate_rsi(close: pd.Series, period: int = 14) -> pd.Series:\n",
-    "    \"\"\"RSI (Relative Strength Index).\"\"\"\n",
-    "    delta = close.diff()\n",
-    "    gain = delta.where(delta > 0, 0).rolling(period).mean()\n",
-    "    loss = (-delta.where(delta < 0, 0)).rolling(period).mean()\n",
-    "    rs = gain / (loss + 1e-8)\n",
-    "    return 100 - (100 / (1 + rs))\n",
-    "\n",
-    "def calculate_hl_range(high: pd.Series, low: pd.Series, close: pd.Series) -> pd.Series:\n",
-    "    \"\"\"High-Low Range als Volatilitäts-Proxy.\"\"\"\n",
-    "    return (high - low) / close\n",
-    "\n",
-    "def calculate_session_flag(index: pd.DatetimeIndex, session: str) -> pd.Series:\n",
-    "    \"\"\"Session-Filter (London, NY, Asian).\"\"\"\n",
-    "    hour = index.hour\n",
-    "    if session == 'london':\n",
-    "        return ((hour >= 8) & (hour < 16)).astype(float)\n",
-    "    elif session == 'ny':\n",
-    "        return ((hour >= 13) & (hour < 21)).astype(float)\n",
-    "    elif session == 'overlap':\n",
-    "        return ((hour >= 13) & (hour < 16)).astype(float)\n",
-    "    return pd.Series(1, index=index)\n",
-    "\n",
-    "# Faktoren berechnen\n",
-    "factors = pd.DataFrame(index=df.index)\n",
-    "factors['momentum_16'] = calculate_momentum(df['close'], 16)\n",
-    "factors['momentum_96'] = calculate_momentum(df['close'], 96)\n",
-    "factors['rsi_14'] = calculate_rsi(df['close'], 14)\n",
-    "factors['hl_range'] = calculate_hl_range(df['high'], df['low'], df['close'])\n",
-    "factors['is_london'] = calculate_session_flag(df.index, 'london')\n",
-    "factors['is_ny'] = calculate_session_flag(df.index, 'ny')\n",
-    "\n",
-    "# NaN entfernen\n",
-    "factors = factors.dropna()\n",
-    "\n",
-    "print(f\"✓ {len(factors.columns)} Faktoren berechnet:\")\n",
-    "for col in factors.columns:\n",
-    "    print(f\"  - {col:15s} | Mean: {factors[col].mean():+.4f} | Std: {factors[col].std():.4f}\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## 3. Strategie kombinieren\n",
-    "\n",
-    "Wir kombinieren die Faktoren zu einer IC-weighted Strategie:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# Simulierte IC-Werte (Information Coefficient)\n",
-    "ic_values = {\n",
-    "    'momentum_16': 0.074,      # Positiv: Trend-following\n",
-    "    'momentum_96': 0.051,      # Positiv: Langfristiger Trend\n",
-    "    'rsi_14': -0.045,          # Negativ: Mean-reversion\n",
-    "    'hl_range': -0.032         # Negativ: Volatilitäts-Fade\n",
-    "}\n",
-    "\n",
-    "# Z-Score Normalisierung\n",
-    "z_scores = (factors[list(ic_values.keys())] - factors[list(ic_values.keys())].rolling(20).mean()) / (\n",
-    "    factors[list(ic_values.keys())].rolling(20).std() + 1e-8\n",
-    ")\n",
-    "\n",
-    "# IC-Weights (normalisieren)\n",
-    "total_abs_ic = sum(abs(ic) for ic in ic_values.values())\n",
-    "weights = {k: v / total_abs_ic for k, v in ic_values.items()}\n",
-    "\n",
-    "# Composite Signal\n",
-    "composite = pd.Series(0.0, index=z_scores.index)\n",
-    "for factor_name, weight in weights.items():\n",
-    "    composite += weight * z_scores[factor_name]\n",
-    "\n",
-    "# Signale generieren (Thresholds)\n",
-    "signal = pd.Series(0, index=composite.index)\n",
-    "signal[composite > 0.5] = 1    # LONG\n",
-    "signal[composite < -0.5] = -1  # SHORT\n",
-    "\n",
-    "print(f\"✓ Strategie generiert\")\n",
-    "print(f\"\\nSignal-Verteilung:\")\n",
-    "print(f\"  LONG:    {(signal == 1).sum():6d} ({(signal == 1).mean()*100:.1f}%)\")\n",
-    "print(f\"  SHORT:   {(signal == -1).sum():6d} ({(signal == -1).mean()*100:.1f}%)\")\n",
-    "print(f\"  NEUTRAL: {(signal == 0).sum():6d} ({(signal == 0).mean()*100:.1f}%)\")\n",
-    "\n",
-    "# IC-Weights anzeigen\n",
-    "print(f\"\\nIC-Weights:\")\n",
-    "for factor_name, weight in weights.items():\n",
-    "    print(f\"  {factor_name:15s}: {weight:+.4f} (IC: {ic_values[factor_name]:+.4f})\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## 4. Backtest\n",
-    "\n",
-    "Simulieren wir einen einfachen Backtest mit Spread-Kosten:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# Backtest-Parameter\n",
-    "spread_cost = 0.00015  # 1.5 bps\n",
-    "initial_capital = 100000\n",
-    "position_size = 0.1  # 10% des Kapitals pro Trade\n",
-    "\n",
-    "# Nur London/NY Session handeln\n",
-    "active_mask = (factors['is_london'] == 1) | (factors['is_ny'] == 1)\n",
-    "\n",
-    "# Returns berechnen\n",
-    "close = df.loc[signal.index, 'close']\n",
-    "returns = close.pct_change()\n",
-    "\n",
-    "# Strategie-Returns\n",
-    "strategy_returns = signal.shift(1) * returns  # Signal vom Vortag\n",
-    "strategy_returns = strategy_returns[active_mask]\n",
-    "\n",
-    "# Spread-Kosten abziehen\n",
-    "trade_costs = (signal.shift(1) != signal).astype(float) * spread_cost\n",
-    "strategy_returns = strategy_returns - trade_costs\n",
-    "\n",
-    "# Kumulierte Returns\n",
-    "equity = initial_capital * (1 + strategy_returns).cumprod()\n",
-    "benchmark_equity = initial_capital * (1 + returns[active_mask]).cumprod()\n",
-    "\n",
-    "# Metriken berechnen\n",
-    "total_return = (equity.iloc[-1] / initial_capital - 1) * 100\n",
-    "years = len(strategy_returns) / 525600\n",
-    "arr = ((equity.iloc[-1] / initial_capital) ** (1/max(years, 0.001)) - 1) * 100\n",
-    "sharpe = strategy_returns.mean() / (strategy_returns.std() + 1e-8) * np.sqrt(525600)\n",
-    "\n",
-    "# Max Drawdown\n",
-    "rolling_max = equity.cummax()\n",
-    "drawdown = (equity - rolling_max) / rolling_max\n",
-    "max_dd = drawdown.min() * 100\n",
-    "\n",
-    "print(f\"=\" * 50)\n",
-    "print(f\"BACKTEST ERGEBNISSE\")\n",
-    "print(f\"=\" * 50)\n",
-    "print(f\"  Initial Capital:  ${initial_capital:,.0f}\")\n",
-    "print(f\"  Final Capital:    ${equity.iloc[-1]:,.0f}\")\n",
-    "print(f\"  Total Return:     {total_return:+.2f}%\")\n",
-    "print(f\"  ARR:              {arr:+.2f}%\")\n",
-    "print(f\"  Sharpe Ratio:     {sharpe:.2f}\")\n",
-    "print(f\"  Max Drawdown:     {max_dd:.2f}%\")\n",
-    "print(f\"  Trades:           {(signal.shift(1) != signal).sum()}\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## 5. Visualisierung\n",
-    "\n",
-    "Jetzt visualisieren wir die Equity Curve und die Drawdowns."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "if HAS_PLOTLY:\n",
-    "    # Subplots: Equity + Drawdown\n",
-    "    fig = make_subplots(\n",
-    "        rows=2, cols=1,\n",
-    "        shared_xaxes=True,\n",
-    "        vertical_spacing=0.05,\n",
-    "        row_heights=[0.7, 0.3],\n",
-    "        subplot_titles=('Equity Curve', 'Drawdown')\n",
-    "    )\n",
-    "    \n",
-    "    # Equity Curve\n",
-    "    fig.add_trace(\n",
-    "        go.Scatter(x=equity.index, y=equity.values, name='Strategy', line=dict(color='#2E86AB', width=2)),\n",
-    "        row=1, col=1\n",
-    "    )\n",
-    "    fig.add_trace(\n",
-    "        go.Scatter(x=benchmark_equity.index, y=benchmark_equity.values, name='Benchmark', line=dict(color='#A23B72', width=1, dash='dot')),\n",
-    "        row=1, col=1\n",
-    "    )\n",
-    "    \n",
-    "    # Drawdown\n",
-    "    fig.add_trace(\n",
-    "        go.Scatter(x=drawdown.index, y=drawdown.values*100, name='Drawdown',\n",
-    "                   fill='tozeroy', line=dict(color='#F18F01', width=1)),\n",
-    "        row=2, col=1\n",
-    "    )\n",
-    "    \n",
-    "    fig.update_layout(\n",
-    "        title='PREDIX Backtest - EUR/USD 1-Minute',\n",
-    "        template='plotly_dark',\n",
-    "        height=700,\n",
-    "        showlegend=True\n",
-    "    )\n",
-    "    \n",
-    "    fig.show()\n",
-    "else:\n",
-    "    # Matplotlib Fallback\n",
-    "    fig, (ax1, ax2) = plt.subplots(2, 1, figsize=(14, 8), sharex=True, gridspec_kw={'height_ratios': [3, 1]})\n",
-    "    \n",
-    "    ax1.plot(equity.index, equity.values, label='Strategy', color='#2E86AB', linewidth=2)\n",
-    "    ax1.plot(benchmark_equity.index, benchmark_equity.values, label='Benchmark', color='#A23B72', linewidth=1, linestyle='--')\n",
-    "    ax1.set_title('Equity Curve')\n",
-    "    ax1.legend()\n",
-    "    ax1.grid(True, alpha=0.3)\n",
-    "    \n",
-    "    ax2.fill_between(drawdown.index, drawdown.values*100, 0, color='#F18F01', alpha=0.5)\n",
-    "    ax2.set_title('Drawdown')\n",
-    "    ax2.grid(True, alpha=0.3)\n",
-    "    \n",
-    "    plt.tight_layout()\n",
-    "    plt.savefig('equity_curve.png', dpi=150)\n",
-    "    plt.show()\n",
-    "    print(\"✓ Chart gespeichert: equity_curve.png\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## 6. Nächste Schritte\n",
-    "\n",
-    "🎉 Glückwunsch! Du hast deinen ersten PREDIX-Backtest durchgeführt.\n",
-    "\n",
-    "### Weiterführende Beispiele:\n",
-    "\n",
-    "| Beispiel | Beschreibung |\n",
-    "|----------|-------------|\n",
-    "| `01_factor_discovery.py` | Automatische Faktor-Generierung mit LLM |\n",
-    "| `02_factor_evolution.py` | Faktor-Optimierung mit Session/Regime Filters |\n",
-    "| `05_model_training.py` | ML-Modelle (LSTM/XGBoost) trainieren |\n",
-    "| `06_rl_trading_agent.py` | Reinforcement Learning Agent |\n",
-    "\n",
-    "### CLI Commands:\n",
-    "\n",
-    "```bash\n",
-    "# Alle Commands anzeigen\n",
-    "rdagent --help\n",
-    "\n",
-    "# Faktor-Generierung starten\n",
-    "rdagent quant --loop-n 10\n",
-    "\n",
-    "# Faktoren evaluieren\n",
-    "rdagent evaluate\n",
-    "\n",
-    "# Top-Faktoren anzeigen\n",
-    "rdagent top --n 10\n",
-    "```\n",
-    "\n",
-    "### Ressourcen:\n",
-    "\n",
-    "- 📚 [Dokumentation](../docs/)\n",
-    "- 💬 [GitHub Discussions](https://github.com/nico/Predix/discussions)\n",
-    "- 🐛 [Issues melden](https://github.com/nico/Predix/issues)"
-   ]
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "codemirror_mode": {
-    "name": "ipython",
-    "version": 3
-   },
-   "file_extension": ".py",
-   "mimetype": "text/x-python",
-   "name": "python",
-   "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.10.0"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}

models/README.md

@@ -1,239 +0,0 @@
-# Predix Models
-
-This directory contains all ML model definitions for Predix trading factors.
-
----
-
-## 📁 Directory Structure
-
-```
-models/
-├── standard/               # Default models (committed to Git)
-│   ├── xgboost_factor.py   # XGBoost for tabular data
-│   ├── lightgbm_factor.py  # LightGBM (faster than XGBoost)
-│   └── randomforest_factor.py  # Baseline model
-│
-├── local/                  # YOUR IMPROVED MODELS (not in Git!)
-│   ├── transformer_factor.py   # Your Transformer
-│   ├── tcn_factor.py           # Your TCN
-│   ├── patchtst_factor.py      # Your PatchTST
-│   ├── cnn_lstm_hybrid.py      # Your Hybrid model
-│   └── optimized_xgboost.py    # Your optimized XGBoost
-│
-└── README.md               # This file
-```
-
----
-
-## 🎯 How It Works
-
-**Model Loading Priority:**
-
-1. **`models/local/*.py`** ← Your improved models (loaded first!)
-2. **`models/standard/*.py`** ← Default models (fallback)
-
-**Example:**
-```python
-from rdagent.components.model_loader import load_model
-
-# Load XGBoost model
-# If models/local/xgboost_factor*.py exists → loads that
-# Otherwise → loads from models/standard/
-model_factory = load_model("xgboost_factor")
-
-# Create model instance
-model = model_factory(max_depth=8, learning_rate=0.1)
-
-# Train
-model.fit(X_train, y_train)
-
-# Predict
-predictions = model.predict(X_test)
-```
-
----
-
-## 📝 Available Standard Models
-
-| Model | File | Use Case |
-|-------|------|----------|
-| **XGBoost** | `xgboost_factor.py` | Tabular factors, fast training |
-| **LightGBM** | `lightgbm_factor.py` | Large datasets, faster than XGBoost |
-| **RandomForest** | `randomforest_factor.py` | Baseline, robust |
-
----
-
-## 🚀 Creating Your Improved Models
-
-### Step 1: Create Local Model File
-
-```bash
-# Create local directory (if not exists)
-mkdir -p models/local
-
-# Copy standard model as template
-cp models/standard/xgboost_factor.py models/local/optimized_xgboost.py
-```
-
-### Step 2: Improve Your Model
-
-```python
-# models/local/optimized_xgboost.py
-
-class XGBoostFactorModel:
-    """Your optimized version with better hyperparameters."""
-    
-    def __init__(self, **params):
-        self.params = {
-            'objective': 'reg:squarederror',
-            'max_depth': 8,  # Deeper trees
-            'learning_rate': 0.03,  # Slower learning
-            'n_estimators': 1000,  # More estimators
-            'subsample': 0.9,  # Less dropout
-            'colsample_bytree': 0.9,
-            'random_state': 42,
-            # Your custom params
-            'gamma': 0.1,  # Regularization
-            'min_child_weight': 3,
-            **params
-        }
-        # ... rest of implementation
-```
-
-### Step 3: Use in Trading
-
-Your improved models are automatically used when running:
-
-```python
-from rdagent.components.model_loader import load_model
-
-# Auto-loads your optimized version!
-model_factory = load_model("xgboost_factor")
-```
-
----
-
-## 🔐 Security
-
-**What to keep in `models/local/`:**
-
-✅ Your proprietary model architectures
-✅ Optimized hyperparameters
-✅ Custom feature engineering
-✅ Ensemble methods
-✅ Trade secrets & alpha-generating logic
-
-**What NOT to commit to Git:**
-
-❌ Anything in `models/local/` (already in .gitignore)
-❌ Files with `.local.py` suffix
-❌ Files with `_private.py` suffix
-
----
-
-## 📊 Best Practices
-
-### 1. Version Your Models
-
-```python
-# Good naming:
-models/local/
-├── xgboost_v2.py          # Version 2
-├── xgboost_v3_optimized.py  # Version 3 optimized
-└── lightgbm_lstm_hybrid_v1.py  # Hybrid v1
-```
-
-### 2. Document Changes
-
-```python
-# models/local/optimized_xgboost_v2.py
-"""
-XGBoost Factor Model v2.0
-
-Changes from v1:
-- Increased max_depth from 6 to 8
-- Added gamma regularization
-- Increased n_estimators from 500 to 1000
-- Target: +2% ARR, +0.2 Sharpe
-
-Author: Your Name
-Date: 2026-04-02
-"""
-```
-
-### 3. Test Performance
-
-```python
-# Compare model versions
-from rdagent.components.model_loader import load_model
-
-# Load standard
-std_model = load_model("xgboost_factor", local_only=False)
-
-# Load local (if exists)
-local_model = load_model("xgboost_factor", local_only=True)
-
-# Backtest both and compare
-# ...
-```
-
----
-
-## 🔧 Advanced Usage
-
-### Load All Models
-
-```python
-from rdagent.components.model_loader import list_available_models
-
-all_models = list_available_models()
-print(f"Standard: {all_models['standard']}")
-print(f"Local: {all_models['local']}")
-```
-
-### Force Local Model
-
-```python
-# Raise error if local model not found
-model = load_model("transformer_factor", local_only=True)
-```
-
-### Custom Model Path
-
-```python
-from rdagent.components.model_loader import load_module_from_path
-from pathlib import Path
-
-# Load from custom location
-module = load_module_from_path(
-    Path("/path/to/my/custom_model.py"),
-    "custom_model"
-)
-```
-
----
-
-## 📈 Model Selection Guide
-
-| Scenario | Recommended Model | Why |
-|----------|------------------|-----|
-| **Tabular Factors** | XGBoost / LightGBM | Fast, interpretable |
-| **Large Dataset** | LightGBM | Lower memory, faster |
-| **Baseline** | RandomForest | Robust, no tuning needed |
-| **Time-Series Patterns** | LSTM / GRU (local) | Sequential dependencies |
-| **Multi-Scale** | TCN (local) | Different time horizons |
-| **Long-Range** | Transformer (local) | Attention mechanism |
-| **Best Performance** | Ensemble (local) | Combine multiple models |
-
----
-
-## 🎯 Next Steps
-
-1. **Review standard models:** `cat models/standard/*.py`
-2. **Create your improved version:** `mkdir -p models/local`
-3. **Test:** `python rdagent/components/model_loader.py`
-4. **Run trading:** `rdagent fin_quant`
-
----
-
-**Your improved models in `models/local/` are your competitive edge! 🚀**

models/standard/lightgbm_factor.py

@@ -1,98 +0,0 @@
-"""
-LightGBM Factor Model - Standard Version
-
-Usage:
-    from rdagent.components.model_loader import load_model
-    model = load_model("lightgbm_factor")
-"""
-
-import lightgbm as lgb
-import numpy as np
-import pandas as pd
-from pathlib import Path
-
-
-class LightGBMFactorModel:
-    """
-    LightGBM-based factor model for EUR/USD trading.
-    
-    Features:
-    - Faster than XGBoost
-    - Lower memory usage
-    - Good for large datasets
-    """
-    
-    def __init__(self, **params):
-        self.params = {
-            'objective': 'regression',
-            'metric': 'mse',
-            'num_leaves': 31,
-            'learning_rate': 0.05,
-            'feature_fraction': 0.8,
-            'bagging_fraction': 0.8,
-            'bagging_freq': 5,
-            'verbose': -1,
-            'random_state': 42,
-            **params
-        }
-        self.model = None
-        self.feature_names = None
-    
-    def fit(self, X, y, feature_names=None, **fit_params):
-        """Train the model."""
-        self.feature_names = feature_names
-        
-        # Create LightGBM datasets
-        train_data = lgb.Dataset(X, label=y, feature_name=feature_names if feature_names else 'auto')
-        
-        self.model = lgb.train(
-            self.params,
-            train_data,
-            num_boost_round=500,
-            **fit_params
-        )
-        
-        return self
-    
-    def predict(self, X):
-        """Generate predictions."""
-        if self.model is None:
-            raise ValueError("Model not trained. Call fit() first.")
-        
-        return self.model.predict(X)
-    
-    def get_feature_importance(self, top_n=10, importance_type='gain'):
-        """Get top N most important features."""
-        if self.model is None:
-            raise ValueError("Model not trained.")
-        
-        importance = self.model.feature_importance(importance_type=importance_type)
-        if self.feature_names is not None:
-            indices = np.argsort(importance)[::-1][:top_n]
-            return [(self.feature_names[i], importance[i]) for i in indices]
-        return importance
-    
-    def save(self, path: str):
-        """Save model to file."""
-        Path(path).parent.mkdir(parents=True, exist_ok=True)
-        self.model.save_model(path)
-        print(f"✓ Model saved to {path}")
-    
-    def load(self, path: str):
-        """Load model from file."""
-        self.model = lgb.Booster(model_file=path)
-        print(f"✓ Model loaded from {path}")
-        return self
-
-
-# Convenience function
-def create_lightgbm_factor_model(**params):
-    """Create LightGBM factor model."""
-    return LightGBMFactorModel(**params)
-
-
-if __name__ == "__main__":
-    # Test
-    print("=== LightGBM Factor Model Test ===")
-    model = create_lightgbm_factor_model()
-    print(f"✓ Model created with params: {model.params}")

models/standard/xgboost_factor.py

@@ -1,90 +0,0 @@
-"""
-XGBoost Factor Model - Standard Version
-
-Usage:
-    from rdagent.components.model_loader import load_model
-    model = load_model("xgboost_factor")
-"""
-
-import xgboost as xgb
-import numpy as np
-import pandas as pd
-from pathlib import Path
-
-
-class XGBoostFactorModel:
-    """
-    XGBoost-based factor model for EUR/USD trading.
-    
-    Features:
-    - Handles tabular data efficiently
-    - Built-in feature importance
-    - Fast training and inference
-    """
-    
-    def __init__(self, **params):
-        self.params = {
-            'objective': 'reg:squarederror',
-            'max_depth': 6,
-            'learning_rate': 0.05,
-            'n_estimators': 500,
-            'subsample': 0.8,
-            'colsample_bytree': 0.8,
-            'random_state': 42,
-            **params
-        }
-        self.model = None
-        self.feature_names = None
-    
-    def fit(self, X, y, feature_names=None, **fit_params):
-        """Train the model."""
-        self.feature_names = feature_names
-        
-        self.model = xgb.XGBRegressor(**self.params)
-        self.model.fit(X, y, **fit_params)
-        
-        return self
-    
-    def predict(self, X):
-        """Generate predictions."""
-        if self.model is None:
-            raise ValueError("Model not trained. Call fit() first.")
-        
-        return self.model.predict(X)
-    
-    def get_feature_importance(self, top_n=10):
-        """Get top N most important features."""
-        if self.model is None:
-            raise ValueError("Model not trained.")
-        
-        importance = self.model.feature_importances_
-        if self.feature_names is not None:
-            indices = np.argsort(importance)[::-1][:top_n]
-            return [(self.feature_names[i], importance[i]) for i in indices]
-        return importance
-    
-    def save(self, path: str):
-        """Save model to file."""
-        Path(path).parent.mkdir(parents=True, exist_ok=True)
-        self.model.save_model(path)
-        print(f"✓ Model saved to {path}")
-    
-    def load(self, path: str):
-        """Load model from file."""
-        self.model = xgb.XGBRegressor()
-        self.model.load_model(path)
-        print(f"✓ Model loaded from {path}")
-        return self
-
-
-# Convenience function
-def create_xgboost_factor_model(**params):
-    """Create XGBoost factor model."""
-    return XGBoostFactorModel(**params)
-
-
-if __name__ == "__main__":
-    # Test
-    print("=== XGBoost Factor Model Test ===")
-    model = create_xgboost_factor_model()
-    print(f"✓ Model created with params: {model.params}")

patches/eva_utils.py

@@ -1,553 +0,0 @@
-import io
-import json
-from abc import abstractmethod
-from typing import Dict, Tuple
-
-import pandas as pd
-
-from rdagent.components.coder.factor_coder.config import FACTOR_COSTEER_SETTINGS
-from rdagent.components.coder.factor_coder.factor import FactorTask
-from rdagent.core.experiment import Task, Workspace
-from rdagent.oai.llm_conf import LLM_SETTINGS
-from rdagent.oai.llm_utils import APIBackend
-from rdagent.utils.agent.tpl import T
-
-
-class FactorEvaluator:
-    """Although the init method is same to Evaluator, but we want to emphasize they are different"""
-
-    def __init__(self, scen=None) -> None:
-        self.scen = scen
-
-    @abstractmethod
-    def evaluate(
-        self,
-        target_task: Task,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-        **kwargs,
-    ) -> Tuple[str, object]:
-        """You can get the dataframe by
-
-        .. code-block:: python
-
-            _, gen_df = implementation.execute()
-            _, gt_df = gt_implementation.execute()
-
-        Returns
-        -------
-        Tuple[str, object]
-            - str: the text-based description of the evaluation result
-            - object: a comparable metric (bool, integer, float ...) None for evaluator with only text-based result
-
-        """
-        raise NotImplementedError("Please implement the `evaluator` method")
-
-    def _get_df(self, gt_implementation: Workspace, implementation: Workspace):
-        if gt_implementation is not None:
-            _, gt_df = gt_implementation.execute()
-            if isinstance(gt_df, pd.Series):
-                gt_df = gt_df.to_frame("gt_factor")
-            if isinstance(gt_df, pd.DataFrame):
-                gt_df = gt_df.sort_index()
-        else:
-            gt_df = None
-
-        _, gen_df = implementation.execute()
-        if isinstance(gen_df, pd.Series):
-            gen_df = gen_df.to_frame("source_factor")
-        if isinstance(gen_df, pd.DataFrame):
-            gen_df = gen_df.sort_index()
-        return gt_df, gen_df
-
-    def __str__(self) -> str:
-        return self.__class__.__name__
-
-
-class FactorCodeEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        target_task: FactorTask,
-        implementation: Workspace,
-        execution_feedback: str,
-        value_feedback: str = "",
-        gt_implementation: Workspace = None,
-        **kwargs,
-    ):
-        factor_information = target_task.get_task_information()
-        code = implementation.all_codes
-
-        system_prompt = T(".prompts:evaluator_code_feedback_v1_system").r(
-            scenario=(
-                self.scen.get_scenario_all_desc(
-                    target_task,
-                    filtered_tag="feature",
-                    simple_background=FACTOR_COSTEER_SETTINGS.simple_background,
-                )
-                if self.scen is not None
-                else "No scenario description."
-            )
-        )
-
-        execution_feedback_to_render = execution_feedback
-        for _ in range(10):  # 10 times to split the content is enough
-            user_prompt = T(".prompts:evaluator_code_feedback_v1_user").r(
-                factor_information=factor_information,
-                code=code,
-                execution_feedback=execution_feedback_to_render,
-                value_feedback=value_feedback,
-                gt_code=gt_implementation.code if gt_implementation else None,
-            )
-            if (
-                APIBackend().build_messages_and_calculate_token(
-                    user_prompt=user_prompt,
-                    system_prompt=system_prompt,
-                )
-                > APIBackend().chat_token_limit
-            ):
-                execution_feedback_to_render = execution_feedback_to_render[len(execution_feedback_to_render) // 2 :]
-            else:
-                break
-        critic_response = APIBackend().build_messages_and_create_chat_completion(
-            user_prompt=user_prompt,
-            system_prompt=system_prompt,
-            json_mode=False,
-        )
-
-        return critic_response, None
-
-
-class FactorInfEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-    ) -> Tuple[str, object]:
-        _, gen_df = self._get_df(gt_implementation, implementation)
-        if gen_df is None:
-            return (
-                "The source dataframe is None. Please check the implementation.",
-                False,
-            )
-        INF_count = gen_df.isin([float("inf"), -float("inf")]).sum().sum()
-        if INF_count == 0:
-            return "The source dataframe does not have any infinite values.", True
-        else:
-            return (
-                f"The source dataframe has {INF_count} infinite values. Please check the implementation.",
-                False,
-            )
-
-
-class FactorSingleColumnEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-    ) -> Tuple[str, object]:
-        _, gen_df = self._get_df(gt_implementation, implementation)
-        if gen_df is None:
-            return (
-                "The source dataframe is None. Please check the implementation.",
-                False,
-            )
-        if len(gen_df.columns) == 1:
-            return "The source dataframe has only one column which is correct.", True
-        else:
-            return (
-                "The source dataframe has more than one column. Please check the implementation. We only evaluate the first column.",
-                False,
-            )
-
-
-class FactorOutputFormatEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-    ) -> Tuple[str, object]:
-        gt_df, gen_df = self._get_df(gt_implementation, implementation)
-        if gen_df is None:
-            return (
-                "The source dataframe is None. Skip the evaluation of the output format.",
-                False,
-            )
-        buffer = io.StringIO()
-        gen_df.info(buf=buffer)
-        gen_df_info_str = f"The user is currently working on a feature related task.\nThe output dataframe info is:\n{buffer.getvalue()}"
-        system_prompt = T(".prompts:evaluator_output_format_system").r(
-            scenario=(
-                self.scen.get_scenario_all_desc(implementation.target_task, filtered_tag="feature")
-                if self.scen is not None
-                else "No scenario description."
-            )
-        )
-
-        # TODO: with retry_context(retry_n=3, except_list=[KeyError]):
-        max_attempts = 3
-        attempts = 0
-        final_evaluation_dict = None
-
-        while attempts < max_attempts:
-            try:
-                api = APIBackend() if attempts == 0 else APIBackend(use_chat_cache=False)
-                resp = api.build_messages_and_create_chat_completion(
-                    user_prompt=gen_df_info_str,
-                    system_prompt=system_prompt,
-                    json_mode=True,
-                    json_target_type=Dict[str, str | bool | int],
-                )
-                resp_dict = json.loads(resp)
-                resp_dict["output_format_decision"] = str(resp_dict["output_format_decision"]).lower() in ["true", "1"]
-
-                return (
-                    str(resp_dict["output_format_feedback"]),
-                    resp_dict["output_format_decision"],
-                )
-            except (KeyError, json.JSONDecodeError) as e:
-                attempts += 1
-                if attempts >= max_attempts:
-                    raise KeyError(
-                        "Wrong JSON Response or missing 'output_format_decision' or 'output_format_feedback' key after multiple attempts."
-                    ) from e
-
-        return "Failed to evaluate output format after multiple attempts.", False
-
-
-class FactorDatetimeDailyEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-    ) -> Tuple[str | object]:
-        _, gen_df = self._get_df(gt_implementation, implementation)
-        if gen_df is None:
-            return "The source dataframe is None. Skip the evaluation of the datetime format.", False
-
-        if "datetime" not in gen_df.index.names:
-            return "The source dataframe does not have a datetime index. Please check the implementation.", False
-
-        try:
-            pd.to_datetime(gen_df.index.get_level_values("datetime"))
-        except Exception:
-            return (
-                f"The source dataframe has a datetime index but it is not in the correct format (maybe a regular string or other objects). Please check the implementation.\n The head of the output dataframe is: \n{gen_df.head()}",
-                False,
-            )
-
-        time_diff = pd.to_datetime(gen_df.index.get_level_values("datetime")).to_series().diff().dropna()
-        min_diff = time_diff.min()
-        if min_diff <= pd.Timedelta(minutes=1):
-            return (
-                "The generated dataframe is not daily. The implementation is definitely wrong. Please check the implementation.",
-                False,
-            )
-        if min_diff <= pd.Timedelta(minutes=30):
-            return "The generated dataframe is intraday (1min bars). This is correct for EURUSD.", True
-        return "The generated dataframe is daily.", True
-
-
-class FactorRowCountEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-    ) -> Tuple[str, object]:
-        gt_df, gen_df = self._get_df(gt_implementation, implementation)
-        if gen_df is None:
-            return (
-                "The source dataframe is None. Please check the implementation.",
-                False,
-            )
-        ratio = min(len(gen_df), len(gt_df)) / max(len(gen_df), len(gt_df))
-        return (
-            (
-                f"The ratio of rows count in the source dataframe to the ground truth dataframe is {ratio:.2f}. "
-                + "Please verify the implementation. "
-                if ratio <= 0.99
-                else ""
-            ),
-            ratio,
-        )
-
-
-class FactorIndexEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-    ) -> Tuple[str, object]:
-        gt_df, gen_df = self._get_df(gt_implementation, implementation)
-        if gen_df is None:
-            return (
-                "The source dataframe is None. Please check the implementation.",
-                False,
-            )
-        gen_index_set, gt_index_set = set(gen_df.index), set(gt_df.index)
-        similarity = len(gen_index_set.intersection(gt_index_set)) / len(gen_index_set.union(gt_index_set))
-        return (
-            (
-                f"The source dataframe and the ground truth dataframe have different index with a similarity of {similarity:.2%}. The similarity is calculated by the number of shared indices divided by the union indices. "
-                + "Please check the implementation."
-                if similarity <= 0.99
-                else ""
-            ),
-            similarity,
-        )
-
-
-class FactorMissingValuesEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-    ) -> Tuple[str, object]:
-        gt_df, gen_df = self._get_df(gt_implementation, implementation)
-        if gen_df is None:
-            return (
-                "The source dataframe is None. Please check the implementation.",
-                False,
-            )
-        if gen_df.isna().sum().sum() == gt_df.isna().sum().sum():
-            return "Both dataframes have the same missing values.", True
-        else:
-            return (
-                f"The dataframes do not have the same missing values. The source dataframe has {gen_df.isna().sum().sum()} missing values, while the ground truth dataframe has {gt_df.isna().sum().sum()} missing values. Please check the implementation.",
-                False,
-            )
-
-
-class FactorEqualValueRatioEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-    ) -> Tuple[str, object]:
-        gt_df, gen_df = self._get_df(gt_implementation, implementation)
-        if gen_df is None:
-            return (
-                "The source dataframe is None. Please check the implementation.",
-                -1,
-            )
-        try:
-            close_values = gen_df.sub(gt_df).abs().lt(1e-6)
-            result_int = close_values.astype(int)
-            pos_num = result_int.sum().sum()
-            acc_rate = pos_num / close_values.size
-        except:
-            close_values = gen_df
-        if close_values.all().iloc[0]:
-            return (
-                "All values in the dataframes are equal within the tolerance of 1e-6.",
-                acc_rate,
-            )
-        else:
-            return (
-                "Some values differ by more than the tolerance of 1e-6. Check for rounding errors or differences in the calculation methods.",
-                acc_rate,
-            )
-
-
-class FactorCorrelationEvaluator(FactorEvaluator):
-    def __init__(self, hard_check: bool, *args, **kwargs) -> None:
-        super().__init__(*args, **kwargs)
-        self.hard_check = hard_check
-
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-    ) -> Tuple[str, object]:
-        gt_df, gen_df = self._get_df(gt_implementation, implementation)
-        if gen_df is None:
-            return (
-                "The source dataframe is None. Please check the implementation.",
-                False,
-            )
-        concat_df = pd.concat([gen_df, gt_df], axis=1)
-        concat_df.columns = ["source", "gt"]
-        ic = concat_df.groupby("datetime").apply(lambda df: df["source"].corr(df["gt"])).dropna().mean()
-        ric = (
-            concat_df.groupby("datetime")
-            .apply(lambda df: df["source"].corr(df["gt"], method="spearman"))
-            .dropna()
-            .mean()
-        )
-
-        if self.hard_check:
-            if ic > 0.99 and ric > 0.99:
-                return (
-                    f"The dataframes are highly correlated. The ic is {ic:.6f} and the rankic is {ric:.6f}.",
-                    True,
-                )
-            else:
-                return (
-                    f"The dataframes are not sufficiently high correlated. The ic is {ic:.6f} and the rankic is {ric:.6f}. Investigate the factors that might be causing the discrepancies and ensure that the logic of the factor calculation is consistent.",
-                    False,
-                )
-        else:
-            return f"The ic is ({ic:.6f}) and the rankic is ({ric:.6f}).", ic
-
-
-class FactorValueEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        implementation: Workspace,
-        gt_implementation: Workspace,
-        version: int = 1,  # 1 for qlib factors and 2 for kaggle factors
-        **kwargs,
-    ) -> Tuple:
-        conclusions = []
-
-        # Initialize result variables
-        row_result = 0
-        index_result = 0
-        output_format_result = None
-        equal_value_ratio_result = 0
-        high_correlation_result = False
-        row_result = None
-
-        # Check if both dataframe has only one columns Mute this since factor task might generate more than one columns now
-        if version == 1:
-            feedback_str, _ = FactorSingleColumnEvaluator(self.scen).evaluate(implementation, gt_implementation)
-            conclusions.append(feedback_str)
-        elif version == 2:
-            input_shape = self.scen.input_shape
-            _, gen_df = self._get_df(gt_implementation, implementation)
-            if gen_df.shape[-1] > input_shape[-1]:
-                conclusions.append(
-                    "Output dataframe has more columns than input feature which is not acceptable in feature processing tasks. Please check the implementation to avoid generating too many columns. Consider this implementation as a failure."
-                )
-
-        feedback_str, inf_evaluate_res = FactorInfEvaluator(self.scen).evaluate(implementation, gt_implementation)
-        conclusions.append(feedback_str)
-
-        # Check if the index of the dataframe is ("datetime", "instrument")
-        feedback_str, _ = FactorOutputFormatEvaluator(self.scen).evaluate(implementation, gt_implementation)
-        conclusions.append(feedback_str)
-        if version == 1:
-            feedback_str, daily_check_result = FactorDatetimeDailyEvaluator(self.scen).evaluate(
-                implementation, gt_implementation
-            )
-            conclusions.append(feedback_str)
-        else:
-            daily_check_result = None
-
-        # Check dataframe format
-        if gt_implementation is not None:
-            feedback_str, row_result = FactorRowCountEvaluator(self.scen).evaluate(implementation, gt_implementation)
-            conclusions.append(feedback_str)
-
-            feedback_str, index_result = FactorIndexEvaluator(self.scen).evaluate(implementation, gt_implementation)
-            conclusions.append(feedback_str)
-
-            feedback_str, output_format_result = FactorMissingValuesEvaluator(self.scen).evaluate(
-                implementation, gt_implementation
-            )
-            conclusions.append(feedback_str)
-
-            feedback_str, equal_value_ratio_result = FactorEqualValueRatioEvaluator(self.scen).evaluate(
-                implementation, gt_implementation
-            )
-            conclusions.append(feedback_str)
-
-            if index_result > 0.99:
-                feedback_str, high_correlation_result = FactorCorrelationEvaluator(
-                    hard_check=True, scen=self.scen
-                ).evaluate(implementation, gt_implementation)
-            else:
-                high_correlation_result = False
-                feedback_str = "The source dataframe and the ground truth dataframe have different index. Give up comparing the values and correlation because it's useless"
-            conclusions.append(feedback_str)
-
-        # Combine all conclusions into a single string
-        conclusion_str = "\n".join(conclusions)
-
-        if gt_implementation is not None and (equal_value_ratio_result > 0.99) or high_correlation_result:
-            decision_from_value_check = True
-        elif (
-            row_result is not None
-            and row_result <= 0.99
-            or output_format_result is False
-            or daily_check_result is False
-            or inf_evaluate_res is False
-        ):
-            decision_from_value_check = False
-        else:
-            decision_from_value_check = None
-        return conclusion_str, decision_from_value_check
-
-
-class FactorFinalDecisionEvaluator(FactorEvaluator):
-    def evaluate(
-        self,
-        target_task: FactorTask,
-        execution_feedback: str,
-        value_feedback: str,
-        code_feedback: str,
-        **kwargs,
-    ) -> Tuple:
-        system_prompt = T(".prompts:evaluator_final_decision_v1_system").r(
-            scenario=(
-                self.scen.get_scenario_all_desc(target_task, filtered_tag="feature")
-                if self.scen is not None
-                else "No scenario description."
-            )
-        )
-        execution_feedback_to_render = execution_feedback
-
-        for _ in range(10):  # 10 times to split the content is enough
-            user_prompt = T(".prompts:evaluator_final_decision_v1_user").r(
-                factor_information=target_task.get_task_information(),
-                execution_feedback=execution_feedback_to_render,
-                code_feedback=code_feedback,
-                value_feedback=(
-                    value_feedback
-                    if value_feedback is not None
-                    else "No Ground Truth Value provided, so no evaluation on value is performed."
-                ),
-            )
-            if (
-                APIBackend().build_messages_and_calculate_token(
-                    user_prompt=user_prompt,
-                    system_prompt=system_prompt,
-                )
-                > APIBackend().chat_token_limit
-            ):
-                execution_feedback_to_render = execution_feedback_to_render[len(execution_feedback_to_render) // 2 :]
-            else:
-                break
-
-        # TODO:  with retry_context(retry_n=3, except_list=[KeyError]):
-        final_evaluation_dict = None
-        attempts = 0
-        max_attempts = 3
-
-        while attempts < max_attempts:
-            try:
-                api = APIBackend() if attempts == 0 else APIBackend(use_chat_cache=False)
-                final_evaluation_dict = json.loads(
-                    api.build_messages_and_create_chat_completion(
-                        user_prompt=user_prompt,
-                        system_prompt=system_prompt,
-                        json_mode=True,
-                        seed=attempts,  # in case of useless retrying when cache enabled.
-                        json_target_type=Dict[str, str | bool | int],
-                    ),
-                )
-                final_decision = final_evaluation_dict["final_decision"]
-                final_feedback = final_evaluation_dict["final_feedback"]
-
-                final_decision = str(final_decision).lower() in ["true", "1"]
-                return final_decision, final_feedback
-
-            except json.JSONDecodeError as e:
-                raise ValueError("Failed to decode JSON response from API.") from e
-            except KeyError as e:
-                attempts += 1
-                if attempts >= max_attempts:
-                    raise KeyError(
-                        "Response from API is missing 'final_decision' or 'final_feedback' key after multiple attempts."
-                    ) from e
-
-        return None, None

patches/factor_data_template_README.md

@@ -1,42 +0,0 @@
-# How to read files.
-For example, if you want to read `filename.h5`
-```Python
-import pandas as pd
-df = pd.read_hdf("filename.h5", key="data")
-```
-NOTE: **key is always "data" for all hdf5 files **.
-
-# Here is a short description about the data
-| Filename       | Description                                                      |
-| -------------- | -----------------------------------------------------------------|
-| "intraday_pv.h5"  | EURUSD 1-minute OHLCV intraday data (2020-2026).                 |
-
-# For different data, We have some basic knowledge for them
-
-## EURUSD 1min intraday data
-$open: open price of EURUSD at the start of the 1min bar.
-$close: close price of EURUSD at the end of the 1min bar.
-$high: highest price of EURUSD during the 1min bar.
-$low: lowest price of EURUSD during the 1min bar.
-$volume: traded volume during the 1min bar (tick volume for FX).
-
-**IMPORTANT: There is NO $factor column. Use only $open, $close, $high, $low, $volume.**
-
-## Market sessions (UTC)
-- Asian session: 00:00 - 08:00 (mean reversion tendencies)
-- London session: 08:00 - 16:00 (trending, momentum works)
-- NY session: 13:00 - 21:00 (high volatility)
-- London-NY overlap: 13:00 - 16:00 (highest volume)
-
-## Lookback reference for 1min data
-- 4 bars = 4 minutes
-- 8 bars = 8 minutes
-- 16 bars = 16 minutes
-- 32 bars = 32 minutes
-- 96 bars = 1.6 hours
-- 1440 bars = 1 day (24 hours)
-
-## Data range
-- Start: 2020-01-01 17:00:00 UTC
-- End: 2026-03-20 15:58:00 UTC
-- Total bars: ~2.26 million

patches/factor_proposal.py

@@ -1,132 +0,0 @@
-import json
-from typing import List, Tuple
-
-from rdagent.components.coder.factor_coder.factor import FactorExperiment, FactorTask
-from rdagent.components.proposal import FactorHypothesis2Experiment, FactorHypothesisGen
-from rdagent.core.proposal import Hypothesis, Scenario, Trace
-from rdagent.scenarios.qlib.experiment.factor_experiment import QlibFactorExperiment
-from rdagent.scenarios.qlib.experiment.model_experiment import QlibModelExperiment
-from rdagent.scenarios.qlib.experiment.quant_experiment import QlibQuantScenario
-from rdagent.utils.agent.tpl import T
-
-QlibFactorHypothesis = Hypothesis
-
-
-class QlibFactorHypothesisGen(FactorHypothesisGen):
-    def __init__(self, scen: Scenario) -> Tuple[dict, bool]:
-        super().__init__(scen)
-
-    def prepare_context(self, trace: Trace) -> Tuple[dict, bool]:
-        hypothesis_and_feedback = (
-            T("scenarios.qlib.prompts:hypothesis_and_feedback").r(
-                trace=trace,
-            )
-            if len(trace.hist) > 0
-            else "No previous hypothesis and feedback available since it's the first round."
-        )
-        last_hypothesis_and_feedback = (
-            T("scenarios.qlib.prompts:last_hypothesis_and_feedback").r(
-                experiment=trace.hist[-1][0], feedback=trace.hist[-1][1]
-            )
-            if len(trace.hist) > 0
-            else "No previous hypothesis and feedback available since it's the first round."
-        )
-
-        context_dict = {
-            "hypothesis_and_feedback": hypothesis_and_feedback,
-            "last_hypothesis_and_feedback": last_hypothesis_and_feedback,
-            "RAG": (
-                "Try EURUSD-specific FX factors: momentum (4-32 bars), mean reversion, ATR volatility, volume spikes, session-based signals. Use only $open $close $high $low $volume columns. No $factor column exists."
-                if len(trace.hist) < 15
-                else "Now, you need to try factors that can achieve high IC (e.g., machine learning-based factors)."
-            ),
-            "hypothesis_output_format": T("scenarios.qlib.prompts:factor_hypothesis_output_format").r(),
-            "hypothesis_specification": T("scenarios.qlib.prompts:factor_hypothesis_specification").r(),
-        }
-        return context_dict, True
-
-    def convert_response(self, response: str) -> Hypothesis:
-        response_dict = json.loads(response)
-        hypothesis = QlibFactorHypothesis(
-            hypothesis=response_dict.get("hypothesis"),
-            reason=response_dict.get("reason"),
-            concise_reason=response_dict.get("concise_reason"),
-            concise_observation=response_dict.get("concise_observation"),
-            concise_justification=response_dict.get("concise_justification"),
-            concise_knowledge=response_dict.get("concise_knowledge"),
-        )
-        return hypothesis
-
-
-class QlibFactorHypothesis2Experiment(FactorHypothesis2Experiment):
-    def prepare_context(self, hypothesis: Hypothesis, trace: Trace) -> Tuple[dict | bool]:
-        if isinstance(trace.scen, QlibQuantScenario):
-            scenario = trace.scen.get_scenario_all_desc(action="factor")
-        else:
-            scenario = trace.scen.get_scenario_all_desc()
-
-        experiment_output_format = T("scenarios.qlib.prompts:factor_experiment_output_format").r()
-
-        if len(trace.hist) == 0:
-            hypothesis_and_feedback = "No previous hypothesis and feedback available since it's the first round."
-        else:
-            specific_trace = Trace(trace.scen)
-            for i in range(len(trace.hist) - 1, -1, -1):
-                if not hasattr(trace.hist[i][0].hypothesis, "action") or trace.hist[i][0].hypothesis.action == "factor":
-                    specific_trace.hist.insert(0, trace.hist[i])
-            if len(specific_trace.hist) > 0:
-                specific_trace.hist.reverse()
-                hypothesis_and_feedback = T("scenarios.qlib.prompts:hypothesis_and_feedback").r(
-                    trace=specific_trace,
-                )
-            else:
-                hypothesis_and_feedback = "No previous hypothesis and feedback available."
-
-        return {
-            "target_hypothesis": str(hypothesis),
-            "scenario": scenario,
-            "hypothesis_and_feedback": hypothesis_and_feedback,
-            "experiment_output_format": experiment_output_format,
-            "target_list": [],
-            "RAG": None,
-        }, True
-
-    def convert_response(self, response: str, hypothesis: Hypothesis, trace: Trace) -> FactorExperiment:
-        response_dict = json.loads(response)
-        tasks = []
-
-        for factor_name in response_dict:
-            description = response_dict[factor_name]["description"]
-            formulation = response_dict[factor_name]["formulation"]
-            variables = response_dict[factor_name]["variables"]
-            tasks.append(
-                FactorTask(
-                    factor_name=factor_name,
-                    factor_description=description,
-                    factor_formulation=formulation,
-                    variables=variables,
-                )
-            )
-
-        exp = QlibFactorExperiment(tasks, hypothesis=hypothesis)
-        exp.based_experiments = [QlibFactorExperiment(sub_tasks=[])] + [
-            t[0] for t in trace.hist if t[1] and isinstance(t[0], FactorExperiment)
-        ]
-
-        unique_tasks = []
-        for task in tasks:
-            duplicate = False
-            for based_exp in exp.based_experiments:
-                if isinstance(based_exp, QlibModelExperiment):
-                    continue
-                for sub_task in based_exp.sub_tasks:
-                    if task.factor_name == sub_task.factor_name:
-                        duplicate = True
-                        break
-                if duplicate:
-                    break
-            if not duplicate:
-                unique_tasks.append(task)
-
-        exp.tasks = unique_tasks
-        return exp

patches/generate.py

@@ -1,21 +0,0 @@
-import subprocess
-import sys
-import os
-
-# Qlib läuft in rdagent4qlib environment
-result = subprocess.run(
-    ["/home/nico/miniconda3/envs/rdagent4qlib/bin/python3", "-c", """
-import qlib
-from qlib.data import D
-qlib.init(provider_uri="~/.qlib/qlib_data/eurusd_1min_data")
-fields = ["$open", "$close", "$high", "$low", "$volume"]
-data = (D.features(["EURUSD"], fields, start_time="2022-03-14", end_time="2026-03-20", freq="1min")
-        .swaplevel().sort_index())
-data.to_hdf("./intraday_pv_all.h5", key="data")
-data_debug = (D.features(["EURUSD"], fields, start_time="2024-01-01", end_time="2026-03-20", freq="1min")
-              .swaplevel().sort_index())
-data_debug.to_hdf("./intraday_pv_debug.h5", key="data")
-print(f"Done: {data.shape[0]} rows")
-"""],
-    capture_output=False
-)

patches/qlib_experiment_prompts.yaml

@@ -1,257 +0,0 @@
-qlib_quant_background: |-
-  Quantitative investment is a data-driven approach to asset management that relies on mathematical models, statistical techniques, and computational methods to analyze financial markets and make investment decisions. Two essential components of this approach are factors and models.
-  
-  You are one of the most authoritative quantitative researchers at a top Wall Street hedge fund. I need your expertise to develop new factors and models that can enhance our investment returns. Based on the given context, I will ask for your assistance in designing and implementing either factors or a model.
-
-  {% if runtime_environment is not none %}
-  ====== Runtime Environment ======
-  You have following environment to run the code:
-  {{ runtime_environment }}
-  {% endif %}
-
-qlib_factor_background: |-
-  The factor is a characteristic or variable used in quant investment that can help explain the returns and risks of a portfolio or a single asset. Factors are used by investors to identify and exploit sources of excess returns, and they are central to many quantitative investment strategies.
-  Each number in the factor represents a physics value to an instrument on a day.
-  User will train a model to predict the next several days return based on the factor values of the previous days.
-  The factor is defined in the following parts:
-  1. Name: The name of the factor.
-  2. Description: The description of the factor.
-  3. Formulation: The formulation of the factor.
-  4. Variables: The variables or functions used in the formulation of the factor.
-  The factor might not provide all the parts of the information above since some might not be applicable.
-  Please specifically give all the hyperparameter in the factors like the window size, look back period, and so on. One factor should statically defines one output with a static source data. For example, last 10 days momentum and last 20 days momentum should be two different factors.
-
-  {% if runtime_environment is not none %}
-  ====== Runtime Environment ======
-  You have following environment to run the code:
-  {{ runtime_environment }}
-  {% endif %}
-
-qlib_factor_interface: |-
-  Your python code should follow the interface to better interact with the user's system.
-  CRITICAL DATA FORMAT: The HDF5 file has a MultiIndex with levels ['datetime', 'instrument']. The instrument is an INDEX LEVEL, NOT a column. Never use df['instrument']. Always use df.index.get_level_values('instrument') or df.groupby(level='instrument'). For rolling calculations use df['$close'].unstack(level='instrument'), apply rolling, then .stack() to restore MultiIndex.
-  Your python code should contain the following part: the import part, the function part, and the main part. You should write a main function name: "calculate_{function_name}" and call this function in "if __name__ == __main__" part. Don't write any try-except block in your python code. The user will catch the exception message and provide the feedback to you.
-  User will write your python code into a python file and execute the file directly with "python {your_file_name}.py". You should calculate the factor values and save the result into a HDF5(H5) file named "result.h5" in the same directory as your python file. The result file is a HDF5(H5) file containing a pandas dataframe. The index of the dataframe is the "datetime" and "instrument", and the single column name is the factor name,and the value is the factor value. The result file should be saved in the same directory as your python file.
-
-qlib_factor_strategy: |-
-  Ensure that for every step of data processing, the data format (including indexes) is clearly explained through comments.
-  Each transformation or calculation should be accompanied by a detailed description of how the data is structured, especially focusing on key aspects like whether the data has multi-level indexing, how to access specific columns or index levels, and any operations that affect the data shape (e.g., `reset_index()`, `groupby()`, `merge()`).
-  This step-by-step explanation will ensure clarity and accuracy in data handling. For example:
-  1. **Start with multi-level index**:  
-    ```python
-    # The initial DataFrame has a multi-level index with 'datetime' and 'instrument'.
-    # To access the 'datetime' index, use df.index.get_level_values('datetime').
-    datetime_values = df.index.get_level_values('datetime')
-    ```
- 
-  2. **Reset the index if necessary**:  
-    ```python
-    # Resetting the index to move 'datetime' and 'instrument' from the index to columns.
-    # This operation flattens the multi-index structure.
-    df = df.reset_index()
-    ```
- 
-  3. **Perform groupby operations**:  
-    ```python
-    # Grouping by 'datetime' and 'instrument' to aggregate the data.
-    # After groupby, the result will maintain 'datetime' and 'instrument' as a multi-level index.
-    df_grouped = df.groupby(['datetime', 'instrument']).sum()
-    ```
- 
-  4. **Ensure consistent datetime formats**:  
-    ```python
-    # Before merging, ensure that the 'datetime' column in both DataFrames is of the same format.
-    # Convert to datetime format if necessary.
-    df['datetime'] = pd.to_datetime(df['datetime'])
-    other_df['datetime'] = pd.to_datetime(other_df['datetime'])
-    ```
- 
-  5. **Merge operations**:  
-    ```python
-    # When merging DataFrames, ensure you are merging on both 'datetime' and 'instrument'.
-    # If these are part of the index, reset the index before merging.
-    merged_df = pd.merge(df, other_df, on=['datetime', 'instrument'], how='inner')
-    ```
-
-qlib_factor_output_format: |-
-  Your output should be a pandas dataframe similar to the following example information:
-  <class 'pandas.core.frame.DataFrame'>
-  MultiIndex: 2261923 entries, (Timestamp('2020-01-01 17:00:00'), 'EURUSD') to (Timestamp('2026-03-20 15:58:00'), 'EURUSD')
-  Data columns (total 1 columns):
-  #   Column            Non-Null Count  Dtype  
-  ---  ------            --------------  -----  
-  0   your factor name  2261923 non-null  float64
-  dtypes: float64(1)
-  memory usage: <ignore>
-  Notice: The non-null count is OK to be different to the total number of entries since some instruments may not have the factor value on some days.
-  One possible format of `result.h5` may be like following:
-  datetime    instrument
-  2020-01-01  EURUSD    1.094240
-  2020-01-02  EURUSD    1.094280
-  2020-01-03  EURUSD    1.095920
-                ...
-  2026-03-20  EURUSD    1.083150
-
-qlib_factor_simulator: |-
-  The factors will be sent into Qlib to train a model to predict the next several days return based on the factor values of the previous days. 
-  Qlib is an AI-oriented quantitative investment platform that aims to realize the potential, empower research, and create value using AI technologies in quantitative investment, from exploring ideas to implementing productions. Qlib supports diverse machine learning modeling paradigms. including supervised learning, market dynamics modeling, and RL.
-  User will use Qlib to automatically do the following things:
-  1. generate a new factor table based on the factor values.
-  2. train a model like LightGBM, CatBoost, LSTM or simple PyTorch model to predict the next several days return based on the factor values.
-  3. build a portfolio based on the predicted return based on a strategy.
-  4. evaluate the portfolio's performance including the return, sharpe ratio, max drawdown, and so on.
-
-qlib_factor_rich_style_description : |-
-  ### R&D Agent-Qlib: Automated Quantitative Trading & Iterative Factors Evolution Demo
-
-  #### [Overview](#_summary)
-
-  The demo showcases the iterative process of hypothesis generation, knowledge construction, and decision-making. It highlights how financial factors evolve through continuous feedback and refinement.
-
-  #### [Automated R&D](#_rdloops)
-
-  - **[R (Research)](#_research)**
-    - Iterative development of ideas and hypotheses.
-    - Continuous learning and knowledge construction.
-
-  - **[D (Development)](#_development)**
-    - Progressive implementation and code generation of factors.
-    - Automated testing and validation of financial factors.
-
-  #### [Objective](#_summary)
-
-  To demonstrate the dynamic evolution of financial factors through the Qlib platform, emphasizing how each iteration enhances the accuracy and reliability of the resulting financial factors.
-
-qlib_factor_from_report_rich_style_description : |-
-  ### R&D Agent-Qlib: Automated Quantitative Trading & Factor Extraction from Financial Reports Demo
-
-  #### [Overview](#_summary)
-
-  This demo showcases the process of extracting factors from financial research reports, implementing these factors, and analyzing their performance through Qlib backtest, continually expanding and refining the factor library.
-
-  #### [Automated R&D](#_rdloops)
-
-  - **[R (Research)](#_research)**
-    - Iterative development of ideas and hypotheses from financial reports.
-    - Continuous learning and knowledge construction.
-
-  - **[D (Development)](#_development)**
-    - Progressive factor extraction and code generation.
-    - Automated implementation and testing of financial factors.
-
-  #### [Objective](#_summary)
-
-  <table border="1" style="width:100%; border-collapse: collapse;">
-    <tr>
-      <td>💡 <strong>Innovation </strong></td>
-      <td>Tool to quickly extract and test factors from research reports.</td>
-    </tr>
-    <tr>
-      <td>⚡ <strong>Efficiency </strong></td>
-      <td>Rapid identification of valuable factors from numerous reports.</td>
-    </tr>
-    <tr>
-      <td>🗃️ <strong>Outputs </strong></td>
-      <td>Expand and refine the factor library to support further research.</td>
-    </tr>
-  </table>
-
-qlib_factor_experiment_setting: |-
-  | Dataset 📊 | Model 🤖    | Factors 🌟       | Data Split  🧮                                   |
-  |---------|----------|---------------|-------------------------------------------------|
-  | EURUSD  | LGBModel | Alpha158 Plus | Train: 2022-01-01 to 2024-06-30 <br> Valid: 2024-07-01 to 2024-12-31 <br> Test &nbsp;: 2025-01-01 to 2026-03-20 |
-
-
-qlib_model_background: |-
-  The model is a machine learning or deep learning structure used in quantitative investment to predict the returns and risks of a portfolio or a single asset. Models are employed by investors to generate forecasts based on historical data and identified factors, which are central to many quantitative investment strategies.
-  Each model takes the factors as input and predicts the future returns. Usually, the bigger the model is, the better the performance would be.
-  The model is defined in the following parts:
-  1. Name: The name of the model.
-  2. Description: The description of the model.
-  3. Architecture: The detailed architecture of the model, such as neural network layers or tree structures.
-  4. Hyperparameters: The hyperparameters used in the model.
-  5. Training_hyperparameters: The hyperparameters used during the training process.
-  6. ModelType: The type of the model, "Tabular" for tabular model and "TimeSeries" for time series model.
-  The model should provide clear and detailed documentation of its architecture and hyperparameters. One model should statically define one output with a fixed architecture and hyperparameters.
-
-  {% if runtime_environment is not none %}
-  ====== Runtime Environment ======
-  You have following environment to run the code:
-  {{ runtime_environment }}
-  {% endif %}
-
-qlib_model_interface: |-
-  Your python code should follow the interface to better interact with the user's system.
-  You code should contain several parts:
-  1. The import part: import the necessary libraries.
-  2. A class which is a sub-class of pytorch.nn.Module. This class should should have a init function and a forward function which inputs a tensor and outputs a tensor.
-  3. Set a variable called "model_cls" to the class you defined.
-
-  The user will save your code into a python file called "model.py". Then the user imports model_cls in file "model.py" after setting the cwd into the directory:
-  ```python
-  from model import model_cls
-  ```
-  So your python code should follow the pattern:
-  ```python
-  class XXXModel(torch.nn.Module):
-      ...
-  model_cls = XXXModel
-  ```
-
-  The model can be configured as either "Tabular" for tabular models or "TimeSeries" for time series models. For a tabular model, the input shape is (batch_size, num_features), while for a time series model, the input shape is (batch_size, num_timesteps, num_features). In both cases, the output shape of the model should be (batch_size, 1).
-  `num_features` will be directly set for the model based on the input data shape.
-  User will initialize the tabular model with the following code:
-  ```python
-  model = model_cls(num_features=num_features)
-  ```
-  User will initialize the time series model with the following code:
-  ```python
-  model = model_cls(num_features=num_features, num_timesteps=num_timesteps)
-  ```
-  No other parameters will be passed to the model so give other parameters a default value or just make them static.
-
-  Don't write any try-except block in your python code. The user will catch the exception message and provide the feedback to you. Also, don't write main function in your python code. The user will call the forward method in the model_cls to get the output tensor.
-
-  Please notice that your model should only use current features as input. The user will provide the input tensor to the model's forward function.
-
-
-qlib_model_output_format: |-
-  Your output should be a tensor with shape (batch_size, 1). 
-  The output tensor should be saved in a file named "output.pth" in the same directory as your python file.
-  The user will evaluate the shape of the output tensor so the tensor read from "output.pth" should be 8 numbers.
-
-qlib_model_simulator: |-
-  The models will be sent into Qlib to train and evaluate their performance in predicting future returns. Hypothesis is improved upon checking the feedback on the results. 
-  Qlib is an AI-oriented quantitative investment platform that aims to realize the potential, empower research, and create value using AI technologies in quantitative investment, from exploring ideas to implementing productions. Qlib supports diverse machine learning modeling paradigms, including supervised learning, market dynamics modeling, and reinforcement learning (RL).
-  User will use Qlib to automatically perform the following tasks:
-  1. Generate a baseline factor table.
-  2. Train the model defined in your class Net to predict the next several days' returns based on the factor values.
-  3. Build a portfolio based on the predicted returns using a specific strategy.
-  4. Evaluate the portfolio's performance, including metrics such as return, IC, max drawdown, and others.
-  5. Iterate on growing the hypothesis to enable model improvements based on performance evaluations and feedback.
-
-qlib_model_rich_style_description: |-
-  ### Qlib Model Evolving Automatic R&D Demo
-  
-  #### [Overview](#_summary)
-  
-  The demo showcases the iterative process of hypothesis generation, knowledge construction, and decision-making in model construction in quantitative finance. It highlights how models evolve through continuous feedback and refinement.
-  
-  #### [Automated R&D](#_rdloops)
-  
-  - **[R (Research)](#_research)**
-    - Iteration of ideas and hypotheses.
-    - Continuous learning and knowledge construction.
-  
-  - **[D (Development)](#_development)**
-    - Evolving code generation and model refinement.
-    - Automated implementation and testing of models.
-  
-  #### [Objective](#_summary)
-  
-  To demonstrate the dynamic evolution of models through the Qlib platform, emphasizing how each iteration enhances the accuracy and reliability of the resulting models. 
-
-qlib_model_experiment_setting: |-
-  | Dataset 📊 | Model 🤖    | Factors 🌟       | Data Split  🧮                                   |
-  |---------|----------|---------------|-------------------------------------------------|
-  | EURUSD  | RDAgent-dev | 20 factors (Alpha158)  | Train: 2022-01-01 to 2024-06-30 <br> Valid: 2024-07-01 to 2024-12-31 <br> Test &nbsp;: 2025-01-01 to 2026-03-20 |

patches/qlib_rd_loop_prompts.yaml

@@ -1,23 +0,0 @@
-hypothesis_generation:
-  system: |-
-    You are an expert in FX and quantitative trading, specialized in EURUSD intraday strategies.
-    Your task is to generate a well-reasoned hypothesis for new alpha factors based on EURUSD 1min OHLCV data.
-    
-    Key market knowledge:
-    - EURUSD trades 24h with three main sessions: Asian (00:00-08:00 UTC), London (08:00-16:00 UTC), NY (13:00-21:00 UTC)
-    - London-NY overlap (13:00-16:00 UTC) has highest volume and momentum
-    - Asian session shows mean reversion tendencies
-    - Spread costs approximately 1.5 bps per trade — avoid overtrading
-    - No overnight gap risk like stocks, but weekend gaps exist
-    - Volume spikes signal news events (NFP, ECB, Fed)
-    
-    Please ensure your response is in JSON format as shown below:
-    {
-      "hypothesis": "A clear and concise hypothesis based on the provided information.",
-      "reason": "A detailed explanation supporting the generated hypothesis.",
-    }
-  user: |-
-    The following are the financial factors and their descriptions:
-    {{ factor_descriptions }}
-    The report content is as follows:
-    {{ report_content }}

patches/qlib_scenarios_prompts.yaml

@@ -1,312 +0,0 @@
-hypothesis_and_feedback: |-
-  =========================================================
-  {% for experiment, feedback in trace.hist %}
-  # Trial {{ loop.index }}: 
-  ## Hypothesis
-  {{ experiment.hypothesis }}
-  ## Specific task: 
-  {% for task in experiment.sub_tasks %}
-  {% if task is not none and task.get_task_brief_information is defined %}
-  {{ task.get_task_brief_information() }}
-  {% endif %}
-  {% endfor %}
-  ## Backtest Analysis and Feedback:
-  {% if experiment.result is not none %}
-  Backtest Result: {{ experiment.result.loc[["IC", "1day.excess_return_without_cost.annualized_return", "1day.excess_return_without_cost.max_drawdown"]] }}
-  {% endif %}
-  Observation: {{ feedback.observations }}
-  Hypothesis Evaluation: {{ feedback.hypothesis_evaluation }}
-  Decision (Whether the hypothesis was successful): {{ feedback.decision }}
-  =========================================================
-  {% endfor %}
-
-last_hypothesis_and_feedback: |-
-  ## Hypothesis
-  {{ experiment.hypothesis }}
-  ## Specific task: 
-  {% for task in experiment.sub_tasks %}
-  {% if task is not none and task.get_task_brief_information is defined %}
-  {{ task.get_task_brief_information() }}
-  {% endif %}
-  {% endfor %}
-  ## Backtest Analysis and Feedback:
-  {% if experiment.result is not none %}
-  Backtest Result: {{ experiment.result.loc[["IC", "1day.excess_return_without_cost.annualized_return", "1day.excess_return_without_cost.max_drawdown"]] }}
-  {% endif %}
-  Training Log: 
-  Here, you need to focus on analyzing whether there are any issues with the training. If any problems are identified, you must correct them in the next iteration and clearly describe how the changes will be made in the hypothesis.
-  {{ experiment.stdout }} 
-  Observation: {{ feedback.observations }}
-  Evaluation: {{ feedback.hypothesis_evaluation }}
-  Decision (Whether this experiment is SOTA): {{ feedback.decision }}
-  New Hypothesis (Given in feedback stage, just for reference, and can be accepted or rejected in the next round): {{ feedback.new_hypothesis }}
-  Reasoning (Justification for the new hypothesis): {{ feedback.reason }}
-
-sota_hypothesis_and_feedback: |-
-  ## Hypothesis
-  {{ experiment.hypothesis }}
-  ## Specific task: 
-  {% for task in experiment.sub_tasks %}
-  {% if task is not none and task.get_task_brief_information is defined %}
-  {{ task.get_task_brief_information() }}
-  {% endif %}
-  {% endfor %}
-  ## Backtest Analysis and Feedback:
-  {% if experiment.result is not none %}
-  Backtest Result: {{ experiment.result.loc[["IC", "1day.excess_return_without_cost.annualized_return", "1day.excess_return_without_cost.max_drawdown"]] }}
-  {% endif %}
-  Training Log: {{ experiment.stdout }}
-  Observation: {{ feedback.observations }}
-  Evaluation: {{ feedback.hypothesis_evaluation }}
-  Decision (Whether this experiment is SOTA): {{ feedback.decision }}
-
-hypothesis_output_format: |-
-  The output should follow JSON format. The schema is as follows:
-  {
-  "hypothesis": "An exact, testable, and innovative statement derived from previous experimental trace analysis. Avoid overly general ideas and ensure precision. The hypothesis should clearly specify the exact approach and expected improvement in performance in two or three sentences.",
-  "reason": "Provide a clear, logical explanation for why this hypothesis was proposed, grounded in evidence (e.g., trace history, domain principles). Reason should be short with no more than two sentences.",
-  }
-
-factor_hypothesis_output_format: |-
-  The output should follow JSON format. The schema is as follows:
-  {
-  "hypothesis": "The new hypothesis generated based on the information provided. Limit in two or three sentences.",
-  "reason": "The reason why you generate this hypothesis. It should be comprehensive and logical. It should cover the other keys below and extend them. Limit in two or three sentences.",
-  }
-
-hypothesis_output_format_with_action: |-
-  The output should follow JSON format. The schema is as follows:
-  {
-  "action": "If `hypothesis_specification` provides the action you need to take, please follow "hypothesis_specification" to choose the action. Otherwise, based on previous experimental results, suggest the action you believe is most appropriate at the moment. It should be one of [`factor`, `model`].",
-  "hypothesis": "The new hypothesis generated based on the information provided,should be a string.",
-  "reason": "The reason why you generate this hypothesis. It should be comprehensive and logical. It should cover the other keys below and extend them. Limit in two or three sentences.",
-  }
-
-model_hypothesis_specification: |-
-  1. First, observe and analyze the overall experimental progression in `hypothesis_and_feedback`. Analyze where the previous model designs were inadequate — whether it was due to parameter settings, architectural flaws, or a lack of novelty (proposing entirely new concepts is highly encouraged as long as they demonstrate effectiveness).
-  2. Second, `last_hypothesis_and_feedback` and `sota_hypothesis_and_feedback` are key references you should pay close attention to. You can choose to optimize based on either of them or generate new ideas to form hypotheses and experiments.
-  3. If there is no prior experiment or result available at the beginning, you can start by implementing a simple and small architecture.
-  4. If a series of attempts fail to achieve SOTA, consider exploring entirely new directions; at this point, it is acceptable to return to simple architectures.
-  5. Focus exclusively on the architecture of PyTorch models. Each hypothesis should specifically address architectural decisions, such as layer configurations, activation functions, regularization methods, and overall model structure. DO NOT do any feature-specific processing. Instead, you can propose innovative transformations on the input time-series data to enhance model training effectiveness.
-  6. Avoid including aspects unrelated to architecture, such as input features or optimization strategies.
-  7. Sometimes, when training performance is poor, adjusting hyperparameters can also be an effective strategy for improvement.
-  8. Use standard libraries for baseline models, but also explore custom architecture designs to investigate novel structures. After sufficient trials with traditional models, aim for innovation comparable to top-tier AI conferences (NeurIPS, ICLR, ICML, SIGKDD, etc.) in time series modeling.
-
-factor_hypothesis_specification: |-
-  You are developing alpha factors for EURUSD intraday trading using 1-MINUTE OHLCV bars.
-
-  **Market Context:**
-  - EURUSD trades 24h with three sessions: Asian (00:00-08:00 UTC), London (08:00-16:00 UTC), NY (13:00-21:00 UTC)
-  - London-NY overlap (13:00-16:00 UTC) has highest volume and trending behavior
-  - Asian session shows mean reversion tendencies
-  - Spread cost ~1.5 bps per trade — avoid high-turnover factors
-  - No $factor column exists — use only $open, $close, $high, $low, $volume
-  - Each "instrument" is EURUSD, each "day" has 96 bars (24h * 60min = 1440 minutes / 15min bars was wrong, correct is 1440 1min bars)
-  - Bar interpretation: 4 bars = 4 minutes, 16 bars = 16 minutes, 96 bars = 1.6 hours
-
-  **Factor Generation Rules:**
-  1. **3-5 Factors per Generation** — cover different signal types per round
-  2. **FX-Specific Signals First:**
-    - Momentum: price change over last N bars (N=4,8,16,32 = 1h,2h,4h,8h)
-    - Mean Reversion: deviation from rolling mean, Bollinger Band position
-    - Volatility: ATR, realized vol, high-low range normalized
-    - Volume: volume spike ratio, volume trend
-    - Session: time-of-day encoded signals (London open, NY open)
-  3. **Gradual Complexity:**
-    - Rounds 1-5: single indicators (RSI, momentum, ATR)
-    - Rounds 6-15: combined signals (momentum + volume filter)
-    - Rounds 15+: ML-based factors (LSTM embeddings, XGBoost residuals)
-  4. **Avoid:**
-    - Factors requiring $factor column
-    - Daily-frequency assumptions (no overnight gaps in logic)
-    - Factors with >100 bar lookback without justification
-  5. No matter how many factors you plan to generate, only reply with one set of hypothesis and reason.
-
-factor_experiment_output_format: |-
-  The output should follow JSON format. The schema is as follows:
-  {
-      "factor name 1": {
-          "description": "description of factor 1, start with its type, e.g. [Momentum Factor]",
-          "formulation": "latex formulation of factor 1",
-          "variables": {
-              "variable or function name 1": "description of variable or function 1",
-              "variable or function name 2": "description of variable or function 2"
-          }
-      },
-      "factor name 2": {
-          "description": "description of factor 2, start with its type, e.g. [Machine Learning based Factor]",
-          "formulation": "latex formulation of factor 2",
-          "variables": {
-              "variable or function name 1": "description of variable or function 1",
-              "variable or function name 2": "description of variable or function 2"
-          }
-      }
-      # Don't add ellipsis (...) or any filler text that might cause JSON parsing errors here!
-  }
-
-model_experiment_output_format: |-
-  So far please only design one model to test the hypothesis! 
-  The output should follow JSON format. The schema is as follows (value in training_hyperparameters is a basic setting for reference, you CAN CHANGE depends on the previous training log): 
-  {
-    "model_name (The name of the model)": {
-        "description": "A detailed description of the model",
-        "formulation": "A LaTeX formula representing the model's formulation",
-        "architecture": "A detailed description of the model's architecture, e.g., neural network layers or tree structures",
-        "variables": {
-            "\\hat{y}_u": "The predicted output for node u",
-            "variable_name_2": "Description of variable 2",
-            "variable_name_3": "Description of variable 3"
-        },
-        "hyperparameters": {
-            "hyperparameter_name_1": "value of hyperparameter 1",
-            "hyperparameter_name_2": "value of hyperparameter 2",
-            "hyperparameter_name_3": "value of hyperparameter 3"
-        },
-        "training_hyperparameters" {  # All values are for reference; you can set them yourself
-            "n_epochs": "100",
-            "lr": "1e-3",
-            "early_stop": 10,
-            "batch_size": 256,
-            "weight_decay": 1e-4,
-        }
-        "model_type": "Tabular or TimeSeries"  # Should be one of "Tabular" or "TimeSeries"
-    },
-  }
-
-factor_feedback_generation:
-  system: |-
-    You are a professional FX quantitative analyst specializing in EURUSD intraday strategies.
-    The task is described in the following scenario:
-
-    {{ scenario }}
-
-    You will receive a hypothesis, multiple tasks with their factors, their results, and the SOTA result.
-    Your feedback should specify whether the current result supports or refutes the hypothesis, compare it with previous SOTA results, and suggest FX-specific improvements.
-
-    **FX-specific evaluation criteria:**
-    - IC > 0.02 is meaningful for 1min EURUSD data
-    - Annualized return target: >9.62% (current SOTA to beat)
-    - Spread cost ~1.5 bps per trade — penalize high-turnover factors
-    - Factors using $factor column are INVALID — only $open $close $high $low $volume allowed
-    - Session-aware factors (London/NY) tend to outperform session-agnostic ones
-    - Mean reversion works in Asian session, momentum in London-NY overlap
-
-    Please understand the following operation logic:
-      1. Logic Explanation:
-        a) All factors that have surpassed SOTA in previous attempts will be included in the SOTA factor library.
-        b) New experiments will generate new factors, combined with the SOTA library factors.
-        c) These combined factors will be backtested and compared against current SOTA.
-      2. Development Directions:
-        a) New Direction: Propose a new FX-specific factor (session filter, volatility regime, volume spike).
-        b) Optimization: Refine lookback windows (4/8/16/32 bars), add ADX filter, adjust for spread costs.
-      3. Final Goal: Beat 9.62% ARR on EURUSD 1min with controlled drawdown (<20%).
-
-    When judging results:
-      1. Any small improvement in annualized return → set Replace Best Result as yes.
-      2. If IC < 0 consistently → factor has no predictive power, change direction entirely.
-      3. High turnover with low return → add volume or volatility filter to reduce trade frequency.
-
-    Respond in JSON format:
-    {
-      "Observations": "Your overall observations here",
-      "Feedback for Hypothesis": "Observations related to the hypothesis",
-      "New Hypothesis": "Your new FX-specific hypothesis here",
-      "Reasoning": "Reasoning for the new hypothesis",
-      "Replace Best Result": "yes or no"
-    }
-  user: |-
-    Target hypothesis: 
-    {{ hypothesis_text }}
-    Tasks and Factors:
-    {% for task in task_details %}
-      - {{ task.factor_name }}: {{ task.factor_description }}
-        - Factor Formulation: {{ task.factor_formulation }}
-        - Variables: {{ task.variables }}
-        - Factor Implementation: {{ task.factor_implementation }}
-        {% if task.factor_implementation == "False" %}
-        **Note: This factor was not implemented in the current experiment. Only the hypothesis for implemented factors can be verified.**
-        {% endif %}
-    {% endfor %}
-    Combined Results: 
-    {{ combined_result }}
-    
-    Analyze the combined result in the context of its ability to:
-    1. Support or refute the hypothesis.
-    2. Show improvement or deterioration compared to the SOTA experiment.
-    
-    Note: Only factors with 'Factor Implementation' as True are implemented and tested in this experiment. If 'Factor Implementation' is False, the hypothesis for that factor cannot be verified in this run.
-
-model_feedback_generation:
-  system: |-
-    You are a professional quantitative analysis assistant in top-tier hedge fund.
-
-    The task is described in the following scenario:
-    {{ scenario }}
-
-    You will receive a quantitative model hypothesis, its specific task description, and it market backtest result. 
-    Your feedback should specify whether the current result supports or refutes the hypothesis, compare it with previous SOTA results, examine the model's training logs to analyze whether there are issues with hyperparameter settings, and suggest improvements or new directions.
-
-    Please provide detailed and constructive feedback.
-    Example JSON Structure for Result Analysis:
-    {
-      "Observations": "First analyze the model's training logs to determine whether there are any issues with its parameter settings. Then clearly summarize the current results and the SOTA results with exact scores and any notable patterns. Limit your summary to no more than three concise, data-focused sentences.",
-      "Feedback for Hypothesis": "Explicitly confirm or refute the hypothesis based on specific data points or performance trends. Limit to two sentences.",
-      "New Hypothesis": "Propose a revised hypothesis, considering observed patterns and limitations in the current one. Limit to no more than two sentences.",
-      "Reasoning": "Explain the rationale for the new hypothesis using specific trends or performance shifts. Be concise but technically complete. Limit to two sentences.",
-      "Decision": <true or false>,
-    }
-
-    
-  user: |-
-    {% if sota_hypothesis %} 
-    # SOTA Round Information:
-    Hypothesis: {{ sota_hypothesis.hypothesis }}
-    Specific Task: {{ sota_task }}
-    Code Implementation: {{ sota_code }}
-    Result: {{ sota_result }}
-    {% else %}
-    # This is the first round. No previous information available. As long as the performance is not too negative (eg.ICIR is greater than 0), treat it as successful. Do not set the threshold too high.  
-    {% endif %} 
-    
-    # Current Round Information:
-    Hypothesis: {{ hypothesis.hypothesis }}
-    Why propose this hypothesis: {{ hypothesis.reason }}
-    Specific Task: {{ exp.sub_tasks[0].get_task_information() }}
-    Code Implementation: {{ exp.sub_workspace_list[0].file_dict.get("model.py") }}
-    Training Log: {{ exp.stdout }}
-    Result: {{ exp_result }}
-
-    # When judging the results:
-    1. **Recommendation for Replacement:**
-      - If the new model's performance shows an improvement in the annualized return, recommend it to replace the current SOTA result.
-      - Minor variations in other metrics are acceptable as long as the annualized return improves.
-    2.  Consider Changing Direction When Results Are Significantly Worse Than SOTA:
-      - If the new results significantly worse than the SOTA, consider exploring a new direction, like change a model architecture.
-
-action_gen:
-  system: |-
-    Quantitative investment is a data-driven approach to asset management that relies on mathematical models, statistical techniques, and computational methods to analyze financial markets and make investment decisions. Two essential components of this approach are factors and models.
-  
-    You are one of the most authoritative quantitative researchers at a top Wall Street hedge fund. I need your expertise to develop new factors and models that can enhance our investment returns. Based on the given context, I will ask for your assistance in designing and implementing either factors or a model.
-
-    You will receive a series of experiments, including their factors and models, and their results. 
-    Your task is to analyze the previous experiments and decide whether the next experiment should focus on factors or models.
-
-    Example JSON Structure for your return:
-    {
-      "action": "factor" or "model",  # You must choose one of the two
-    }
-
-  user: |-
-    {% if hypothesis_and_feedback|length == 0 %}
-    It is the first round of hypothesis generation. The user has no hypothesis on this scenario yet.
-    {% else %}
-    The former hypothesis and the corresponding feedbacks are as follows:
-    {{ hypothesis_and_feedback }}
-    {% endif %}
-
-  
-    {% if last_hypothesis_and_feedback != "" %}
-    Here is the last trial's hypothesis and the corresponding feedback. The main feedback includes a new hypothesis for your reference only. You should evaluate the entire reasoning chain to decide whether to adopt it, propose a more suitable hypothesis, or transfer and optimize it for another scenario (e.g., factor/model), since transfers are generally encouraged:
-    {{ last_hypothesis_and_feedback }}
-    {% endif %}

prompts/INDEX.md

@@ -1,87 +0,0 @@
-# Predix Prompts Index
-
-Centralized location for all LLM prompts used in the Predix trading system.
-
-## Structure
-
-```
-prompts/
-├── standard_prompts.yaml          # Main EURUSD trading prompts (Factor Discovery, Evolution, Model Coder)
-├── local/                         # Your improved prompts (NOT in Git!)
-├── patches/                       # Override patches for Qlib scenarios
-│   ├── qlib_experiment_prompts.yaml
-│   ├── qlib_rd_loop_prompts.yaml
-│   └── qlib_scenarios_prompts.yaml
-├── app/                           # Application-level prompts
-│   ├── ci/prompts.yaml            # CI/CD prompts
-│   ├── qlib_rd_loop/prompts.yaml  # Qlib RD Loop hypothesis generation
-│   ├── utils/prompts.yaml         # APE prompts
-│   └── finetune/prompts.yaml      # Finetune prompts
-├── components/                    # Component prompts
-│   ├── agent/prompts.yaml         # Context7 MCP documentation search
-│   ├── proposal/prompts.yaml      # Hypothesis proposal generation
-│   ├── coder/
-│   │   ├── factor_coder/prompts.yaml   # Factor code evaluator
-│   │   ├── model_coder/prompts.yaml    # Model code evaluator
-│   │   ├── rl/prompts.yaml             # RL trading coder (Chinese)
-│   │   ├── CoSTEER/prompts.yaml        # Component analysis
-│   │   ├── finetune/prompts.yaml       # LLM finetuning coder
-│   │   └── data_science/               # Data science pipeline
-│   │       ├── ensemble/prompts.yaml
-│   │       ├── feature/prompts.yaml
-│   │       ├── model/prompts.yaml
-│   │       ├── pipeline/prompts.yaml
-│   │       ├── raw_data_loader/prompts.yaml
-│   │       ├── share/prompts.yaml
-│   │       └── workflow/prompts.yaml
-├── scenarios/                     # Scenario-specific prompts
-│   ├── qlib/                      # Qlib EURUSD trading
-│   │   ├── prompts.yaml           # Main Qlib scenario
-│   │   ├── experiment/prompts.yaml
-│   │   └── factor_experiment_loader/prompts.yaml
-│   ├── data_science/              # Data science scenarios
-│   │   ├── dev/prompts.yaml
-│   │   ├── runner/dev/prompts.yaml
-│   │   ├── proposal/exp_gen/prompts.yaml
-│   │   ├── proposal/exp_gen/prompts_v2.yaml    # Largest file (82KB)
-│   │   ├── proposal/exp_gen/select/prompts.yaml
-│   │   └── scen/prompts.yaml
-│   ├── finetune/                  # LLM finetuning
-│   │   ├── dev/prompts.yaml
-│   │   ├── proposal/prompts.yaml
-│   │   └── scen/prompts.yaml
-│   ├── kaggle/                    # Kaggle competition
-│   │   ├── prompts.yaml
-│   │   ├── experiment/prompts.yaml
-│   │   └── knowledge_management/prompts.yaml
-│   ├── rl/                        # Reinforcement learning (Chinese)
-│   │   ├── dev/prompts.yaml
-│   │   └── proposal/prompts.yaml
-│   └── general_model/prompts.yaml
-└── utils/                         # Utility prompts
-    └── prompts.yaml               # Filter redundant text
-```
-
-## Active Prompts for EURUSD Trading
-
-The following prompts are actively used in the `rdagent fin_quant` trading loop:
-
-| Priority | File | Purpose |
-|----------|------|---------|
-| 1 | `standard_prompts.yaml` | Factor Discovery, Factor Evolution, Model Coder, Trading Strategy |
-| 2 | `rdagent/app/qlib_rd_loop/prompts.yaml` | Hypothesis generation for Qlib RD Loop |
-| 3 | `rdagent/scenarios/qlib/prompts.yaml` | Qlib scenario: hypothesis feedback, output format |
-| 4 | `rdagent/scenarios/qlib/factor_experiment_loader/prompts.yaml` | Factor viability, relevance, duplicate checks |
-| 5 | `rdagent/scenarios/qlib/experiment/prompts.yaml` | Qlib experiment background, factor interface |
-| 6 | `rdagent/components/coder/factor_coder/prompts.yaml` | Code evaluation, final decision |
-| 7 | `patches/qlib_scenarios_prompts.yaml` | EURUSD-specific overrides (1min data, market sessions) |
-| 8 | `patches/qlib_rd_loop_prompts.yaml` | EURUSD hypothesis generation overrides |
-
-## Key Changes (April 2026)
-
-- **Fixed:** All "daily frequency" references changed to "intraday 1-minute bars"
-- **Fixed:** `daily_pv.h5` renamed to `intraday_pv.h5` in data descriptions
-- **Fixed:** `FactorDatetimeDailyEvaluator` now accepts 1min-30min bars as correct for EURUSD
-
-## Total Files: 44 YAML files
-## Total Size: ~486 KB

prompts/README.md

@@ -1,287 +0,0 @@
-# Predix Prompts
-
-This directory contains all LLM prompts for the Predix trading agent.
-
----
-
-## 📁 Directory Structure
-
-```
-prompts/
-├── standard_prompts.yaml    # Default prompts (committed to Git)
-├── local/                   # YOUR IMPROVED PROMPTS (not in Git!)
-│   ├── factor_discovery_v2.yaml
-│   ├── optimized_prompts.yaml
-│   └── best_performing.yaml
-└── README.md                # This file
-```
-
----
-
-## 🎯 How It Works
-
-**Prompt Loading Priority:**
-
-1. **`prompts/local/*.yaml`** ← Your improved prompts (loaded first!)
-2. **`prompts/standard_prompts.yaml`** ← Default prompts (fallback)
-
-**Example:**
-```python
-from rdagent.components.loader import load_prompt
-
-# Load factor discovery prompt
-# If prompts/local/factor_discovery.yaml exists → loads that
-# Otherwise → loads from standard_prompts.yaml
-prompt = load_prompt("factor_discovery")
-
-# Load specific section
-system_prompt = load_prompt("factor_discovery", section="system")
-user_prompt = load_prompt("factor_discovery", section="user")
-
-# Force local only (raise error if not found)
-prompt = load_prompt("factor_discovery", local_only=True)
-```
-
----
-
-## 📝 Available Standard Prompts
-
-| Prompt Name | Description | Used By |
-|-------------|-------------|---------|
-| `factor_discovery` | Generate new trading factor hypotheses | Hypothesis Agent |
-| `factor_evolution` | Improve existing factors | Evolution Agent |
-| `model_coder` | Generate ML model code | Model Coder Agent |
-| `trading_strategy` | Design complete trading strategies | Strategy Agent |
-
----
-
-## 🚀 Creating Your Improved Prompts
-
-### Step 1: Create Local Prompt File
-
-```bash
-# Create local directory (if not exists)
-mkdir -p prompts/local
-
-# Copy standard prompt as template
-cp prompts/standard_prompts.yaml prompts/local/factor_discovery_v2.yaml
-```
-
-### Step 2: Edit Your Prompt
-
-```yaml
-# prompts/local/factor_discovery_v2.yaml
-
-factor_discovery:
-  system: |-
-    YOUR IMPROVED SYSTEM PROMPT HERE
-    
-    Add your proprietary insights:
-    - Specific EURUSD patterns you've discovered
-    - Your unique factor formulas
-    - Custom session filters
-    - Proprietary risk management rules
-    
-  user: |-
-    YOUR IMPROVED USER PROMPT HERE
-```
-
-### Step 3: Test Your Prompt
-
-```bash
-# Test prompt loading
-python rdagent/components/loader.py
-
-# Should show:
-# ✓ Loading prompt 'factor_discovery' from local: prompts/local/factor_discovery_v2.yaml
-```
-
-### Step 4: Use in Trading
-
-Your improved prompts are automatically used when running:
-
-```bash
-rdagent fin_quant
-```
-
-The loader checks `prompts/local/` first, so your improved prompts take precedence!
-
----
-
-## 🔐 Security
-
-**What to keep in `prompts/local/`:**
-
-✅ Your proprietary factor discovery logic
-✅ Optimized prompt templates
-✅ Best-performing configurations
-✅ Custom evolution strategies
-✅ Trade secrets & alpha-generating logic
-
-**What NOT to commit to Git:**
-
-❌ Anything in `prompts/local/` (already in .gitignore)
-❌ Files with `.local.yaml` suffix
-❌ Files with `_private.yaml` suffix
-
----
-
-## 📊 Best Practices
-
-### 1. Version Your Prompts
-
-```yaml
-# Good naming:
-prompts/local/factor_discovery_v2.yaml
-prompts/local/factor_discovery_v3_optimized.yaml
-prompts/local/model_coder_xgboost_v1.yaml
-```
-
-### 2. Document Changes
-
-```yaml
-# Add metadata to your prompts
-# prompts/local/factor_discovery_v2.yaml
-
-# Version: 2.0
-# Author: Your Name
-# Date: 2026-04-02
-# Changes:
-#   - Added session-specific filters
-#   - Improved spread cost modeling
-#   - Target ARR: 12% (up from 9.62%)
-
-factor_discovery:
-  system: |-
-    ...
-```
-
-### 3. Test Performance
-
-```python
-# Compare prompt versions
-from rdagent.components.loader import load_prompt
-
-# Load different versions
-prompt_v1 = load_yaml_file("prompts/standard_prompts.yaml")
-prompt_v2 = load_yaml_file("prompts/local/factor_discovery_v2.yaml")
-
-# Run backtests and compare
-# ...
-```
-
-### 4. Backup Your Prompts
-
-```bash
-# Backup to private repo
-cd ~/Predix
-git archive --format=tar prompts/local/ | gzip > ~/backups/prompts_local_$(date +%Y%m%d).tar.gz
-
-# Or sync to private GitHub repo
-git clone git@github.com:TPTBusiness/predix-prompts-private.git
-cp -r prompts/local/* predix-prompts-private/
-cd predix-prompts-private && git push
-```
-
----
-
-## 🔧 Advanced Usage
-
-### Load All Prompts
-
-```python
-from rdagent.components.loader import load_all_prompts
-
-all_prompts = load_all_prompts()
-print(all_prompts['standard'])  # Standard prompts
-print(all_prompts['local'])     # Your improved prompts
-```
-
-### List Available Prompts
-
-```python
-from rdagent.components.loader import list_available_prompts
-
-available = list_available_prompts()
-print(f"Standard: {available['standard']}")
-print(f"Local: {available['local']}")
-```
-
-### Custom Prompt Path
-
-```python
-from rdagent.components.loader import load_yaml_file
-
-# Load from custom location
-custom_prompt = load_yaml_file("/path/to/my/prompts.yaml")
-```
-
----
-
-## 📈 Performance Tips
-
-### 1. Be Specific
-
-**Bad:**
-```yaml
-system: "Generate a good trading factor."
-```
-
-**Good:**
-```yaml
-system: |
-  Generate a EURUSD mean-reversion factor for the London session.
-  Target: 8-12% ARR, <15% max drawdown.
-  Use 5-minute lookback with RSI filter.
-```
-
-### 2. Include Domain Knowledge
-
-```yaml
-system: |
-  EURUSD domain knowledge:
-  - London session (08:00-16:00 UTC): highest volume
-  - Spread cost: 1.5 bps
-  - Mean-reverting on <1h windows
-  - Trending on >4h windows
-```
-
-### 3. Specify Output Format
-
-```yaml
-system: |
-  Your response must be in JSON format:
-  {
-    "hypothesis": "...",
-    "reason": "...",
-    "target_session": "london/ny/asian/all",
-    "expected_arr_range": "8-12%"
-  }
-```
-
-### 4. Provide Examples
-
-```yaml
-user: |
-  Example of a good factor:
-  
-  Name: Momentum_8Bar_London
-  Logic: Long if 8-bar return > 0 and is_london=True
-  Filter: ADX > 1.2 (trending regime)
-  Expected ARR: 9.5%
-  
-  Now generate a NEW factor with different logic.
-```
-
----
-
-## 🎯 Next Steps
-
-1. **Review standard prompts:** `cat prompts/standard_prompts.yaml`
-2. **Create your improved version:** `mkdir -p prompts/local`
-3. **Test:** `python rdagent/components/loader.py`
-4. **Run trading:** `rdagent fin_quant`
-
----
-
-**Your improved prompts in `prompts/local/` are your competitive edge! 🚀**

prompts/app/ci/prompts.yaml

@@ -1,117 +0,0 @@
-generate_lint_command_template: |
-  Please generate a command to lint or format a {language} repository.
-  Here are some information about different linting tools ```{linting_tools}```
-linting_system_prompt_template: |
-  You are a software engineer. You can write code to a high standard and are adept at solving {language} linting problems.
-session_manual_template: |
-  There are some problems with the code you provided, please modify the code again according to the instruction and return the errors list you modified.
-  
-  Instruction:
-  {operation}
-  
-  Your response format should be like this:
-  
-  ```python
-  <modified code>
-  ```
-  
-  ```json
-  {{
-      "errors": ["<Line Number>:<Error Start Position> <Error Code>", ...]
-  }}
-  ```
-session_normal_template: |
-  Please modify this code snippet based on the lint info. Here is the code snippet:
-  ```Python
-  {code}
-  ```
-
-  -----Lint info-----
-  {lint_info}
-  -------------------
-
-  The lint info contains one or more errors. Different errors are separated by blank lines. Each error follows this format:
-  -----Lint info format-----
-  <Line Number>:<Error Start Position> <Error Code> <Error Message>
-  <Error Position (maybe multiple lines)>
-  <Helpful Information (sometimes have)>
-  --------------------------
-  The error code is an abbreviation set by the checker for ease of describing the error. The error position includes the relevant code around the error, and the helpful information provides useful information or possible fix method.
-
-  Please simply reply the code after you fix all linting errors. You should be aware of the following:
-  1. The indentation of the code should be consistent with the original code.
-  2. You should just replace the code I provided you, which starts from line {start_line} to line {end_line}.
-  3. You'll need to add line numbers to the modified code which starts from {start_lineno}.
-  4. You don't need to add comments to explain your changes.
-  Please wrap your code with following format:
-
-  ```python
-  <your code..>
-  ```
-session_start_template: |
-  Please modify the Python code based on the lint info.
-  Due to the length of the code, I will first tell you the entire code, and then each time I ask a question, I will extract a portion of the code and tell you the error information contained in this code segment.
-  You need to fix the corresponding error in the code segment and return the code that can replace the corresponding code segment.
-
-  The Python code is from a complete Python project file. Each line of the code is annotated with a line number, separated from the original code by three characters ("<white space>|<white space>"). The vertical bars are aligned.
-  Here is the complete code, please be prepared to fix it:
-  ```Python
-  {code}
-  ```
-suffix2language_template: |
-  Here are the files suffix in one code repo: {suffix}.
-  Please tell me the programming language used in this repo and which language has linting-tools.
-  Your response should follow this template:
-  {{
-      "languages": <languages list>,
-      "languages_with_linting_tools": <languages with lingting tools list>
-  }}
-user_get_files_contain_lint_commands_template: |
-  You get a file list of a repository. Some files may contain linting rules or linting commands defined by repo authors.
-  Here are the file list:
-  ```
-  {file_list}
-  ```
-  
-  Please find all files that may correspond to linting from it.
-  Please respond with the following JSON template:
-  {{
-      "files": </path/to/file>,
-  }}
-user_get_makefile_lint_commands_template: |
-  You get a Makefile which contains some linting rules. Here are its content:
-  ```
-  {file_text}
-  ```
-  Please find executable commands about linting from it.
-  Please respond with the following JSON template:
-  {{
-      "commands": ["python -m xxx --params"...],
-  }}
-user_template_for_code_snippet: |
-  Please modify the Python code based on the lint info.
-  -----Python Code-----
-  {code}
-  ---------------------
-
-  -----Lint info-----
-  {lint_info}
-  -------------------
-
-  The Python code is a snippet from a complete Python project file. Each line of the code is annotated with a line number, separated from the original code by three characters ("<white space>|<white space>"). The vertical bars are aligned.
-
-  The lint info contains one or more errors. Different errors are separated by blank lines. Each error follows this format:
-  -----Lint info format-----
-  <Line Number>:<Error Start Position> <Error Code> <Error Message>
-  <Error Context (multiple lines)>
-  <Helpful Information (last line)>
-  --------------------------
-  The error code is an abbreviation set by the checker for ease of describing the error. The error context includes the relevant code around the error, and the helpful information suggests possible fixes.
-
-  Please simply reply the code after you fix all linting errors.
-  The code you return does not require line numbers, and should just replace the code I provided you, and does not require comments.
-  Please wrap your code with following format:
-
-  ```python
-  <your code..>
-  ```

prompts/app/finetune/prompts.yaml

@@ -1,23 +0,0 @@
-prev_model_eval:
-  system: |-
-    You are a data scientist tasked with evaluating code generation. 
-
-    You will receive the following information:
-    - The implemented code
-
-    Focus on these aspects:
-    - Check if the code load the model in the "prev_model/" subfolder.
-
-    Please respond with your feedback in the following JSON format and order
-    ```json
-    {
-        "execution": "Describe whether the code executed successfully. Include any errors or issues encountered, and append all error messages and full traceback details without summarizing or omitting any information. ."
-        "return_checking": "Detect whether the model is loaded from 'prev_model/' subfolder and finetune is prepared based on prev model.",
-        "code": "The code has explicity load the model from 'prev_model/' subfolder and prepares finetune based on prev model.",
-        "final_decision": <true or false in boolean type; only return true when ensuring that the code loads the model from 'prev_model/' subfolder and prepares finetune based on prev model.>
-    }
-    ```
-
-  user: |-
-    ------------ The implemented code ------------ 
-    {{code}}

prompts/app/qlib_rd_loop/prompts.yaml

@@ -1,56 +0,0 @@
-hypothesis_generation:
-  system: |-
-    You are an expert quantitative researcher specialized in FX (foreign exchange) trading,
-    specifically EURUSD intraday strategies on 1-MINUTE bars.
-
-    EURUSD domain knowledge you must apply:
-    - Data frequency: 1-minute bars (96 bars = 1 day, 16 bars = 16 minutes)
-    - London session (08:00-12:00 UTC): highest volatility, trending behavior — favor momentum strategies
-    - NY session (13:00-17:00 UTC): second volatility peak, also trending
-    - Asian session (00:00-07:00 UTC): low volatility, mean-reverting behavior
-    - London/NY overlap (13:00-17:00 UTC): strongest directional moves of the day
-    - Weekend gap risk: avoid holding positions after Friday 20:00 UTC
-    - Spread cost: ~1.5 bps per trade — strategies must minimize unnecessary entries
-    - EURUSD is mean-reverting on short windows (<1h), trending on longer (>4h)
-    - Key macro drivers: ECB/Fed rate decisions, NFP (first Friday of month), CPI releases
-
-    Available model types you can propose:
-    - TimeSeries: LSTM, GRU, TCN (Temporal Convolutional Network), Transformer, PatchTST
-    - Tabular: XGBoost, LightGBM, RandomForest (on engineered features)
-    - Hybrid: CNN+LSTM, XGBoost+LSTM ensemble
-    - Statistical: Regime-switching (HMM), Kalman filter
-
-    Available features in the dataset:
-    - OHLCV: open, high, low, close, volume (1min bars)
-    - Returns: ret_1, ret_4, ret_8, ret_16, ret_96
-    - Technical: rsi_14, macd_hist, adx_14, atr_14, bb_pct, stoch_k, cci_14
-    - Volatility: vol_real_4, vol_real_16, vol_ratio, zscore_ret_96
-    - Time/Session: hour, is_london, is_ny, is_overlap, hour_sin, hour_cos
-    - Lags: rsi_14_lag1-8, macd_hist_lag1-8, bb_pct_lag1-8
-
-    Your hypothesis must:
-    1. Specify which session(s) the strategy targets
-    2. Name which model type to use and why it fits EURUSD
-    3. Include a session filter (is_london / is_ny)
-    4. Include a spread filter (only trade when expected |return| > 0.0003)
-    5. Specify target: classification (fwd_sign_4) or regression (fwd_ret_4)
-
-    Please ensure your response is in JSON format:
-    {
-      "hypothesis": "A clear and concise trading hypothesis for EURUSD 1min.",
-      "reason": "Detailed explanation including session, model choice, and expected edge.",
-      "model_type": "One of: TimeSeries / Tabular / XGBoost",
-      "target_session": "london / ny / asian / all",
-      "expected_arr_range": "e.g. 8-12%"
-    }
-
-  user: |-
-    Previously tried approaches and their results:
-    {{ factor_descriptions }}
-
-    Additional context:
-    {{ report_content }}
-
-    Generate a NEW hypothesis that is meaningfully different from what has been tried.
-    Focus on approaches that have NOT been tested yet.
-    Target: beat current best ARR of 9.62%.

prompts/app/utils/prompts.yaml

@@ -1,119 +0,0 @@
-ape:
-  system: |-
-    We'll provide you with a pair of Chat QA about data science.
-    We are creating solutions for a Kaggle Competition based on the answers.
-    Good questions are crucial for getting good answers.
-    Please suggest how to improve the question.
-    You can analyze based on these aspects:
-    - Is the question complete (is all the information needed to answer the question provided?)
-
-    The conversation will be provided in the following format:
-
-    <question>
-      <part1>
-      ...text to describe the question...
-      </part1>
-      <part2>
-      ...text to describe the question...
-      </part2>
-    </question>
-
-    <answer>
-      ...text to describe the answer.
-    </answer>
-
-    You response should be very concorete and concise(less than 20 words) and focuse on the mentioned aspects, like
-    ```
-    Info Missing: the question ask for changing code, but it does not provide the description of current code.
-    ```
-    Please be very conversatiive when you propose improvements. Only propose improvements when it becomes impossible to give the answer.
-
-    Don't propose conerete modifications
-
-  user: |-
-    <question>
-      <part1>
-      {{system}}
-      </part1>
-      <part2>
-      {{user}}
-      </part2>
-    </question>
-
-    <answer>
-      {{answer}}
-    </answer>
-
-  optional: |-
-    If you want to suggest modification on  the question. Please follow the *SEARCH/REPLACE block* Rules!!!! It is optional.
-    Please make it concise and less than 20 lines!!!
-
-    # *SEARCH/REPLACE block* Rules:
-
-    Every *SEARCH/REPLACE block* must use this format:
-    1. The *FULL* file path alone on a line, verbatim. No bold asterisks, no quotes around it, no escaping of characters, etc.
-    2. The opening fence and code language, eg: ```python
-    3. The start of search block: <<<<<<< SEARCH
-    4. A contiguous chunk of lines to search for in the existing source code
-    5. The dividing line: =======
-    6. The lines to replace into the source code
-    7. The end of the replace block: >>>>>>> REPLACE
-    8. The closing fence: ```
-
-    Use the *FULL* file path, as shown to you by the user.
-
-    Every *SEARCH* section must *EXACTLY MATCH* the existing file content, character for character, including all comments, docstrings, etc.
-    If the file contains code or other data wrapped/escaped in json/xml/quotes or other containers, you need to propose edits to the literal contents of the file, including the container markup.
-
-    *SEARCH/REPLACE* blocks will *only* replace the first match occurrence.
-    Including multiple unique *SEARCH/REPLACE* blocks if needed.
-    Include enough lines in each SEARCH section to uniquely match each set of lines that need to change.
-
-    Keep *SEARCH/REPLACE* blocks concise.
-    Break large *SEARCH/REPLACE* blocks into a series of smaller blocks that each change a small portion of the file.
-    Include just the changing lines, and a few surrounding lines if needed for uniqueness.
-    Do not include long runs of unchanging lines in *SEARCH/REPLACE* blocks.
-
-    Only create *SEARCH/REPLACE* blocks for files that the user has added to the chat!
-
-    To move code within a file, use 2 *SEARCH/REPLACE* blocks: 1 to delete it from its current location, 1 to insert it in the new location.
-
-    Pay attention to which filenames the user wants you to edit, especially if they are asking you to create a new file.
-
-    If you want to put code in a new file, use a *SEARCH/REPLACE block* with:
-    - A new file path, including dir name if needed
-    - An empty `SEARCH` section
-    - The new file's contents in the `REPLACE` section
-
-    To rename files which have been added to the chat, use shell commands at the end of your response.
-
-    If the user just says something like "ok" or "go ahead" or "do that" they probably want you to make SEARCH/REPLACE blocks for the code changes you just proposed.
-    The user will say when they've applied your edits. If they haven't explicitly confirmed the edits have been applied, they probably want proper SEARCH/REPLACE blocks.
-
-    You are diligent and tireless!
-    You NEVER leave comments describing code without implementing it!
-    You always COMPLETELY IMPLEMENT the needed code!
-
-
-    ONLY EVER RETURN CODE IN A *SEARCH/REPLACE BLOCK*!
-    Examples of when to suggest shell commands:
-
-    - If you changed a self-contained html file, suggest an OS-appropriate command to open a browser to view it to see the updated content.
-    - If you changed a CLI program, suggest the command to run it to see the new behavior.
-    - If you added a test, suggest how to run it with the testing tool used by the project.
-    - Suggest OS-appropriate commands to delete or rename files/directories, or other file system operations.
-    - If your code changes add new dependencies, suggest the command to install them.
-    - Etc.
-
-    Here is a example of SEARCH/REPLACE BLOCK to change a function implementation to import.
-
-    <<<<<<< SEARCH
-    def hello():
-        "print a greeting"
-
-        print("hello")
-    =======
-    from hello import hello
-
-    >>>>>>> REPLACE
-# - Is there any ambiguity in the question?

prompts/components/agent/prompts.yaml

@@ -1,59 +0,0 @@
-# Context7 MCP Enhanced Query Prompts
-
-system_prompt: |-
-  You are a helpful assistant.
-  You help to user to search documentation based on error message and provide API reference information.
-
-context7_enhanced_query_template: |-
-  ERROR MESSAGE:
-  {{error_message}}
-  {{context_info}}
-  IMPORTANT INSTRUCTIONS:
-  1. ENVIRONMENT: The running environment is FIXED and unchangeable - DO NOT suggest pip install, conda install, or any environment modifications.
-  2. DOCUMENTATION SEARCH REQUIREMENTS: 
-     - Search for official API documentation related to the error
-     - Focus on parameter specifications, method signatures, and usage patterns
-     - Find compatible alternatives if the original API doesn't exist
-     - Consider the current code context and maintain consistency with existing architecture
-     - Provide API reference information, NOT complete code solutions
-  3. TOOL USAGE REQUIREMENTS:
-     - ⚠️ CRITICAL: For EVERY call to 'resolve-library-id', you MUST follow it with A CORRESPONDING call to 'get-library-docs'
-     - If you call 'resolve-library-id' N times, you MUST call 'get-library-docs' N times (one for each library you found)
-     - Complete the full workflow: resolve → get-docs → analyze → respond
-     - Do NOT provide final answers without first getting detailed documentation via 'get-library-docs'
-     - If 'get-library-docs' returns "Documentation not found" or 404 error, you should never provide guidance based on the library information from 'resolve-library-id'
-  4. RESPONSE FORMAT:
-     - Start with a brief explanation of the root cause
-     - Provide relevant API documentation excerpts
-     - List available parameters and their descriptions
-     - Show method signatures and basic usage patterns
-     - If multiple API options exist, document all viable alternatives
-  5. STRICT CONSTRAINTS:
-     - DO NOT provide complete working code replacements
-     - DO NOT suggest hardware configuration changes (CPU/GPU)
-     - DO NOT recommend architecture or framework changes
-     - DO NOT provide performance optimization suggestions
-     - ONLY provide API documentation and parameter information
-  6. AVOID: Complete code solutions, environment setup, hardware recommendations, architecture suggestions, or performance advice.
-  {{timm_trigger_text}}
-  Example response format:
-  ```
-  The error occurs because [brief explanation].
-  API Documentation:
-  - Method: library.function_name(param1, param2, ...)
-  - Parameters:
-    * param1 (type): description
-    * param2 (type): description
-  - Usage pattern: Basic syntax without complete implementation
-  - Alternative APIs (if applicable): list of alternative methods with signatures
-  ```
-  Please search the documentation and provide API reference information only.
-# Special case templates
-timm_special_case: |-
-  7.⚠️ Special Case: If the code error is indeed related to the 'timm' library (PyTorch Image Models), you MUST return the library ID '/huggingface/pytorch-image-models' as the most relevant match, even if other candidates exist.
-# Code context template
-code_context_template: |-
-  CURRENT CODE CONTEXT:
-  ```python
-  {{full_code}}
-  ```

prompts/components/coder/CoSTEER/prompts.yaml

@@ -1,10 +0,0 @@
-
-analyze_component_prompt_v1_system: |-
-  User is getting a new task that might consist of the components below (given in component_index: component_description):
-  {{all_component_content}}
-
-  You should find out what components does the new task have, and put their indices in a list.
-  Please response the critic in the json format. Here is an example structure for the JSON output, please strictly follow the format:
-  {
-      "component_no_list": the list containing indices of components.
-  }