local-deep-research 0.4.0__py3-none-any.whl → 0.4.2__py3-none-any.whl

local_deep_research/__init__.py

@@ -9,6 +9,7 @@ from .__version__ import __version__
 from .config.llm_config import get_llm
 from .config.search_config import get_search
 from .report_generator import get_report_generator
+from .web.app import main
 
 
 def get_advanced_search_system(strategy_name: str = "iterdrag"):

local_deep_research/__version__.py

@@ -1 +1 @@
-__version__ = "0.4.0"
+__version__ = "0.4.2"

local_deep_research/config/llm_config.py

@@ -79,7 +79,7 @@ def get_llm(model_name=None, temperature=None, provider=None, openai_endpoint_ur
     if get_db_setting("llm.supports_max_tokens", True):
         # Use 80% of context window to leave room for prompts
         max_tokens = min(
-            get_db_setting("llm.max_tokens", 30000), int(context_window_size * 0.8)
+            int(get_db_setting("llm.max_tokens", 30000)), int(context_window_size * 0.8)
         )
         common_params["max_tokens"] = max_tokens
 

local_deep_research/defaults/default_settings.json

@@ -342,7 +342,7 @@
         "options": null,
         "step": 0.05,
         "type": "LLM",
-        "ui_element": "slider",
+        "ui_element": "range",
         "value": 0.7,
         "visible": true
     },

local_deep_research/web/app.py

@@ -94,7 +94,14 @@ def main():
     debug = get_db_setting("web.debug", True)
 
     logger.info(f"Starting web server on {host}:{port} (debug: {debug})")
-    socketio.run(app, debug=debug, host=host, port=port, allow_unsafe_werkzeug=True)
+    socketio.run(
+        app,
+        debug=debug,
+        host=host,
+        port=port,
+        allow_unsafe_werkzeug=True,
+        use_reloader=False,
+    )
 
 
 if __name__ == "__main__":

local_deep_research/web/services/research_service.py

@@ -1,8 +1,8 @@
 import hashlib
 import json
-import os
 import threading
 from datetime import datetime
+from pathlib import Path
 
 from loguru import logger
 
@@ -15,7 +15,7 @@ from ..models.database import add_log_to_db, calculate_duration, get_db_connecti
 from .socket_service import emit_to_subscribers
 
 # Output directory for research results
-OUTPUT_DIR = "research_outputs"
+OUTPUT_DIR = Path("research_outputs")
 
 
 def start_research_process(
@@ -68,7 +68,7 @@ def start_research_process(
     return thread
 
 
-def _generate_report_path(query: str) -> str:
+def _generate_report_path(query: str) -> Path:
     """
     Generates a path for a new report file based on the query.
 
@@ -82,9 +82,8 @@ def _generate_report_path(query: str) -> str:
     # Generate a unique filename that does not contain
     # non-alphanumeric characters.
     query_hash = hashlib.md5(query.encode("utf-8")).hexdigest()[:10]
-    return os.path.join(
-        OUTPUT_DIR,
-        f"research_report_{query_hash}_{datetime.now().isoformat()}.md",
+    return OUTPUT_DIR / (
+        f"research_report_{query_hash}_{int(datetime.now().timestamp())}.md"
     )
 
 
@@ -139,8 +138,8 @@ def run_research_process(
         )
 
         # Set up the AI Context Manager
-        output_dir = os.path.join(OUTPUT_DIR, f"research_{research_id}")
-        os.makedirs(output_dir, exist_ok=True)
+        output_dir = OUTPUT_DIR / f"research_{research_id}"
+        output_dir.mkdir(parents=True, exist_ok=True)
 
         # Set up progress callback
         def progress_callback(message, progress_percent, metadata):
@@ -532,9 +531,7 @@ def run_research_process(
                     )
 
                     # Save as markdown file
-                    if not os.path.exists(OUTPUT_DIR):
-                        os.makedirs(OUTPUT_DIR)
-
+                    OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
                     report_path = _generate_report_path(query)
 
                     # Send progress update for writing to file
@@ -545,7 +542,7 @@ def run_research_process(
                     )
 
                     logger.info("Writing report to: %s", report_path)
-                    with open(report_path, "w", encoding="utf-8") as f:
+                    with report_path.open("w", encoding="utf-8") as f:
                         f.write("# Quick Research Summary\n\n")
                         f.write(f"Query: {query}\n\n")
                         f.write(clean_markdown)
@@ -583,7 +580,7 @@ def run_research_process(
                             "completed",
                             completed_at,
                             duration_seconds,
-                            report_path,
+                            str(report_path),
                             json.dumps(metadata),
                             research_id,
                         ),
@@ -598,7 +595,7 @@ def run_research_process(
                     progress_callback(
                         "Research completed successfully",
                         100,
-                        {"phase": "complete", "report_path": report_path},
+                        {"phase": "complete", "report_path": str(report_path)},
                     )
 
                     # Clean up resources
@@ -635,12 +632,10 @@ def run_research_process(
             )
 
             # Save as markdown file
-            if not os.path.exists(OUTPUT_DIR):
-                os.makedirs(OUTPUT_DIR)
-
+            OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
             report_path = _generate_report_path(query)
 
-            with open(report_path, "w", encoding="utf-8") as f:
+            with report_path.open("w", encoding="utf-8") as f:
                 f.write(final_report["content"])
 
             # Update database
@@ -668,7 +663,7 @@ def run_research_process(
                     "completed",
                     completed_at,
                     duration_seconds,
-                    report_path,
+                    str(report_path),
                     json.dumps(metadata),
                     research_id,
                 ),
@@ -679,7 +674,7 @@ def run_research_process(
             progress_callback(
                 "Research completed successfully",
                 100,
-                {"phase": "complete", "report_path": report_path},
+                {"phase": "complete", "report_path": str(report_path)},
             )
 
             # Clean up resources

local_deep_research/web/services/settings_manager.py

@@ -1,7 +1,7 @@
 import importlib.resources as pkg_resources
 import json
 import os
-from typing import Any, Dict, Optional, Union
+from typing import Any, Dict, Optional, Type, Union
 
 from loguru import logger
 from sqlalchemy import func
@@ -45,6 +45,15 @@ class SettingsManager:
     Provides methods to get and set settings, with the ability to override settings in memory.
     """
 
+    _UI_ELEMENT_TO_SETTING_TYPE = {
+        "text": str,
+        "password": str,
+        "select": str,
+        "number": float,
+        "range": float,
+        "checkbox": bool,
+    }
+
     def __init__(self, db_session: Session):
         """
         Initialize the settings manager
@@ -59,6 +68,57 @@ class SettingsManager:
         default_settings = pkg_resources.read_text(defaults, "default_settings.json")
         self.default_settings = json.loads(default_settings)
 
+    def __get_typed_setting_value(
+        self, setting: Type[Setting], default: Any = None, check_env: bool = True
+    ) -> str | float | bool | None:
+        """
+        Extracts the value for a particular setting, ensuring that it has the
+        correct type.
+
+        Args:
+            setting: The setting to get the value for.
+            default: Default value to return if the value of the setting is
+                invalid.
+            check_env: If true, it will check the environment variable for
+                this setting before reading from the DB.
+
+        Returns:
+            The value of the setting.
+
+        """
+        setting_type = self._UI_ELEMENT_TO_SETTING_TYPE.get(setting.ui_element, None)
+        if setting_type is None:
+            logger.warning(
+                "Got unknown type {} for setting {}, returning default value.",
+                setting.ui_element,
+                setting.key,
+            )
+            return default
+
+        # Check environment variable first, then database.
+        if check_env:
+            env_value = check_env_setting(setting.key)
+            if env_value is not None:
+                try:
+                    return setting_type(env_value)
+                except ValueError:
+                    logger.warning(
+                        "Setting {} has invalid value {}. Falling back to DB.",
+                        setting.key,
+                        env_value,
+                    )
+
+        # If environment variable does not exist, read from the database.
+        try:
+            return setting_type(setting.value)
+        except ValueError:
+            logger.warning(
+                "Setting {} has invalid value {}. Returning default.",
+                setting.key,
+                setting.value,
+            )
+            return default
+
     def get_setting(self, key: str, default: Any = None, check_env: bool = True) -> Any:
         """
         Get a setting value
@@ -72,11 +132,6 @@ class SettingsManager:
         Returns:
             Setting value or default if not found
         """
-        if check_env:
-            env_value = check_env_setting(key)
-            if env_value is not None:
-                return env_value
-
         # If using database first approach and session available, check database
         if self.db_first and self.db_session:
             try:
@@ -87,22 +142,17 @@ class SettingsManager:
                 )
                 if len(settings) == 1:
                     # This is a bottom-level key.
-                    value = settings[0].value
-                    return value
+                    return self.__get_typed_setting_value(
+                        settings[0], default, check_env
+                    )
                 elif len(settings) > 1:
                     # This is a higher-level key.
                     settings_map = {}
                     for setting in settings:
                         output_key = setting.key.removeprefix(f"{key}.")
-                        value = setting.value
-
-                        if check_env:
-                            # Handle possible replacements from environment variables.
-                            env_value = check_env_setting(setting.key)
-                            if env_value is not None:
-                                value = env_value
-
-                        settings_map[output_key] = value
+                        settings_map[output_key] = self.__get_typed_setting_value(
+                            setting, default, check_env
+                        )
                     return settings_map
             except SQLAlchemyError as e:
                 logger.error(f"Error retrieving setting {key} from database: {e}")
@@ -149,6 +199,7 @@ class SettingsManager:
                         value=value,
                         type=setting_type,
                         name=key.split(".")[-1].replace("_", " ").title(),
+                        ui_element="text",
                         description=f"Setting for {key}",
                     )
                     self.db_session.add(new_setting)

local_deep_research/web_search_engines/engines/search_engine_searxng.py

@@ -98,7 +98,7 @@ class SearXNGSearchEngine(BaseSearchEngine):
         self.language = language
         try:
             self.safe_search = SafeSearchSetting[safe_search]
-        except ValueError:
+        except KeyError:
             logger.error(
                 "'{}' is not a valid safe search setting. Disabling safe search",
                 safe_search,

local_deep_research/web_search_engines/search_engine_factory.py

@@ -49,8 +49,6 @@ def create_search_engine(
 
         # If not found, check the database for the API key
         if not api_key:
-            from ..utilities.db_utils import get_db_setting
-
             api_key = get_db_setting(f"search.engine.web.{engine_name}.api_key")
 
         # Still try to get from engine config if not found

{local_deep_research-0.4.0.dist-info → local_deep_research-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: local-deep-research
-Version: 0.4.0
+Version: 0.4.2
 Summary: AI-powered research assistant with deep, iterative analysis using LLMs and web searches
 Author-Email: LearningCircuit <185559241+LearningCircuit@users.noreply.github.com>, HashedViking <6432677+HashedViking@users.noreply.github.com>
 License: MIT License

{local_deep_research-0.4.0.dist-info → local_deep_research-0.4.2.dist-info}/RECORD

@@ -1,9 +1,9 @@
-local_deep_research-0.4.0.dist-info/METADATA,sha256=7uDHSL-BSiWwI_X9EbHquJ0BUNbyHxyUAMLzPZYJKZs,17352
-local_deep_research-0.4.0.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
-local_deep_research-0.4.0.dist-info/entry_points.txt,sha256=GcXS501Rjh-P80S8db7hnrQ23mS_Jg27PwpVQVO77as,113
-local_deep_research-0.4.0.dist-info/licenses/LICENSE,sha256=Qg2CaTdu6SWnSqk1_JtgBPp_Da-LdqJDhT1Vt1MUc5s,1072
-local_deep_research/__init__.py,sha256=9wV3oonZMEHsE_JhyZU9P0hW2Uwv47zotGlbAB_gQiA,885
-local_deep_research/__version__.py,sha256=42STGor_9nKYXumfeV5tiyD_M8VdcddX7CEexmibPBk,22
+local_deep_research-0.4.2.dist-info/METADATA,sha256=2YQpanXEg8odVlrIsUPgeLDW-pK8sUqQ0UD6qIrlmc4,17352
+local_deep_research-0.4.2.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
+local_deep_research-0.4.2.dist-info/entry_points.txt,sha256=GcXS501Rjh-P80S8db7hnrQ23mS_Jg27PwpVQVO77as,113
+local_deep_research-0.4.2.dist-info/licenses/LICENSE,sha256=Qg2CaTdu6SWnSqk1_JtgBPp_Da-LdqJDhT1Vt1MUc5s,1072
+local_deep_research/__init__.py,sha256=BPWOE6L1vBgBshHlyzrrp0gYo6uR3ljiNBFDRK_3aIw,911
+local_deep_research/__version__.py,sha256=6hfVa12Q-nXyUEXr6SyKpqPEDJW6vlRHyPxlA27PfTs,22
 local_deep_research/advanced_search_system/__init__.py,sha256=sGusMj4eFIrhXR6QbOM16UDKB6aI-iS4IFivKWpMlh0,234
 local_deep_research/advanced_search_system/filters/__init__.py,sha256=2dXrV4skcVHI2Lb3BSL2Ajq0rnLeSw7kc1MbIynMxa4,190
 local_deep_research/advanced_search_system/filters/base_filter.py,sha256=58Ux0ppXafL8Vy2qbWioUBMqGtK1dgtSF5A68BP8M8Y,1010
@@ -34,7 +34,6 @@ local_deep_research/advanced_search_system/tools/search_tools/__init__.py,sha256
 local_deep_research/api/__init__.py,sha256=KS5QcF5MzbUDPnXEzOAztcUw-HUQs4EVCH4k0YDMgCM,307
 local_deep_research/api/benchmark_functions.py,sha256=Fnv5-qVK0mpNJN6TEbltj6jxfohXLvtlTmcSzQ08NHw,8953
 local_deep_research/api/research_functions.py,sha256=jfpr6FdmtpLP_F63WvJPDptE6xqjzGpXyk0apkwe2Ns,9746
-local_deep_research/app.py,sha256=U_92UX0dpVAQoaXciVNy_By_AyDEWGlXSeTwFpohALQ,155
 local_deep_research/benchmarks/README.md,sha256=H1o_Ig-pjTAK_dDki3MyoUTS1A_zClTLhuiieTe_UKk,4346
 local_deep_research/benchmarks/__init__.py,sha256=O5uQKqUWoxiAvGEzbtCvcAhVuhKgyUksUjjE0fHv1DA,1287
 local_deep_research/benchmarks/benchmark_functions.py,sha256=XAOnw1sTXP2EcZY2zB0722BqeDEVIOpwZq9CC-1IoF4,11949
@@ -73,11 +72,11 @@ local_deep_research/benchmarks/runners.py,sha256=ktdEYgoVoQtToCJSKPMB7rF2fOzimFR
 local_deep_research/benchmarks/templates.py,sha256=ooRYTbFmSQCKxHVuXAYofTDTXAQ9yDaAUtKGqRaHy2E,2276
 local_deep_research/citation_handler.py,sha256=MZVd6xl7g3xrWauFBPuVIC36z8onc-zQb8xI4dQXxsU,4307
 local_deep_research/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-local_deep_research/config/llm_config.py,sha256=Y-56Bc05Kglh1jxTwa1xVLso7YBUGJqQHq3y_R-un34,16022
+local_deep_research/config/llm_config.py,sha256=31F-nlloP_N30HYZqnJ2sCNMZXlJVB9AMwz99UctHi4,16027
 local_deep_research/config/search_config.py,sha256=-m4BkHHMvzNkIuZmximmE3T5_H-JU4UZubEc_cDpWH0,2130
 local_deep_research/defaults/.env.template,sha256=_eVCy4d_XwpGXy8n50CG3wH9xx2oqJCFKS7IbqgInDk,491
 local_deep_research/defaults/__init__.py,sha256=C_0t0uZmtrVB4rM9NM9Wx8PJU5kFcT-qOHvws5W2iOg,1352
-local_deep_research/defaults/default_settings.json,sha256=k5H2pRXiOb0OeCfmgFKZqS9Rh3myjtHZDbnVNdDXxnQ,124257
+local_deep_research/defaults/default_settings.json,sha256=UTzWrOONlvR6UELT7remAN5qLLMLYvjnQXNMd0cH87w,124256
 local_deep_research/migrate_db.py,sha256=S1h6Bv0OJdRW4BaH7MIMrUXBRV_yqgH2T6LVOZKTQjI,4634
 local_deep_research/report_generator.py,sha256=-G3KDEbsuU3PdxDfuo5v28DIX7RE1yJCCBU2KgRbNzI,9084
 local_deep_research/search_system.py,sha256=DCBSLSUyLqPuHrgOuTlDizT_cnWRBICYKH-haMWWoDo,8412
@@ -93,7 +92,7 @@ local_deep_research/utilities/search_utilities.py,sha256=eew5w70tYTnm9J9Ov0TGCmg
 local_deep_research/utilities/setup_utils.py,sha256=0Us6doQ6xQtKzgtnN1C4L7sSgxzFKJ35FpmZdj1tCDM,213
 local_deep_research/utilities/url_utils.py,sha256=8tvLoar3Mq7xHFM_b5kp8Nf2Kdykz4C7wTejjUcg4vA,1714
 local_deep_research/web/__init__.py,sha256=CynnuRxCf9mB0AHeylhF5yVZwdj0H6bxVrZtniw3xmE,44
-local_deep_research/web/app.py,sha256=88Nz686YhK6Q4eFI_YvThG-AqIzPTQahdbXqPxKNI5M,3333
+local_deep_research/web/app.py,sha256=oDX022oim1tOawCdqN9uAtGeccvBGxIe7xtJenRLD3Y,3408
 local_deep_research/web/app_factory.py,sha256=mBv79XlEQ-H9-oSlBJZjv3hBVjBGZZ5piI4CZCh-jBU,8131
 local_deep_research/web/database/README.md,sha256=eEDLqLIfOBRvc0TFh3J1HrtFbZceYmVgpjS3-oyZ5nI,2861
 local_deep_research/web/database/migrate_to_ldr_db.py,sha256=-ltKuhgosPhybDsJ13BuvvHEDJTN4Jx6SiO6XvW0SKA,9823
@@ -107,9 +106,9 @@ local_deep_research/web/routes/benchmark_routes.py,sha256=WqJcI394ec3pzigRGUa6Gl
 local_deep_research/web/routes/history_routes.py,sha256=6a_8nX349viuvi1zP5S7BaPPpAh133eTi1NVWO545A8,12622
 local_deep_research/web/routes/research_routes.py,sha256=RkuT6VA5BlKzfeFzp3HvoEQajnUK34fFa8tto38NPps,23658
 local_deep_research/web/routes/settings_routes.py,sha256=Yt4xVt6XcGPSEFuAkcQ4zlZ2r5dIbV3VNsWIXoGeflw,58606
-local_deep_research/web/services/research_service.py,sha256=qHtPM5YOKQrtOSlKP3yhnZ0AjzTFQnH0aqUjsGBrVAs,38861
+local_deep_research/web/services/research_service.py,sha256=kHdonXtGDTSU2_jBlCP_deqMdydhxA_p7EabsR5kBkE,38812
 local_deep_research/web/services/resource_service.py,sha256=yKgOC6GEOmHqRoGzwf52e19UaGCCS1DbDbOIXgWGvGc,4378
-local_deep_research/web/services/settings_manager.py,sha256=Emo_QRnjVwi8HHT8N79io3SOUxPf_VwwwOHTTvJ1C-c,17238
+local_deep_research/web/services/settings_manager.py,sha256=xqEouK4DlzqYO83Ia3dve1JRXLAVB8MSSYTasyRD7Ag,18976
 local_deep_research/web/services/settings_service.py,sha256=-ZG78JR14GuhsaXIF4OQOqfRfrw2QIqYEKwTOFhsuFo,3497
 local_deep_research/web/services/socket_service.py,sha256=jZGXk6kesBOf4bAdLiT3V4Ofod12pGKTsvxr3ml8ydY,7272
 local_deep_research/web/static/css/custom_dropdown.css,sha256=-pCx6oazWVgwqFAGq_eZ8OrTKMVQlgkKYCM6w-bACLs,7949
@@ -167,12 +166,12 @@ local_deep_research/web_search_engines/engines/search_engine_guardian.py,sha256=
 local_deep_research/web_search_engines/engines/search_engine_local.py,sha256=RJEXb6wTPgTfQoOyuLYLZwqx0JU7yukehHiu4C0Zel4,41221
 local_deep_research/web_search_engines/engines/search_engine_local_all.py,sha256=8hAYhacU15Vi13pjo0LRVt2tI5SqcONDwYwvdtg1HyY,5620
 local_deep_research/web_search_engines/engines/search_engine_pubmed.py,sha256=O99qfbSz7RHqinAP_C0iod-ZaEGE5tyBbh1DJi2-VhQ,38495
-local_deep_research/web_search_engines/engines/search_engine_searxng.py,sha256=amEK2ljX-6QtJPBUB9fS0bE48Q8SmYInO2LaSq_x-Rw,17867
+local_deep_research/web_search_engines/engines/search_engine_searxng.py,sha256=gS-GjjLzjZvlaQB-E0u-IADzJmLRGZaLmNQ7DpdqMw4,17865
 local_deep_research/web_search_engines/engines/search_engine_semantic_scholar.py,sha256=jYs_TRM0izMfldsZ8NkCQsP-o6vCPXUjyxt0nIsxOVI,22799
 local_deep_research/web_search_engines/engines/search_engine_serpapi.py,sha256=_afKJVFV0xpdrO3vL71aORMIGmbe0y8o7Ly0_xXryDQ,8920
 local_deep_research/web_search_engines/engines/search_engine_wayback.py,sha256=rfRs7WJxa-H1DXSyduFHBMfpFwWEVRXLd8s_78iU8gU,17894
 local_deep_research/web_search_engines/engines/search_engine_wikipedia.py,sha256=UxYBSGD-XZGQantq_AdgtBA8FCKV0C6mEr6GS_vleQQ,10092
 local_deep_research/web_search_engines/search_engine_base.py,sha256=TFmkIGgzIkXFsk9jhGn2PYyxveOWzKQLrhpZy5qaggE,10803
-local_deep_research/web_search_engines/search_engine_factory.py,sha256=QjnU6R3Q0irTXG7StoeOwhbhd5B4nRKO65hkuodpWWU,11926
+local_deep_research/web_search_engines/search_engine_factory.py,sha256=73lwSenv7tK7eGIBOPh13hPdn0oZ9FC0EMjZx5YRPg4,11865
 local_deep_research/web_search_engines/search_engines_config.py,sha256=bRly8zsoXvlQIovbVChnkhj4AsGJMzFlEiArrmsblrE,5375
-local_deep_research-0.4.0.dist-info/RECORD,,
+local_deep_research-0.4.2.dist-info/RECORD,,

local_deep_research/app.py

@@ -1,8 +0,0 @@
-"""
-Main entry point for the Local Deep Research application.
-"""
-
-from src.local_deep_research.web.app import main
-
-if __name__ == "__main__":
-    main()