Release 0.7.0

.context/local-testing-guide.md

@@ -42,14 +42,17 @@ curl -X POST http://localhost:38528/COMMUNITY_ID/ask \
   -d '{"question": "What is this tool?", "api_key": "your-key"}' | jq
 ```
 
-## CLI Testing (No Server Needed)
+## CLI Testing
 
 ```bash
-# Interactive chat
-uv run osa chat --community COMMUNITY_ID --standalone
+# Interactive chat (connects to API by default)
+uv run osa chat -a COMMUNITY_ID
 
 # Single question
-uv run osa ask --community COMMUNITY_ID "What is this tool?" --standalone
+uv run osa ask -a COMMUNITY_ID "What is this tool?"
+
+# Against local server
+uv run osa ask -a COMMUNITY_ID "What is this tool?" --api-url http://localhost:38528
 ```
 
 ## Knowledge Sync
@@ -69,7 +72,7 @@ uv run osa sync papers --community COMMUNITY_ID --citations
 - [ ] Preloaded docs are in context
 - [ ] On-demand docs retrieved when relevant
 - [ ] Documentation URLs in responses are valid
-- [ ] CLI standalone mode works
+- [ ] CLI works against local server
 - [ ] Knowledge sync completes (if configured)
 - [ ] Assistant does not hallucinate PR/issue numbers
 

.github/workflows/notify-docs.yml

@@ -0,0 +1,18 @@
+name: Notify Documentation Repo
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Dispatch to documentation repo
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          token: ${{ secrets.DOCS_REPO_TOKEN }}
+          repository: OpenScience-Collective/documentation
+          event-type: osa-updated
+          client-payload: '{"sha": "${{ github.sha }}", "ref": "${{ github.ref }}"}'

README.md

@@ -44,22 +44,23 @@ uv run pre-commit install
 ### CLI Usage
 
 ```bash
-# Show available assistants
-osa
+# Set up your API key (get one at https://openrouter.ai/keys)
+osa init
 
 # Ask the HED assistant a question
-osa hed ask "What is HED?"
+osa ask -a hed "What is HED?"
 
 # Start an interactive chat session
-osa hed chat
+osa chat -a hed
 
 # Show all commands
 osa --help
-osa hed --help
 ```
 
 ### API Server
 
+Requires server dependencies: `pip install 'open-science-assistant[server]'`
+
 ```bash
 # Start the API server
 osa serve
@@ -77,8 +78,8 @@ osa config show
 # Set API keys for BYOK (Bring Your Own Key)
 osa config set --openrouter-key YOUR_KEY
 
-# Connect to remote server (uses BYOK)
-osa hed ask "What is HED?" --url https://api.osc.earth/osa-dev
+# Override API URL per-command
+osa ask -a hed "What is HED?" --api-url https://api.osc.earth/osa-dev
 ```
 
 ### Deployment

dashboard/osa/index.html

@@ -244,6 +244,31 @@
         .status-error { background: #fee2e2; color: #991b1b; }
         .status-unknown { background: #f1f5f9; color: #64748b; }
 
+        /* Config health banners */
+        .config-banner {
+            border-radius: 8px;
+            padding: 0.7rem 1rem;
+            margin-bottom: 1rem;
+            font-size: 0.85rem;
+            line-height: 1.5;
+        }
+        .config-banner ul {
+            list-style: none;
+            margin: 0;
+            padding: 0;
+        }
+        .config-banner li { padding: 0.1rem 0; }
+        .config-banner-warning {
+            background: #fff7ed;
+            border: 1px solid #fed7aa;
+            color: #9a3412;
+        }
+        .config-banner-error {
+            background: #fef2f2;
+            border: 1px solid #fecaca;
+            color: #991b1b;
+        }
+
         /* Period toggle */
         .period-toggle { display: flex; gap: 0.35rem; margin-bottom: 1rem; }
         .period-btn {
@@ -801,6 +826,18 @@ <h2>Communities</h2>
             healthLabel = healthStatus.charAt(0).toUpperCase() + healthStatus.slice(1);
         }
 
+        // Config health from public metrics (API key, docs status)
+        const configHealth = summary.config_health || null;
+        let configWarningHtml = '';
+        if (configHealth && configHealth.warnings && configHealth.warnings.length > 0) {
+            const warningItems = configHealth.warnings.map(w => `<li>${escapeHtml(w)}</li>`).join('');
+            const bannerClass = configHealth.status === 'error' ? 'config-banner-error' : 'config-banner-warning';
+            configWarningHtml = `
+                <div class="config-banner ${bannerClass}">
+                    <ul>${warningItems}</ul>
+                </div>`;
+        }
+
         const desc = meta.description
             ? `<p style="color:#64748b; font-size:0.9rem; margin-bottom:0.75rem;">${escapeHtml(meta.description)}</p>`
             : '';
@@ -815,6 +852,7 @@ <h2>${safeName.toUpperCase()}</h2>
                 </div>
                 ${desc}
                 ${links}
+                ${configWarningHtml}
                 <div class="overview-grid">
                     <div class="metric">
                         <div class="metric-value">${summary.total_requests.toLocaleString()}</div>

deploy/DEPLOYMENT_ARCHITECTURE.md

@@ -55,7 +55,7 @@ Users can pass their own API keys via HTTP headers:
 |--------|----------|
 | `X-OpenAI-API-Key` | OpenAI |
 | `X-Anthropic-API-Key` | Anthropic |
-| `X-OpenRouter-API-Key` | OpenRouter |
+| `X-OpenRouter-Key` | OpenRouter |
 
 ### Authentication Policy
 
@@ -67,7 +67,7 @@ Users can pass their own API keys via HTTP headers:
 ```bash
 curl -X POST https://api.osc.earth/osa-dev/hed/chat \
   -H "Content-Type: application/json" \
-  -H "X-OpenRouter-API-Key: sk-or-your-key" \
+  -H "X-OpenRouter-Key: sk-or-your-key" \
   -d '{"message": "What is HED?", "stream": false}'
 ```
 
@@ -76,14 +76,17 @@ No `X-API-Key` required when using BYOK headers.
 ### CLI Configuration for BYOK
 
 ```bash
-# Set your LLM API key
+# Set up your API key
+osa init --api-key "sk-or-your-key"
+
+# Or set it directly
 osa config set --openrouter-key "sk-or-your-key"
 
-# Use with remote server (BYOK)
-osa hed ask "What is HED?" --url https://api.osc.earth/osa-dev
+# Ask a question (uses saved key via BYOK)
+osa ask -a hed "What is HED?"
 
-# Use standalone mode (local server, no remote needed)
-osa hed ask "What is HED?"
+# Use against dev server
+osa ask -a hed "What is HED?" --api-url https://api.osc.earth/osa-dev
 ```
 
 ---
@@ -413,10 +416,10 @@ sudo systemctl reload apache2
 ### Installation
 
 ```bash
-# From PyPI (when published)
+# From PyPI (lightweight, ~7 dependencies)
 pip install open-science-assistant
 
-# From source
+# From source (with server dependencies)
 git clone https://github.com/OpenScience-Collective/osa.git
 cd osa
 uv sync
@@ -425,37 +428,31 @@ uv sync
 ### Commands
 
 ```bash
-# Show available assistants
-osa
+# Setup (saves API key securely)
+osa init
 
-# Ask a single question (standalone mode - starts local server)
-osa hed ask "What is HED?"
+# Ask a question
+osa ask -a hed "What is HED?"
 
 # Interactive chat session
-osa hed chat
+osa chat -a hed
 
-# Use remote server with BYOK
-osa hed ask "What is HED?" --url https://api.osc.earth/osa-dev
+# Override API URL per-command
+osa ask -a hed "What is HED?" --api-url https://api.osc.earth/osa-dev
 
 # Configuration
 osa config show                           # Show current config
 osa config set --openrouter-key "sk-..."  # Set LLM API key
-osa config set --api-key "server-key"     # Set server API key
 osa config path                           # Show config file location
 
-# Server management
-osa serve                                 # Start API server (production)
+# Server management (requires pip install 'open-science-assistant[server]')
+osa serve                                 # Start API server
 osa serve --port 38529 --reload           # Development mode
 osa health --url https://api.osc.earth/osa  # Check API health
 ```
 
-### Standalone vs Remote Mode
-
-| Mode | Description | Use Case |
-|------|-------------|----------|
-| Standalone (default) | Starts embedded server on localhost | Local development, offline use |
-| Remote (`--url`) | Connects to external API | Production, shared infrastructure |
+The CLI defaults to connecting to the production API at `https://api.osc.earth/osa`. Use `--api-url` to override.
 
 ---
 
-**Last Updated**: January 2026
+**Last Updated**: February 2026

deploy/Dockerfile

@@ -38,7 +38,7 @@ COPY pyproject.toml README.md ./
 
 # Install uv and dependencies
 RUN pip install uv && \
-    uv pip install --system --no-cache ".[dev]"
+    uv pip install --system --no-cache ".[server]"
 
 # Copy the rest of the application code
 COPY src/ ./src/

frontend/osa-chat-widget.js

@@ -257,6 +257,13 @@
       height: 20px;
     }
 
+    .osa-chat-avatar img {
+      width: 28px;
+      height: 28px;
+      object-fit: contain;
+      border-radius: 50%;
+    }
+
     .osa-chat-title-area {
       flex: 1;
       min-width: 0;
@@ -1502,6 +1509,19 @@
           CONFIG.suggestedQuestions = w.suggested_questions;
           changed = true;
         }
+        if (w.theme_color != null && !_userSetKeys.has('themeColor')) {
+          CONFIG.themeColor = w.theme_color;
+          changed = true;
+        }
+        if (w.logo_url != null && !_userSetKeys.has('logo')) {
+          // Resolve path-only logo URLs (starting with '/') against the API endpoint
+          if (w.logo_url.startsWith('/')) {
+            CONFIG.logo = CONFIG.apiEndpoint + w.logo_url;
+          } else {
+            CONFIG.logo = w.logo_url;
+          }
+          changed = true;
+        }
 
         if (changed) {
           applyWidgetConfig();
@@ -1523,6 +1543,20 @@
     const container = document.querySelector('.osa-chat-widget');
     if (!container) return;
 
+    // Apply theme color if configured (must be valid #RRGGBB hex)
+    if (CONFIG.themeColor && /^#[0-9a-fA-F]{6}$/.test(CONFIG.themeColor)) {
+      container.style.setProperty('--osa-primary', CONFIG.themeColor);
+      // Derive a darker shade for hover states
+      const r = parseInt(CONFIG.themeColor.slice(1, 3), 16);
+      const g = parseInt(CONFIG.themeColor.slice(3, 5), 16);
+      const b = parseInt(CONFIG.themeColor.slice(5, 7), 16);
+      const darker = '#' +
+        Math.max(0, r - 25).toString(16).padStart(2, '0') +
+        Math.max(0, g - 25).toString(16).padStart(2, '0') +
+        Math.max(0, b - 25).toString(16).padStart(2, '0');
+      container.style.setProperty('--osa-primary-dark', darker);
+    }
+
     // Update header title
     const titleEl = container.querySelector('.osa-chat-title');
     if (titleEl) {
@@ -1552,6 +1586,22 @@
     // Update suggested questions
     renderSuggestions(container);
 
+    // Update avatar with community logo if available
+    const avatar = container.querySelector('.osa-chat-avatar');
+    if (avatar && CONFIG.logo) {
+      const fallback = avatar.innerHTML;
+      const img = document.createElement('img');
+      img.src = CONFIG.logo;
+      img.alt = CONFIG.title;
+      img.onerror = function() {
+        console.warn('[OSA] Failed to load community logo:', CONFIG.logo);
+        avatar.innerHTML = fallback;
+        img.onerror = null;
+      };
+      avatar.innerHTML = '';
+      avatar.appendChild(img);
+    }
+
     // Update loading label if currently loading
     const loadingLabel = container.querySelector('.osa-loading-label');
     if (loadingLabel) {