aether-quant 0.2.0__tar.gz

aether_quant-0.2.0/.dockerignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+node_modules/
+webui/node_modules/
+webui/dist/
+backtests/
+.lean/
+.git/
+.claude/
+Aether-quant-Obsidian-Vault/
+# Large data directories not needed by the FastAPI server
+data/
+ml/
+storage/

aether_quant-0.2.0/.env.compose.example

@@ -0,0 +1,12 @@
+# Copy this file to .env (untracked, .gitignore'd) and fill in real values.
+# docker-compose.yml reads .env automatically for ${VAR} substitutions.
+
+# PostgreSQL (defaults already work for local dev — override for anything else)
+POSTGRES_DB=aether_quant
+POSTGRES_USER=aether
+POSTGRES_PASSWORD=aether_dev_password
+
+# Telegram alerts (V2-19) — required for notifications.telegram_worker to
+# actually send messages; leave blank to run the worker as a safe no-op.
+AETHER_TELEGRAM_BOT_TOKEN=
+AETHER_TELEGRAM_CHAT_ID=

aether_quant-0.2.0/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

aether_quant-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: pip install -r requirements/requirements.txt -r requirements/requirements-dev.txt
+
+      - name: Run tests
+        run: pytest
+        # tests/test_lean_backtest_ml_coverage.py self-skips: it requires the
+        # QuantConnect Lean CLI, which GitHub-hosted runners don't have.
+
+  webui:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: webui
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: webui/package-lock.json
+
+      - run: npm ci
+      - run: npx tsc -b
+      - run: npx oxlint
+      - run: npm run build

aether_quant-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,72 @@
+name: Release
+
+# Releasing is a manual, deliberate act: tag a commit on main and push the
+# tag. Nothing else triggers this workflow - matches this project's existing
+# bias toward no uncontrolled automatic actions (see e.g. retraining's
+# manual promote/rollback).
+on:
+  push:
+    tags: ["v*.*.*"]
+
+jobs:
+  publish-pypi:
+    runs-on: ubuntu-latest
+    environment: pypi # must match the Environment name configured in PyPI's Trusted Publisher setup
+    permissions:
+      # Required for PyPI Trusted Publishing (OIDC) - no PyPI token is ever
+      # stored as a secret. Requires a one-time Trusted Publisher setup on
+      # the PyPI project page (repo + this workflow filename).
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # full history/tags - required for setuptools-scm
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build sdist and wheel
+        run: |
+          pip install build
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-docker:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    env:
+      # Hardcoded lowercase, not derived from ${{ github.repository }}:
+      # the repo is leon1706-lol/Aether-quant (capital A), but Docker image
+      # references must be all-lowercase - using github.repository directly
+      # would fail with "invalid reference format".
+      IMAGE_NAME: ghcr.io/leon1706-lol/aether-quant
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: docker/setup-buildx-action@v3
+
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.IMAGE_NAME }}
+          tags: |
+            type=semver,pattern={{version}}
+            type=raw,value=latest
+
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

aether_quant-0.2.0/.gitignore

@@ -0,0 +1,95 @@
+# Python cache and virtual environments
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+env/
+*.egg-info/
+/dist/
+/build/
+
+# Local secrets and broker/API credentials
+.env
+.env.*
+!.env.compose.example
+ib_config.py
+*_config.local.py
+config.json
+config.local.json
+lean.json
+lean.local.json
+
+*.key
+*.pem
+
+# OS/editor noise
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+.claude/
+docker-compose.override.yml
+postgres-data/
+redis-data/
+grafana-data/
+pgdata/
+
+# Lean market data: too large for a public GitHub repo
+data/**
+!data/**/
+!data/**/.keep
+!data/**/.gitkeep
+
+# Lean object store / local runtime output
+storage/
+objectstore/
+
+# Backtest results and generated reports
+backtests/**
+!backtests/
+!backtests/.gitkeep
+
+# Generated ML datasets and binary artifacts
+ml/datasets/
+ml/expert_datasets/
+ml/expert_models/
+ml/model.pt
+ml/scaler.pkl
+ml/*.pkl
+ml/*.pt
+ml/*.pth
+ml/*.onnx
+
+# Generated ML/runtime JSON artifacts
+ml/dataset_inventory.json
+ml/dataset_manifest.json
+ml/expert_dataset_manifest.json
+ml/feature_schema.json
+ml/model_weights.json
+ml/scaler_stats.json
+ml/training_metrics.json
+ml/expert_training_metrics.json
+
+# Generated visualization/runtime feeds
+visualization/state.json
+visualization/scene.json
+visualization/topology_state.json
+visualization/grafana/
+
+# Logs and temporary files
+.coverage
+coverage.xml
+htmlcov/
+*.log
+*.tmp
+*.bak
+# Obsidian vault for project graphs and AI handoffs
+Aether-quant-Obsidian-Vault/
+
+# Webui (React/Vite) build artifacts and dependencies
+webui/node_modules/
+webui/dist/

aether_quant-0.2.0/Dockerfile

@@ -0,0 +1,18 @@
+# Stage 1: build webui
+FROM node:20-alpine AS webui-builder
+WORKDIR /app/webui
+COPY webui/package*.json ./
+RUN npm ci
+COPY webui/ .
+RUN npm run build
+
+# Stage 2: Python runtime (FastAPI server only — no ML deps)
+FROM python:3.11-slim
+WORKDIR /app
+COPY requirements/requirements-runtime.txt .
+RUN pip install --no-cache-dir -r requirements-runtime.txt
+COPY monitoring/ ./monitoring/
+COPY visualization/ ./visualization/
+COPY --from=webui-builder /app/webui/dist ./webui/dist
+EXPOSE 8000
+CMD ["uvicorn", "monitoring.api_server:app", "--host", "0.0.0.0", "--port", "8000"]

aether_quant-0.2.0/Dockerfile.retraining_worker

@@ -0,0 +1,14 @@
+FROM python:3.11-slim
+WORKDIR /app
+COPY requirements/requirements-retraining-worker.txt .
+RUN pip install --no-cache-dir -r requirements-retraining-worker.txt
+COPY execution/ ./execution/
+COPY experience/ ./experience/
+COPY performance/ ./performance/
+COPY regime/ ./regime/
+COPY experts/ ./experts/
+COPY topology/ ./topology/
+COPY retraining/ ./retraining/
+COPY train.py .
+COPY train_topology.py .
+CMD ["python", "-m", "retraining.worker"]

aether_quant-0.2.0/Dockerfile.telegram_worker

@@ -0,0 +1,9 @@
+FROM python:3.11-slim
+WORKDIR /app
+COPY requirements/requirements-telegram-worker.txt .
+RUN pip install --no-cache-dir -r requirements-telegram-worker.txt
+COPY execution/ ./execution/
+COPY experience/ ./experience/
+COPY performance/ ./performance/
+COPY notifications/ ./notifications/
+CMD ["python", "-m", "notifications.telegram_worker"]

aether_quant-0.2.0/Dockerfile.trigger_worker

@@ -0,0 +1,8 @@
+FROM python:3.11-slim
+WORKDIR /app
+COPY requirements/requirements-trigger-worker.txt .
+RUN pip install --no-cache-dir -r requirements-trigger-worker.txt
+COPY execution/ ./execution/
+COPY experience/ ./experience/
+COPY performance/ ./performance/
+CMD ["python", "-m", "performance.trigger_worker"]

aether_quant-0.2.0/Dockerfile.worker

@@ -0,0 +1,7 @@
+FROM python:3.11-slim
+WORKDIR /app
+COPY requirements/requirements-worker.txt .
+RUN pip install --no-cache-dir -r requirements-worker.txt
+COPY execution/ ./execution/
+COPY experience/ ./experience/
+CMD ["python", "-m", "experience.postgres_worker"]

aether_quant-0.2.0/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: aether-quant
+Version: 0.2.0
+Summary: Aether Quant convenience CLI
+Requires-Python: >=3.10