trust-bo 0.1.0__tar.gz

trust_bo-0.1.0/.github/ISSUE_TEMPLATE/benchmark_report.yml

@@ -0,0 +1,25 @@
+name: Benchmark / real-world result
+description: Share results from using TRust-BO on a real problem (good or bad!)
+labels: [benchmark]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem description
+      description: What did you optimize? Dimensions, budget, constraints.
+    validations:
+      required: true
+  - type: textarea
+    id: results
+    attributes:
+      label: Results
+      description: Best value found, wall-clock time, comparison with other tools if any.
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      placeholder: "Ubuntu 24.04, Python 3.11, laptop CPU (no GPU)"
+    validations:
+      required: false

trust_bo-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,34 @@
+name: Bug report
+description: Something doesn't work as expected
+labels: [bug]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: A clear description of the bug, and what you expected instead.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal reproduction
+      description: The smallest script that reproduces the problem.
+      render: python
+    validations:
+      required: false
+  - type: input
+    id: version
+    attributes:
+      label: TRust-BO version / commit
+      placeholder: "0.1.0 / abc1234"
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, Python version, Rust version (if building from source).
+      placeholder: "Ubuntu 24.04, Python 3.11, rustc 1.85"
+    validations:
+      required: true

trust_bo-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,18 @@
+name: Feature request
+description: Suggest an idea or improvement
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: Describe the use case — e.g. the optimization problem you're trying to run.
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: What you'd like to happen. API sketches welcome.
+    validations:
+      required: false

trust_bo-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## Summary
+
+<!-- What does this PR change, and why? -->
+
+## Checklist
+
+- [ ] Tests added/updated (`pytest` for Python-facing behavior, `cargo test` for Rust internals)
+- [ ] `cargo test --release` passes
+- [ ] `maturin develop --release && pytest tests/ -q` passes
+- [ ] CHANGELOG.md updated (for user-facing changes)

trust_bo-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Rust build
+        uses: Swatinem/rust-cache@v2
+
+      - name: Rust tests
+        run: cargo test --release
+
+      # `maturin develop` requires a virtualenv; `pip install .` builds the
+      # same wheel via the maturin build backend and works anywhere
+      - name: Build and install package
+        run: pip install .
+
+      # The core package must import with no optional deps (numpy only).
+      # Regression guard for the lazy legacy-tandem import in __init__.py.
+      - name: Import smoke (no extras)
+        run: python -c "import trust_bo; from trust_bo import TRustBOEngine, MultiObjectiveEngine"
+
+      # scipy / scikit-learn are only needed for the deprecated TandemEngine
+      # (legacy-tandem extra) and its tests; the core package does not require them.
+      - name: Install test deps
+        run: pip install pytest scipy scikit-learn
+
+      - name: Python tests
+        run: pytest tests/ -q

trust_bo-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,86 @@
+name: Release
+
+# v* タグの push で起動。abi3-py39 wheel（Python 3.9+ 共通）を各 OS でビルドし、
+# GitHub Release にアセット添付 → PyPI へ trusted publishing で公開する。
+#
+# ⚠️ このワークフローは外部公開（PyPI / GitHub Release）を行う。タグ push は人間が確認後に行うこと。
+# PyPI 側で trusted publisher（OIDC, この repo の release.yml）を事前登録しておく必要がある。
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: write        # GitHub Release 作成・アセット添付
+
+jobs:
+  build-wheels:
+    name: wheel (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Build abi3 wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: dist/*.whl
+
+  build-sdist:
+    name: sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  github-release:
+    name: GitHub Release
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - name: Attach artifacts to GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+
+  pypi-publish:
+    name: Publish to PyPI
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    environment: pypi
+    permissions:
+      id-token: write    # PyPI trusted publishing (OIDC)
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist

trust_bo-0.1.0/.gitignore

@@ -0,0 +1,23 @@
+# Rust
+/target/
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+dist/
+.pytest_cache/
+
+# Build artifacts (built by `maturin develop`)
+*.so
+*.pyd
+
+# Generated outputs (benchmarks, CFD runs, reports)
+*.csv
+*.zip
+*.log
+results/
+final_report.txt
+task_log.txt
+*interim_report.txt

trust_bo-0.1.0/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [Unreleased]
+
+### Added
+
+- **Trust Region Bayesian Optimization engine written in Rust** (TuRBO-style),
+  exposed to Python via PyO3. No GPU, no BLAS/LAPACK, no cloud required.
+- **MLP Bootstrap Ensemble surrogate** (5 members, warm-started between rounds)
+  with CEM acquisition optimization inside the trust region.
+- **Native Rust Phase 2** (Tandem Residual-GP): a pure-Rust Matern 5/2 micro-GP
+  fits the residuals of the MLP ensemble near the incumbent for endgame
+  refinement. Enabled with `config={"enable_phase2": True}`. No sklearn needed.
+  +32% over plain TRust-BO at 50D, +55% at 10D (Ackley, 3-seed median).
+- **Constraint handling** via a feasibility surrogate (EI × P(feasible)).
+- **Async parallel / rolling evaluation** (`RollingTRustBOEngine`, SLURM-ready)
+  for expensive solvers where evaluations take minutes to hours.
+- **Multi-objective optimization** (`MultiObjectiveEngine`): Chebyshev scalarization
+  (any number of objectives) and a closed-form 2-objective Expected Hypervolume
+  Improvement (EHVI) implemented in Rust. Exposes `pareto_front()` / `hypervolume()`.
+- **Real CFD airfoil pipelines**: NeuralFoil (H-1, learned surrogate) and
+  SU2 RANS (H-2, real steady Navier-Stokes, Ma=0.3 Re=3e6 SA). Multi-objective
+  Cl/Cd optimization validated on SU2 (K-2-8).
+- **Save/resume**: `engine.save("study.zip")` / `TRustBOEngine.load(...)`.
+- **Optuna sampler** integration (`trust_bo.integrations.optuna`).
+- 91 tests passing (63 Python + 28 Rust), CPU-only.
+
+### Deprecated
+
+- `TandemEngine` / `TandemEngineV2` (sklearn-based Phase 2). Use
+  `TRustBOEngine(config={"enable_phase2": True})` instead. The old classes
+  remain available behind the `legacy-tandem` extra and will be removed in v0.2.

trust_bo-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,33 @@
+# Contributing to TRust-BO
+
+Thank you for your interest! This is a one-person project so far — any help is genuinely appreciated.
+
+## Bug reports & feature requests
+
+Please open an [Issue](https://github.com/K092203/TRust-BO/issues). Include your OS, Python version, and a minimal reproduction if possible.
+
+## Pull requests
+
+PRs are welcome. Start small — a typo fix or a single bug fix is a great first PR.
+
+1. Fork and create a branch
+2. Make your change
+3. **Add tests** — `pytest` for Python-facing behavior, `cargo test` for Rust internals
+4. Make sure everything passes:
+   ```bash
+   pip install maturin numpy pytest scipy scikit-learn
+   cargo test --release
+   maturin develop --release
+   pytest tests/ -q
+   ```
+   (`scipy` / `scikit-learn` are only needed while the deprecated
+   `TandemEngine` is still bundled — it will be removed in v0.2.)
+
+## Code style
+
+- Rust: `cargo fmt` (rustfmt defaults)
+- Python: [Black](https://github.com/psf/black) defaults
+
+## Benchmark results wanted!
+
+If you use TRust-BO on a **real CFD problem** (or any real engineering optimization), please share your results in an Issue — good or bad. Real-world feedback is the most valuable contribution at this stage.