✨ Adaptive Minds v0.1 — Next.js UI, four modes, one-command Docker, demo + docs overhaul

.env.example

@@ -1 +1,25 @@
-HF_TOKEN="please-add-your-token-here"
+# ---- Required ----------------------------------------------------------
+# HuggingFace token: needed for vLLM to download the base model + LoRAs.
+HF_TOKEN=hf_xxx
+
+# ---- Server / UI wiring (defaults are usually fine for docker compose) -
+# Where adaptive_minds.server hits vLLM (inside the compose network).
+VLLM_BASE=http://vllm:8000/v1
+
+# The Next.js UI proxies browser → API via its own server (`/api/am/* →
+# server:8765`), so the bundle uses relative URLs and the same image
+# works from localhost, a public IP, or behind a reverse proxy. Override
+# only if you've split the UI off and want it to hit FastAPI directly:
+# NEXT_PUBLIC_AM_API_BASE=https://api.example.com
+
+# Default mode the UI boots in: router | agent | auto | langgraph.
+# NEXT_PUBLIC_DEFAULT_MODE=router
+
+# Catalog the FastAPI server loads at startup. Defaults to the paper's
+# 30-adapter catalog. Swap to qwen25_smoke.yaml for a 2-adapter fast boot.
+AM_CATALOG=/app/catalogs/qwen25_30.yaml
+
+# ---- Host-port overrides (uncomment if 8000/8765/7007 are taken) -------
+# AM_VLLM_PORT=8001
+# AM_SERVER_PORT=8766
+# AM_UI_PORT=7008

.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: tests
+
+on:
+  push:
+    branches: [main, v2, "release/**"]
+  pull_request:
+    branches: [main, v2]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  pytest:
+    name: pytest · py${{ matrix.python }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install package
+        run: pip install -e ".[dev,serve]"
+
+      - name: Lint (ruff)
+        run: ruff check adaptive_minds tests
+
+      - name: Pytest
+        run: pytest tests/ -v
+
+      - name: Smoke import
+        run: |
+          python -c "from adaptive_minds.server import app; print('server:', app.title, app.version)"
+          python -c "from adaptive_minds import run_router, run_agent, load_catalog; print('runtime ok')"

.gitignore

@@ -53,6 +53,10 @@ base_model/
 loras/
 models/
 
+# Eval / training artefacts
+evals/results/
+training/loras/
+
 # Logs
 *.log
 logs/
@@ -69,7 +73,37 @@ temp/
 .pytest_cache/
 .coverage
 
+# ruff
+.ruff_cache/
+
 # mypy
 .mypy_cache/
 .dmypy.json
 dmypy.json
+
+# Session-private files (not committed)
+OSS_SESSION_LOG.md
+.battle_test/
+
+# Next.js UI build artefacts (Docker builds these inside the container)
+ui/node_modules/
+ui/.next/
+ui/out/
+ui/.env.local
+ui/next-env.d.ts
+
+# Remotion demo-video project: deps + render artefacts + the captured app
+# footage (regenerate via scripts/capture_demo.py → scripts/build_demo.sh).
+video/node_modules/
+video/out/
+video/public/app.mp4
+video/public/bgm.mp3
+# Raw BGM track is not redistributed (licensing) — the rendered docs/demo.mp4
+# carries the music; supply your own docs/bgm.mp3 to re-render.
+docs/bgm.mp3
+docs/.rec/
+
+# Re-allow the UI's typed API client; the broad `lib/` Python rule above
+# would otherwise swallow it (page.tsx imports from `@/lib/api`).
+!ui/src/lib/
+!ui/src/lib/**