~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
Environment Settings System
Quick Start
# Use environment settings
from local_deep_research.settings.env_registry import is_test_mode
if is_test_mode():
# Running in test mode
pass
Architecture
env_settings.py: Base classes for all setting typesenv_registry.py: Global registry and convenience functionsenv_definitions/: Setting definitions by categorytesting.py: Test/CI flagsbootstrap.py: Pre-database settingsdb_config.py: Database configuration
Adding New Environment Settings
- Create setting in
env_definitions/category.py:
from ..env_settings import BooleanSetting
MY_SETTING = BooleanSetting(
key="category.my_setting",
env_var="LDR_MY_SETTING",
default=False,
description="My new setting"
)
- Register it:
from ..env_registry import registry
registry.register(MY_SETTING)
- Import module in
env_registry.py
Setting Types
BooleanSetting: True/false valuesIntegerSetting: Numbers with min/max validationStringSetting: Text valuesPathSetting: File paths with expansionSecretSetting: Sensitive values (hidden in logs)EnumSetting: Choice from predefined options
Environment Variables
Testing
LDR_TEST_MODE: Enable test modeCI: Running in CI
Bootstrap (needed before DB)
LDR_ENCRYPTION_KEY: Master encryption keyLDR_DATA_DIR: Data directoryLDR_DB_*: Database configuration
Integration
- Automatically works with SettingsManager
- Pre-commit hook recognizes all registered env vars
- Type-safe with automatic validation