HKUDS/RAG-Anything

Pattern Findings

626 matches across 13 categories. Click a row to expand file-level details.

Hyper-Verbose Identifiers266 hits · 276 pts

Severity	File	Line	Snippet
LOW	README.md	473	async def process_multimodal_content():
LOW	README.md	600	async def process_multimodal_content(self, modal_content, content_type, file_path, entity_name):
LOW	README.md	818	async def insert_content_list_example():
LOW	README_zh.md	452	async def process_multimodal_content():
LOW	README_zh.md	579	async def process_multimodal_content(self, modal_content, content_type, file_path, entity_name):
LOW	README_zh.md	796	async def insert_content_list_example():
LOW	reproduce/llm_answer_evaluator.py	46	def get_accuracy_evaluation_prompt(
LOW	reproduce/llm_answer_evaluator.py	491	async def evaluate_multiple_results(
LOW	reproduce/llm_answer_evaluator.py	848	async def evaluate_standard_rag_results(
LOW	reproduce/llm_answer_evaluator.py	1058	def generate_evaluation_report(self, total_time: float):
LOW	reproduce/llm_answer_evaluator.py	1489	def load_existing_evaluations(self):
LOW	reproduce/llm_answer_evaluator.py	1544	def update_evaluation_results_list(self, new_results: List[Dict[str, Any]]):
LOW	reproduce/llm_answer_evaluator.py	1566	def persist_single_evaluation(self, evaluation_result: Dict[str, Any]):
LOW	reproduce/llm_answer_evaluator.py	89	def get_comprehensive_evaluation_prompt(
LOW	reproduce/llm_answer_evaluator.py	213	def create_fallback_evaluation(self, response: str) -> Dict[str, Any]:
LOW	tests/test_full_entities_merge.py	10	def _load_merge_logic_function_source():
LOW	tests/test_full_entities_merge.py	52	def test_implementation_preserves_existing_metadata_fields():
LOW	tests/test_full_entities_merge.py	59	def test_create_new_full_entities_entry():
LOW	tests/test_full_entities_merge.py	74	def test_preserves_existing_fields_when_merging_multimodal_entities():
LOW	tests/test_full_entities_merge.py	95	def test_deduplicates_new_entity_names_without_reordering_existing_ones():
LOW	tests/test_callbacks.py	36	def on_multimodal_item_complete(
LOW	tests/test_callbacks.py	64	def test_register_and_dispatch(self):
LOW	tests/test_callbacks.py	90	def test_register_rejects_non_callback(self):
LOW	tests/test_callbacks.py	95	def test_dispatch_handles_callback_errors(self):
LOW	tests/test_callbacks.py	105	def test_dispatch_unknown_event(self):
LOW	tests/test_callbacks.py	113	def test_event_log_disabled_by_default(self):
LOW	tests/test_callbacks.py	184	def test_process_document_emits_callbacks(self, monkeypatch, tmp_path):
LOW	tests/test_callbacks.py	239	def test_query_emits_callbacks(self, monkeypatch):
LOW	tests/test_resilience.py	21	def test_retries_on_transient_error(self):
LOW	tests/test_resilience.py	39	def test_raises_after_max_attempts(self):
LOW	tests/test_resilience.py	51	def test_does_not_retry_non_retryable(self):
LOW	tests/test_resilience.py	110	async def test_retries_on_transient_error(self):
LOW	tests/test_resilience.py	129	async def test_raises_after_max_attempts(self):
LOW	tests/test_resilience.py	143	def test_retry_rejects_invalid_max_attempts(self):
LOW	tests/test_resilience.py	156	def test_retry_rejects_invalid_delays(self):
LOW	tests/test_resilience.py	170	async def test_async_retry_rejects_invalid_max_attempts(self):
LOW	tests/test_resilience.py	184	async def test_async_retry_rejects_invalid_delays(self):
LOW	tests/test_resilience.py	199	def test_default_retry_does_not_retry_oserror_subclasses(self):
LOW	tests/test_resilience.py	217	def test_closed_state_allows_calls(self):
LOW	tests/test_resilience.py	227	def test_opens_after_threshold(self):
LOW	tests/test_resilience.py	243	def test_half_open_after_timeout(self):
LOW	tests/test_resilience.py	259	def test_failure_threshold_resets_outside_window(self):
LOW	tests/test_resilience.py	291	def test_application_error_does_not_trip_breaker(self):
LOW	tests/test_resilience.py	307	def test_half_open_allows_single_trial_call(self):
LOW	tests/test_insert_content_list.py	22	def _install_minimal_lightrag_stubs():
LOW	tests/test_insert_content_list.py	116	async def _ensure_lightrag_initialized(self):
LOW	tests/test_insert_content_list.py	124	def _generate_content_based_doc_id(self, content_list):
LOW	tests/test_insert_content_list.py	127	async def _process_multimodal_content(self, multimodal_items, file_ref, doc_id):
LOW	tests/test_insert_content_list.py	131	def test_insert_content_list_defers_status_until_after_text_insert():
LOW	tests/test_insert_content_list.py	157	def test_process_document_complete_defers_status_until_after_text_insert():
LOW	tests/test_insert_content_list.py	179	def test_process_document_complete_keeps_status_for_multimodal_only_content():
LOW	tests/test_insert_content_list.py	196	def test_insert_content_list_keeps_status_for_multimodal_only_content():
LOW	tests/test_doc_status_creation.py	75	async def test_insert_text_content_with_multimodal_falls_back_for_old_lightrag(
LOW	tests/test_doc_status_creation.py	121	async def test_process_document_complete_bootstraps_doc_status(
LOW	tests/test_doc_status_creation.py	169	async def fake_ensure_lightrag_initialized():
LOW	tests/test_doc_status_creation.py	196	async def test_image_only_document_falls_back_when_multimodal_flag_is_unsupported(
LOW	tests/test_doc_status_creation.py	246	async def fake_ensure_lightrag_initialized():
LOW	tests/test_doc_status_creation.py	263	async def fake_process_multimodal_content(multimodal_items, file_name, doc_id):
LOW	tests/test_doc_status_creation.py	292	async def test_compatibility_multimodal_cache_prevents_repeat_processing(
LOW	tests/test_doc_status_creation.py	340	async def fake_ensure_lightrag_initialized():
206 more matches not shown…

Excessive Try-Catch Wrapping166 hits · 149 pts

Severity	File	Line	Snippet
LOW	reproduce/query.py	270	except Exception as e:
LOW	reproduce/index.py	218	except Exception as e:
MEDIUM	reproduce/llm_answer_evaluator.py	1810	print(f"Error: result file does not exist: {file_path}")
MEDIUM	reproduce/llm_answer_evaluator.py	1797	print("Error: an OpenAI API key is required")
LOW	reproduce/llm_answer_evaluator.py	442	except Exception as e:
LOW	reproduce/llm_answer_evaluator.py	1518	except Exception as e:
LOW	reproduce/llm_answer_evaluator.py	1601	except Exception as e:
LOW	reproduce/llm_answer_evaluator.py	1621	except Exception:
LOW	reproduce/llm_answer_evaluator.py	1868	except Exception as e:
LOW	reproduce/llm_answer_evaluator.py	209	except Exception as e:
LOW	tests/test_close_event_loop.py	37	except Exception:
LOW	tests/test_close_event_loop.py	41	except Exception:
LOW	tests/testparser_kwargs.py	74	except Exception:
LOW	docs/enhanced_markdown.md	485	except Exception as e:
LOW	raganything/modalprocessors.py	116	except Exception as e:
LOW	raganything/modalprocessors.py	444	except Exception as e:
LOW	raganything/modalprocessors.py	856	except Exception as e:
LOW	raganything/modalprocessors.py	954	except Exception as e:
LOW	raganything/modalprocessors.py	1017	except Exception as e:
LOW	raganything/modalprocessors.py	1150	except Exception as e:
LOW	raganything/modalprocessors.py	1212	except Exception as e:
LOW	raganything/modalprocessors.py	1338	except Exception as e:
LOW	raganything/modalprocessors.py	1395	except Exception as e:
LOW	raganything/modalprocessors.py	1512	except Exception as e:
LOW	raganything/modalprocessors.py	1558	except Exception as e:
LOW	raganything/raganything.py	169	except Exception:
LOW	raganything/raganything.py	173	except Exception:
LOW	raganything/raganything.py	340	except Exception as e:
LOW	raganything/raganything.py	412	except Exception as e:
LOW	raganything/raganything.py	417	except Exception as e:
LOW	raganything/raganything.py	468	except Exception as e:
LOW	raganything/raganything.py	567	except Exception as e:
LOW	raganything/raganything.py	605	except Exception as e:
LOW	raganything/omml_extractor.py	196	except Exception as e: # pragma: no cover - defensive
LOW	raganything/query.py	172	except Exception as exc:
LOW	raganything/query.py	288	except Exception as e:
LOW	raganything/query.py	331	except Exception as e:
LOW	raganything/query.py	343	except Exception as e:
LOW	raganything/query.py	464	except Exception as e:
LOW	raganything/query.py	501	except Exception as e:
LOW	raganything/query.py	653	except Exception:
LOW	raganything/query.py	663	except Exception:
LOW	raganything/query.py	697	except Exception as e:
LOW	raganything/query.py	821	except Exception as e:
LOW	raganything/batch.py	138	except Exception as e:
LOW	raganything/batch.py	398	except Exception as e:
LOW	raganything/processor.py	313	except Exception as e:
LOW	raganything/processor.py	383	except Exception as e:
LOW	raganything/processor.py	551	except Exception as e:
LOW	raganything/processor.py	677	except Exception as e:
LOW	raganything/processor.py	714	except Exception as e:
LOW	raganything/processor.py	799	except Exception as e:
LOW	raganything/processor.py	839	except Exception as e:
LOW	raganything/processor.py	904	except Exception:
LOW	raganything/processor.py	980	except Exception as e:
LOW	raganything/processor.py	1184	except Exception as e:
LOW	raganything/processor.py	1204	except Exception as e:
LOW	raganything/processor.py	1298	except Exception as e:
LOW	raganything/processor.py	1356	except Exception as e:
LOW	raganything/processor.py	1528	except Exception as e:
106 more matches not shown…

Decorative Section Separators30 hits · 104 pts

Severity	File	Line	Snippet
MEDIUM	tests/test_close_event_loop.py	15	# ── Replicate the close() logic under test ──────────────────────────────
MEDIUM	tests/test_close_event_loop.py	45	# ── Tests ──────────────────────────────────────────────────────────────
MEDIUM	tests/test_core_modules.py	118	# ── Content Separation Tests ─────────────────────────────────────
MEDIUM	tests/test_core_modules.py	177	# ── Image Encoding Tests ─────────────────────────────────────────
MEDIUM	tests/test_core_modules.py	23	# ── DocStatus Tests ──────────────────────────────────────────────
MEDIUM	tests/test_core_modules.py	44	# ── RAGAnythingConfig Tests ──────────────────────────────────────
MEDIUM	tests/test_core_modules.py	201	# ── Image Validation Tests ───────────────────────────────────────
MEDIUM	tests/test_core_modules.py	238	# ── Processor Type Mapping Tests ─────────────────────────────────
MEDIUM	tests/test_core_modules.py	289	# ── BatchProcessingResult Tests ──────────────────────────────────
MEDIUM	tests/test_core_modules.py	352	# ── BatchParser Initialization Tests ─────────────────────────────
MEDIUM	tests/test_minimax_integration.py	167	# ---------------------------------------------------------------------------
MEDIUM	tests/test_minimax_integration.py	169	# ---------------------------------------------------------------------------
MEDIUM	tests/test_minimax_integration.py	367	# ---------------------------------------------------------------------------
MEDIUM	tests/test_minimax_integration.py	369	# ---------------------------------------------------------------------------
MEDIUM	tests/test_minimax_integration.py	21	# ---------------------------------------------------------------------------
MEDIUM	tests/test_minimax_integration.py	23	# ---------------------------------------------------------------------------
MEDIUM	tests/test_minimax_integration.py	113	# ---------------------------------------------------------------------------
MEDIUM	tests/test_minimax_integration.py	115	# ---------------------------------------------------------------------------
MEDIUM	tests/test_minimax_integration.py	282	# ---------------------------------------------------------------------------
MEDIUM	tests/test_minimax_integration.py	284	# ---------------------------------------------------------------------------
MEDIUM	raganything/batch.py	30	# ==========================================
MEDIUM	raganything/batch.py	32	# ==========================================
MEDIUM	raganything/batch.py	173	# ==========================================
MEDIUM	raganything/batch.py	175	# ==========================================
MEDIUM	raganything/callbacks.py	71	# ── Parsing stage ─────────────────────────────────────────────
MEDIUM	raganything/callbacks.py	90	# ── Text insertion stage ──────────────────────────────────────
MEDIUM	raganything/callbacks.py	101	# ── Multimodal processing stage ───────────────────────────────
MEDIUM	raganything/callbacks.py	126	# ── Query stage ───────────────────────────────────────────────
MEDIUM	raganything/callbacks.py	149	# ── Document complete ─────────────────────────────────────────
MEDIUM	raganything/callbacks.py	168	# ── Batch processing ──────────────────────────────────────────

Magic Placeholder Names16 hits · 78 pts

Severity	File	Line	Snippet
HIGH	README.md	337	api_key = "your-api-key"
HIGH	README.md	475	api_key = "your-api-key"
HIGH	README.md	693	api_key = "your-api-key"
HIGH	README.md	820	api_key = "your-api-key"
HIGH	README.md	1019	python examples/raganything_example.py path/to/document.pdf --api-key YOUR_API_KEY --parser mineru
HIGH	README.md	1022	python examples/modalprocessors_example.py --api-key YOUR_API_KEY
HIGH	README_zh.md	314	api_key = "your-api-key"
HIGH	README_zh.md	454	api_key = "your-api-key"
HIGH	README_zh.md	671	api_key = "your-api-key"
HIGH	README_zh.md	798	api_key = "your-api-key"
HIGH	README_zh.md	997	python examples/raganything_example.py path/to/document.pdf --api-key YOUR_API_KEY --parser mineru
HIGH	README_zh.md	1000	python examples/modalprocessors_example.py --api-key YOUR_API_KEY
HIGH	examples/minimax_integration_example.py	29	export MINIMAX_API_KEY=your-api-key
HIGH	examples/minimax_integration_example.py	72	"Set it with: export MINIMAX_API_KEY=your-api-key"
HIGH	examples/minimax_integration_example.py	154	print(" Set it with: export MINIMAX_API_KEY=your-api-key")
HIGH	examples/minimax_integration_example.py	265	" MINIMAX_API_KEY=your-api-key\n"

Deep Nesting64 hits · 44 pts

Severity	File	Line
LOW	setup.py	14
LOW	reproduce/query.py	90
LOW	reproduce/llm_answer_evaluator.py	159
LOW	reproduce/llm_answer_evaluator.py	213
LOW	reproduce/llm_answer_evaluator.py	286
LOW	reproduce/llm_answer_evaluator.py	491
LOW	reproduce/llm_answer_evaluator.py	759
LOW	reproduce/llm_answer_evaluator.py	848
LOW	reproduce/llm_answer_evaluator.py	1058
LOW	tests/test_full_entities_merge.py	10
LOW	tests/test_close_event_loop.py	18
LOW	raganything/modalprocessors.py	68
LOW	raganything/modalprocessors.py	139
LOW	raganything/modalprocessors.py	179
LOW	raganything/modalprocessors.py	212
LOW	raganything/modalprocessors.py	244
LOW	raganything/modalprocessors.py	285
LOW	raganything/modalprocessors.py	603
LOW	raganything/raganything.py	143
LOW	raganything/raganything.py	258
LOW	raganything/omml_extractor.py	111
LOW	raganything/omml_extractor.py	218
LOW	raganything/query.py	26
LOW	raganything/query.py	195
LOW	raganything/query.py	475
LOW	raganything/query.py	589
LOW	raganything/query.py	708
LOW	raganything/query.py	618
LOW	raganything/processor.py	200
LOW	raganything/processor.py	386
LOW	raganything/processor.py	607
LOW	raganything/processor.py	725
LOW	raganything/processor.py	1107
LOW	raganything/processor.py	1302
LOW	raganything/processor.py	1391
LOW	raganything/processor.py	2098
LOW	raganything/parser.py	2525
LOW	raganything/parser.py	92
LOW	raganything/parser.py	194
LOW	raganything/parser.py	344
LOW	raganything/parser.py	714
LOW	raganything/parser.py	960
LOW	raganything/parser.py	1151
LOW	raganything/parser.py	1373
LOW	raganything/parser.py	1566
LOW	raganything/parser.py	1846
LOW	raganything/parser.py	2099
LOW	raganything/parser.py	2205
LOW	raganything/parser.py	2237
LOW	raganything/parser.py	2111
LOW	raganything/enhanced_markdown.py	370
LOW	raganything/enhanced_markdown.py	403
LOW	raganything/batch_parser.py	376
LOW	raganything/batch_parser.py	110
LOW	raganything/batch_parser.py	203
LOW	raganything/resilience.py	146
LOW	raganything/resilience.py	188
LOW	raganything/resilience.py	190
LOW	examples/office_document_test.py	49
LOW	examples/minimax_integration_example.py	150
4 more matches not shown…

Self-Referential Comments9 hits · 33 pts

Severity	File	Line	Snippet
MEDIUM	reproduce/llm_answer_evaluator.py	1813	# Create the configuration.
MEDIUM	reproduce/llm_answer_evaluator.py	1816	# Create the evaluator.
MEDIUM	raganything/query.py	41	# Create a normalized representation of the query parameters
MEDIUM	raganything/processor.py	231	# Create a content signature
MEDIUM	raganything/parser.py	134	# Create a temporary file with the correct extension
MEDIUM	examples/batch_processing_example.py	323	# Create a directory structure with nested files
MEDIUM	examples/batch_processing_example.py	326	# Create main directory files
MEDIUM	scripts/create_tiktoken_cache.py	4	# Define the directory where you want to store the cache
MEDIUM	scripts/create_tiktoken_cache.py	9	# Create the directory if it doesn't exist

Unused Imports31 hits · 30 pts

Severity	File	Line
LOW	tests/test_asset_urls.py	3
LOW	tests/test_raganything_example.py	1
LOW	tests/test_omml_extractor.py	8
LOW	raganything/omml_extractor.py	40
LOW	raganything/batch.py	16
LOW	raganything/prompt_manager.py	18
LOW	raganything/__init__.py	1
LOW	raganything/__init__.py	2
LOW	raganything/__init__.py	5
LOW	raganything/__init__.py	9
LOW	raganything/__init__.py	9
LOW	raganything/__init__.py	9
LOW	raganything/__init__.py	9
LOW	raganything/__init__.py	21
LOW	raganything/__init__.py	21
LOW	raganything/__init__.py	21
LOW	raganything/__init__.py	35
LOW	raganything/__init__.py	35
LOW	raganything/__init__.py	35
LOW	raganything/__init__.py	35
LOW	raganything/__init__.py	48
LOW	raganything/__init__.py	48
LOW	raganything/__init__.py	48
LOW	raganything/__init__.py	48
LOW	raganything/__init__.py	48
LOW	raganything/parser.py	24
LOW	raganything/asset_urls.py	14
LOW	raganything/callbacks.py	23
LOW	raganything/prompts_zh.py	11
LOW	raganything/prompt.py	8
LOW	raganything/resilience.py	11

Redundant / Tautological Comments19 hits · 30 pts

Severity	File	Line	Snippet
LOW	reproduce/query.py	305	# Check if API key is provided
LOW	reproduce/index.py	253	# Check if API key is provided
LOW	raganything/modalprocessors.py	163	# Check if item is within context window and matches filter criteria
LOW	raganything/query.py	125	# Check if VLM enhanced query should be used
LOW	raganything/query.py	636	# Check if it's in the current working directory or subdirectories
LOW	raganything/processor.py	652	# Check if multimodal content is already processed
LOW	raganything/parser.py	986	# Check if this subdirectory contains the expected JSON output file
LOW	raganything/parser.py	1590	# Check if input is a URL
LOW	raganything/enhanced_markdown.py	36	# Check if pandoc module exists (not used directly, just for detection)
LOW	raganything/enhanced_markdown.py	104	# Check if pandoc is installed on system
LOW	raganything/enhanced_markdown.py	511	# Check if input file is provided
LOW	raganything/utils.py	174	# Check if file exists and is not a symlink (for security)
LOW	examples/office_document_test.py	54	# Check if file exists and is a supported Office format
LOW	examples/raganything_example.py	307	# Check if API key is provided
LOW	examples/batch_processing_example.py	162	# Display results
LOW	examples/batch_processing_example.py	220	# Display results
LOW	examples/image_format_test.py	60	# Check if file exists and is a supported image format
LOW	examples/insert_content_list_example.py	415	# Check if API key is provided
LOW	examples/text_format_test.py	43	# Check if file exists and is a supported text format

Verbosity Indicators12 hits · 18 pts

Severity	File	Line	Snippet
LOW	raganything/batch.py	356	# Step 1: Parse documents in batch
LOW	raganything/batch.py	367	# Step 2: Process with RAG
LOW	raganything/processor.py	1702	# Step 1: Parse document
LOW	raganything/processor.py	1711	# Step 2: Separate text and multimodal content
LOW	raganything/processor.py	1735	# Step 3: Insert pure text content with all parameters
LOW	raganything/processor.py	1772	# Step 4: Process multimodal content (using specialized processors)
LOW	raganything/processor.py	1968	# Step 1: Parse document
LOW	raganything/processor.py	2015	# Step 2: Separate text and multimodal content
LOW	raganything/processor.py	2027	# Step 3: Insert pure text content and multimodal content with all parameters
LOW	raganything/processor.py	2173	# Step 1: Separate text and multimodal content
LOW	raganything/processor.py	2197	# Step 2: Insert pure text content with all parameters
LOW	raganything/processor.py	2233	# Step 3: Process multimodal content (using specialized processors)

Cross-File Repetition3 hits · 15 pts

Severity	File	Snippet
HIGH	reproduce/query.py	process document with raganything args: file_path: path to the document output_dir: output directory for rag results api
HIGH	reproduce/index.py	process document with raganything args: file_path: path to the document output_dir: output directory for rag results api
HIGH	examples/raganything_example.py	process document with raganything args: file_path: path to the document output_dir: output directory for rag results api

AI Slop Vocabulary7 hits · 14 pts

Severity	File	Line	Snippet
MEDIUM	reproduce/llm_answer_evaluator.py	270	# For comprehensive evaluation, try to extract additional metrics.
LOW	tests/test_custom_parser.py	167	# Do not touch the filesystem; just return a dummy result.
MEDIUM	raganything/modalprocessors.py	1410	"""Parse equation analysis response with robust JSON handling"""
MEDIUM	raganything/omml_extractor.py	52	# them to construct fully qualified tag names so that lookups are robust to
MEDIUM	examples/enhanced_markdown_example.py	30	"""Create comprehensive sample markdown content for testing"""
MEDIUM	examples/enhanced_markdown_example.py	898	# Demonstrate robust conversion with fallbacks
MEDIUM	examples/enhanced_markdown_example.py	920	# Test robust conversion

Docstring Block Structure2 hits · 10 pts

Severity	File	Line	Snippet
HIGH	raganything/query.py	203	Multimodal query - combines text and multimodal content for querying Args: query: Base que
HIGH	raganything/parser.py	2494	Get a parser instance by name. Checks built-in parsers first, then falls back to the custom parser registry pop

Over-Commented Block1 hit · 1 pts

Severity	File	Line	Snippet
LOW	requirements.txt	1	huggingface_hub

Score History

Severity Breakdown

Pattern Findings