~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.
Python academiaanthropicarxivbravedeep-researchencryptionhome-automationhomeserverlocallocal-deep-researchlocal-llmmistralollamaopenaipubmedresearchresearch-toolretrieval-augmented-generationsearxngself-hosted
# allow: no-sut-import — black-box HTTP test; drives real routes through the Flask test client
"""Test API v1 authentication guard."""
import pytest
class TestApiV1Auth:
"""Test that /api/v1/ endpoints require authentication."""
def test_unauthenticated_returns_401(self, client):
"""Requests with no username (no g.current_user, no session) get 401."""
response = client.get("/api/v1/")
assert response.status_code == 401
data = response.get_json() or {}
# FastAPI's require_auth raises HTTPException(401, detail=...);
# the message is exposed under "detail" (Flask used "error").
assert (data.get("detail") or data.get("error")) == (
"Authentication required"
)
def test_empty_username_rejected(self):
"""require_auth rejects an empty-string username.
A signed empty-username session can't be injected through the
Starlette TestClient (sessions are signed), so exercise the guard
directly: an empty/whitespace username is falsy and must 401.
"""
from unittest.mock import MagicMock
from fastapi import HTTPException
from local_deep_research.web.dependencies.auth import require_auth
req = MagicMock()
req.session = {"username": ""}
with pytest.raises(HTTPException) as exc:
require_auth(req)
assert exc.value.status_code == 401
def test_authenticated_via_g_current_user(self, authenticated_client):
"""A request with g.current_user set passes the auth guard."""
response = authenticated_client.get("/api/v1/")
# Should not be 401 — may be 200 or other status depending on
# downstream logic, but the auth guard itself should pass.
assert response.status_code != 401
def test_authenticated_via_session(self, authenticated_client):
"""A request with a valid session username passes the auth guard."""
# authenticated_client already has a registered user in the session
response = authenticated_client.get("/api/v1/")
assert response.status_code != 401
def test_health_endpoint_no_auth_required(self, client):
"""The /api/v1/health endpoint does not use @api_access_control."""
response = client.get("/api/v1/health")
# Health should return 200 even without authentication
assert response.status_code == 200