Initial commit: DeepQuery open-source deep research engine

Full-stack self-hosted research engine with LangGraph multi-agent pipeline,
6 LLM providers (including local Ollama/LM Studio), 5 search backends,
real-time SSE token streaming, reflection loops, SQLite history, and
Docker Compose one-command deploy.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: krishhlogan

.env.example

@@ -0,0 +1,41 @@
+# -- Default LLM provider ------------------------------------------------------
+# Users can override this per-request from the UI.
+# Options: anthropic | openai | gemini | groq | ollama | lmstudio
+LLM_PROVIDER=anthropic
+LLM_MODEL=claude-sonnet-4-6
+
+# -- Cloud API keys (add whichever you use) ------------------------------------
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+OPENAI_API_KEY=your_openai_api_key_here
+GEMINI_API_KEY=your_google_gemini_api_key_here
+GROQ_API_KEY=your_groq_api_key_here
+
+# -- Local providers (no key needed, just have them running) -------------------
+# Ollama:    run: ollama serve
+# LM Studio: enable local server in the app settings
+#
+# When running via Docker, set these to reach your host machine:
+#   OLLAMA_HOST=host.docker.internal
+#   LMSTUDIO_HOST=host.docker.internal
+# When running locally (no Docker), keep as localhost (the default):
+#   OLLAMA_HOST=localhost
+#   LMSTUDIO_HOST=localhost
+
+# -- Search --------------------------------------------------------------------
+# Options: auto | tavily | duckduckgo | arxiv | wikipedia | searxng
+# "auto" = uses Tavily if key is set, otherwise falls back to DuckDuckGo (free)
+SEARCH_PROVIDER=auto
+
+# Tavily — higher quality results, free tier at https://tavily.com
+TAVILY_API_KEY=your_tavily_api_key_here
+
+# Bing — optional, for SearXNG or direct Bing search
+# BING_API_KEY=
+
+# SearXNG — self-hosted meta-search engine
+# Run with: docker run -p 8080:8080 searxng/searxng
+# SEARXNG_URL=http://localhost:8080
+
+# -- App -----------------------------------------------------------------------
+APP_ENV=development
+LOG_LEVEL=INFO

.github/workflows/ci.yml

@@ -0,0 +1,54 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  backend:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: backend
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        run: pip install uv
+
+      - name: Install dependencies
+        run: uv pip install --system -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src/ tests/
+
+      - name: Test
+        run: pytest tests/ --cov=src --cov-report=term-missing
+        env:
+          ANTHROPIC_API_KEY: "test"
+          TAVILY_API_KEY: "test"
+
+  frontend:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: frontend
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: frontend/package-lock.json
+
+      - run: npm install
+      - run: npm run build

.gitignore

@@ -0,0 +1,28 @@
+# Environment
+.env
+*.env.local
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+venv/
+dist/
+*.egg-info/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Node
+node_modules/
+frontend/dist/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 DeepQuery Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.