added no-llm option to install

Author: ClePol

api-service/api_service/assistant/runtime.py

@@ -27,6 +27,8 @@
 
 
 def provider_unavailable_message(config: ModelConfig) -> str:
+    if config.provider_family == "none":
+        return "Assistant is disabled because no LLM provider is configured."
     reason = config.availability_reason or f"Provider {config.provider} is not available"
     return f"Model provider '{config.provider}' is not configured: {reason}"
 

api-service/api_service/routers/providers.py

@@ -20,6 +20,7 @@ def list_providers(context: AuthContext = Depends(get_context)) -> list[Provider
             provider_family=cfg.provider_family,
             model=cfg.model,
             role=cfg.role.value,
+            is_default=provider_registry.is_default_provider(cfg.role, cfg.provider),
             native_tool_calling=cfg.capabilities.native_tool_calling,
             json_mode=cfg.capabilities.json_mode,
             vision=cfg.capabilities.vision,

api-service/api_service/schemas.py

@@ -172,6 +172,7 @@ class ProviderSummary(BaseModel):
     provider_family: str
     model: str
     role: str
+    is_default: bool = False
     native_tool_calling: bool = False
     json_mode: bool = True
     vision: bool = False

backend_common/providers.py

@@ -85,6 +85,18 @@ def _openai_compatible_availability_reason(base_url: str | None) -> str | None:
     return None
 
 
+def _no_llm_config(role: ProviderRole) -> ModelConfig:
+    return ModelConfig(
+        provider="no-llm",
+        provider_family="none",
+        model="no-llm",
+        role=role,
+        capabilities=ProviderCapabilities(native_tool_calling=False, json_mode=False, vision=False, streaming=False),
+        available=False,
+        availability_reason="LLM setup was skipped during install",
+    )
+
+
 class ProviderRegistry:
     def __init__(self) -> None:
         default_openai_capabilities = ProviderCapabilities(
@@ -118,6 +130,7 @@ def __init__(self) -> None:
                     available=chat_availability_reason is None,
                     availability_reason=chat_availability_reason,
                 ),
+                _no_llm_config(ProviderRole.chat),
             ],
             ProviderRole.orchestration: [
                 ModelConfig(
@@ -131,6 +144,7 @@ def __init__(self) -> None:
                     available=orchestration_availability_reason is None,
                     availability_reason=orchestration_availability_reason,
                 ),
+                _no_llm_config(ProviderRole.orchestration),
             ],
             ProviderRole.embedding: [],
         }
@@ -235,6 +249,14 @@ def list_models(self) -> list[ModelConfig]:
         """Return all registered model configurations."""
         return [config for configs in self._configs.values() for config in configs]
 
+    def default_provider_for_role(self, role: ProviderRole) -> str | None:
+        """Return the configured default provider name for a model role."""
+        return self._default_provider_by_role.get(role)
+
+    def is_default_provider(self, role: ProviderRole, provider: str) -> bool:
+        """Return whether a provider matches the configured default for a role."""
+        return _normalize_provider_name(provider) == _normalize_provider_name(self.default_provider_for_role(role))
+
     def get(self, role: ProviderRole, provider_override: str | None = None, model_override: str | None = None) -> ModelConfig:
         """Resolve the active provider configuration for a role."""
         configs = self._configs[role]
@@ -315,6 +337,9 @@ def build_chat_model(self, role: ProviderRole, provider_override: str | None = N
                 temperature=0,
             )
 
+        if config.provider_family == "none":
+            raise ValueError(config.availability_reason or "Assistant is disabled because no LLM provider is configured")
+
         raise ValueError(f"Unsupported provider family: {config.provider_family}")
 
 

client/src/components/Chat.tsx

@@ -10,7 +10,7 @@ import type {
     ToolCallEntry,
     ReasoningEntry,
 } from '../types';
-import { appFetch, clearAssistantHistory, fetchAssistantHistory, parseError, reportClientError } from '../utils/api';
+import { appFetch, clearAssistantHistory, fetchAssistantHistory, fetchProviders, parseError, reportClientError } from '../utils/api';
 
 export type { ChatMessage };
 
@@ -249,6 +249,7 @@ export function Chat({ externalMessages = [], style, hideHeader = false, current
     const [isLoading, setIsLoading] = useState(false);
     const [loadingMessage, setLoadingMessage] = useState<string>(STATUS_MESSAGES[1]);
     const [isClearing, setIsClearing] = useState(false);
+    const [assistantDisabledMessage, setAssistantDisabledMessage] = useState<string | null>(null);
     const scrollRef = useRef<HTMLDivElement>(null);
     const abortRef = useRef<AbortController | null>(null);
     const historyRequestVersionRef = useRef(0);
@@ -283,6 +284,33 @@ export function Chat({ externalMessages = [], style, hideHeader = false, current
         };
     }, [workspaceId, caseId, scope]);
 
+    useEffect(() => {
+        let cancelled = false;
+        void fetchProviders()
+            .then((providers) => {
+                if (cancelled) return;
+                const chatProviders = providers.filter((provider) => provider.role === 'chat');
+                const defaultChatProvider = chatProviders.find((provider) => provider.is_default);
+                if (defaultChatProvider?.provider === 'no-llm' || defaultChatProvider?.provider_family === 'none') {
+                    setAssistantDisabledMessage('Assistant is disabled because LLM setup was skipped. You can still upload, view, and process cases.');
+                    return;
+                }
+                if (!defaultChatProvider && chatProviders.length > 0 && chatProviders.every((provider) => !provider.available)) {
+                    setAssistantDisabledMessage('Assistant is disabled because no LLM provider is configured. You can still upload, view, and process cases.');
+                    return;
+                }
+                setAssistantDisabledMessage(null);
+            })
+            .catch((error) => {
+                if (cancelled) return;
+                console.error('Failed to load provider configuration:', error);
+                setAssistantDisabledMessage(null);
+            });
+        return () => {
+            cancelled = true;
+        };
+    }, []);
+
     useEffect(() => {
         if (isLoading) {
             setLoadingMessage(prev => getRandomStatusMessage(prev));
@@ -338,7 +366,7 @@ export function Chat({ externalMessages = [], style, hideHeader = false, current
     }, [clearRequestToken, handleClear]);
 
     const handleSend = async () => {
-        if (!input.trim() || isLoading || isClearing) return;
+        if (!input.trim() || isLoading || isClearing || assistantDisabledMessage) return;
 
         const userContent = buildUserContent(input, currentLocation, getMriSnapshots);
         if (userContent.error) {
@@ -598,6 +626,11 @@ export function Chat({ externalMessages = [], style, hideHeader = false, current
                         <span className="chat-spinner" aria-hidden="true" />
                     </div>
                 )}
+                {assistantDisabledMessage && (
+                    <div className="chat-message info">
+                        {assistantDisabledMessage}
+                    </div>
+                )}
             </div>
 
             <div className="chat-input-container">
@@ -607,7 +640,7 @@ export function Chat({ externalMessages = [], style, hideHeader = false, current
                     value={input}
                     onChange={e => setInput(e.target.value)}
                     onKeyDown={e => { if (e.key === 'Enter') void handleSend(); }}
-                    disabled={isClearing}
+                    disabled={isClearing || Boolean(assistantDisabledMessage)}
                 />
                 {isLoading ? (
                     <button
@@ -621,7 +654,7 @@ export function Chat({ externalMessages = [], style, hideHeader = false, current
                     <button
                         className="nc-btn nc-btn-active px-4"
                         onClick={() => void handleSend()}
-                        disabled={!input.trim() || isClearing}
+                        disabled={!input.trim() || isClearing || Boolean(assistantDisabledMessage)}
                     >
                         Send
                     </button>

client/src/types.ts

@@ -389,6 +389,20 @@ export interface AssistantHistoryResponse {
   messages: ChatMessage[];
 }
 
+export interface ProviderSummary {
+  provider: string;
+  provider_family: string;
+  model: string;
+  role: string;
+  is_default: boolean;
+  native_tool_calling: boolean;
+  json_mode: boolean;
+  vision: boolean;
+  streaming: boolean;
+  available: boolean;
+  availability_reason?: string | null;
+}
+
 export interface ArtifactListItem {
   id?: string;
   case_id?: string | null;

client/src/utils/api/assistant.ts

@@ -1,4 +1,4 @@
-import type { AssistantHistoryResponse, AssistantScope } from '../../types';
+import type { AssistantHistoryResponse, AssistantScope, ProviderSummary } from '../../types';
 
 import { appJson, appOk } from './core';
 
@@ -30,3 +30,7 @@ export async function clearAssistantHistory(
     method: 'DELETE',
   });
 }
+
+export async function fetchProviders(): Promise<ProviderSummary[]> {
+  return appJson<ProviderSummary[]>('/providers', 'Failed to fetch provider configuration');
+}

scripts/check_python_runtime.py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+"""Check NeuroCade Python runtime dependencies with a local startup sentinel."""
+
+from __future__ import annotations
+
+import argparse
+import hashlib
+import importlib
+import sys
+from pathlib import Path
+
+
+RUNTIME_MODULES = (
+    "fastapi",
+    "uvicorn",
+    "celery",
+    "redis",
+    "sqlalchemy",
+    "psycopg",
+    "pydantic_settings",
+    "langgraph",
+    "langchain_openai",
+    "neurocade_runtime_tools",
+)
+
+
+def dependency_key(pyproject: Path) -> str:
+    digest = hashlib.sha256(pyproject.read_bytes()).hexdigest()
+    version = f"{sys.version_info.major}.{sys.version_info.minor}"
+    return f"python-deps-v1|{sys.executable}|{version}|{digest}"
+
+
+def sentinel_current(sentinel: Path, key: str) -> bool:
+    try:
+        return sentinel.read_text(encoding="utf-8").strip() == key
+    except OSError:
+        return False
+
+
+def write_sentinel(sentinel: Path, key: str) -> None:
+    sentinel.parent.mkdir(parents=True, exist_ok=True)
+    temp = sentinel.with_name(f"{sentinel.name}.{id(key)}.tmp")
+    temp.write_text(f"{key}\n", encoding="utf-8")
+    temp.replace(sentinel)
+
+
+def check_imports() -> None:
+    for module_name in RUNTIME_MODULES:
+        importlib.import_module(module_name)
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Check NeuroCade Python runtime dependencies.")
+    parser.add_argument("--pyproject", required=True, type=Path)
+    parser.add_argument("--sentinel", required=True, type=Path)
+    args = parser.parse_args()
+
+    key = dependency_key(args.pyproject)
+    if sentinel_current(args.sentinel, key):
+        print("Python runtime dependencies already verified.")
+        return 0
+
+    check_imports()
+    write_sentinel(args.sentinel, key)
+    print("Python runtime dependencies already installed.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

scripts/install.sh

@@ -36,7 +36,7 @@ Options:
   --prerelease                    Clone the latest prerelease tag for fresh one-line installs.
   --dev                           Clone the repository default branch for fresh one-line installs.
   --mode local|internal|demo      Deployment profile. If omitted, prompts interactively.
-  --llm-provider NAME             openai-compatible, anthropic, google, or ollama.
+  --llm-provider NAME             openai-compatible, anthropic, google, ollama, or no-llm.
   --no-start                      Write configuration but do not start the Apptainer stack.
   --no-prereqs                    Do not install missing prerequisites such as uv, Node.js, Lima, or Apptainer.
   --desktop                       Prepare the local Electron desktop launcher.
@@ -604,7 +604,7 @@ prompt_desktop_shortcut() {
     echo "Skipping Desktop shortcut prompt under WSL."
     return
   fi
-  if confirm "Create a Desktop shortcut icon? Pros: one-click launch from the Desktop, uses the NeuroCade icon, and starts the local backend automatically. Cons: adds an icon/link to your Desktop folder and depends on the Electron launcher files staying in this install location." "y"; then
+  if confirm "Create a Desktop shortcut icon?" "y"; then
     create_desktop_shortcut "$root"
   fi
 }
@@ -787,7 +787,8 @@ main() {
           "openai-compatible|Custom OpenAI-compatible API base URL." \
           "anthropic|Anthropic Claude API." \
           "google|Google Gemini API." \
-          "ollama|Local Ollama server."
+          "ollama|Local Ollama server." \
+          "no-llm|Skip LLM setup; assistant features will be disabled."
       )"
     fi
   fi

scripts/install/common.sh

@@ -195,6 +195,9 @@ normalize_provider() {
     ollama|Ollama)
       printf 'ollama\n'
       ;;
+    no-llm|none|"No LLM"|"No LLM setup")
+      printf 'no-llm\n'
+      ;;
     *)
       echo "Invalid LLM provider: $1" >&2
       exit 2