researchharness 0.0.36__tar.gz

researchharness-0.0.36/.env.example

@@ -0,0 +1,31 @@
+# Required
+API_KEY="your_openai_compatible_key"                     # API key for your OpenAI-compatible LLM provider.
+API_BASE="https://your-openai-compatible-endpoint/v1"    # Base URL for the OpenAI-compatible chat-completions endpoint.
+MODEL_NAME="gpt-5.5"                                     # Main model used by the agent.
+SERPER_KEY="your_serper_key"                             # https://serper.dev/
+JINA_KEY="your_jina_key"                                 # https://jina.ai/
+MINERU_TOKEN="your_mineru_token"                         # https://mineru.net/
+
+# Optional
+WORKSPACE_ROOT="./workspace"                             # Default local workspace root when --workspace-root is not provided.
+MAX_LLM_CALL_PER_RUN=100                                 # Maximum chat-completions calls allowed in one agent run.
+MAX_AGENT_ROUNDS=100                                     # Maximum ReAct loop rounds before forced termination.
+MAX_AGENT_RUNTIME_SECONDS=9000                           # Maximum wall-clock runtime per agent run.
+LLM_TIMEOUT_SECONDS=600                                  # Timeout for each chat-completions request.
+WEBFETCH_TIMEOUT_SECONDS=180                             # Overall timeout for one WebFetch tool call.
+WEBFETCH_MAX_CHARS=30000                                 # Hard maximum characters returned by one WebFetch call.
+LLM_MAX_OUTPUT_TOKENS=10000                              # Maximum output tokens requested from the main model.
+MAX_INPUT_TOKENS=320000                                  # Maximum input-token budget used for runtime token accounting.
+LLM_MAX_RETRIES=10                                       # Maximum retries for transient LLM API failures.
+TEMPERATURE=0.6                                          # Main model sampling temperature.
+TOP_P=0.95                                               # Main model nucleus-sampling top_p.
+PRESENCE_PENALTY=1.1                                     # Main model presence penalty when supported by the provider.
+AUTO_COMPACT_TRIGGER_TOKENS="128k"                       # Context size threshold that triggers automatic memory compaction.
+IMAGE_PART_TOKEN_ESTIMATE=1536                           # Token estimate used for each runtime image_url content part.
+LLM_IMAGE_MAX_EDGE=1568                                  # Maximum image edge length sent to multimodal LLMs.
+LLM_IMAGE_MAX_BYTES=524288                               # Maximum compressed image payload size sent to multimodal LLMs.
+LLM_IMAGE_JPEG_QUALITY=85                                # Initial JPEG quality for runtime image compression.
+DEBUG_AGENT=false                                        # Print verbose agent-loop debug logs.
+DEBUG_SEARCH=false                                       # Print verbose WebSearch debug logs.
+DEBUG_SCHOLAR=false                                      # Print verbose ScholarSearch debug logs.
+DEBUG_VISIT=false                                        # Print verbose WebFetch debug logs.

researchharness-0.0.36/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wanghan Xu
+
+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.

researchharness-0.0.36/MANIFEST.in

@@ -0,0 +1,11 @@
+include LICENSE
+include README.md
+include VERSION
+include requirements.txt
+include .env.example
+recursive-include docs *.md
+recursive-include frontend/static *
+recursive-include benchmarks *.md *.png
+global-exclude local_*
+global-exclude __pycache__
+global-exclude *.py[cod]