{"about":{"site":"https://codewithpapers.app","non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page"},"url":"/paper/arxiv-2603-07612","title":"KohakuRAG: A simple RAG framework with hierarchical document indexing","arxiv_id":"2603.07612","date":"2026-03-08","proceeding":null,"authors":["Shih-Ying Yeh","Yueh-Feng Ku","Ko-Wei Huang","Buu-Khang Tu"],"abstract":"Retrieval-augmented generation (RAG) systems that answer questions from document collections face compounding difficulties when high-precision citations are required: flat chunking strategies sacrifice document structure, single-query formulations miss relevant passages through vocabulary mismatch, and single-pass inference produces stochastic answers that vary in both content and citation selection. We present KohakuRAG, a hierarchical RAG framework that preserves document structure through a four-level tree representation (document $\\rightarrow$ section $\\rightarrow$ paragraph $\\rightarrow$ sentence) with bottom-up embedding aggregation, improves retrieval coverage through an LLM-powered query planner with cross-query reranking, and stabilizes answers through ensemble inference with abstention-aware voting. We evaluate on the WattBot 2025 Challenge, a benchmark requiring systems to answer technical questions from 32 documents with $\\pm$0.1% numeric tolerance and exact source attribution. KohakuRAG achieves first place on both public and private leaderboards (final score 0.861), as the only team to maintain the top position across both evaluation partitions. Ablation studies reveal that prompt ordering (+80% relative), retry mechanisms (+69%), and ensemble voting with blank filtering (+1.2pp) each contribute substantially, while hierarchical dense retrieval alone matches hybrid sparse-dense approaches (BM25 adds only +3.1pp). We release KohakuRAG as open-source software at https://github.com/KohakuBlueleaf/KohakuRAG.","url_abs":"https://arxiv.org/abs/2603.07612","url_pdf":"https://arxiv.org/pdf/2603.07612","source":{"archive":null,"snapshot":"2025-07-28","note":"not in the Papers with Code archive (frozen at the snapshot)","row_kind":"graph","title_abstract_authors_date":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)"},"code_links":[],"tasks":[],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":"https://syntology.ai/paper/2603.07612","atlas_url":"https://app.syntology.ai/?focus=2603.07612","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2603.07612"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-25T09:33:49+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","claim":"Per-sample execution status on synthesized fixtures; not a correctness claim about the paper. Samples come from repositories linked to the paper, official or community; repo_kind says which.","repos":[{"mentioned_in_github":null,"is_official":null,"provenance":"deterministic:regex_extraction","mentioned_in_paper":null,"url":"https://github.com/KohakuBlueleaf/KohakuRAG","reach":null}],"summary":{"ran":8,"ran_violates":1,"ran_fixture":1,"ran_draft_wrong":5,"unverified":3},"by_repo_kind":{"found_in_text":{"samples":18,"ran":15,"repositories":1}},"repo_kind_vocabulary":{"official":"The archive marks this repository official for the paper","named_in_paper":"The archive records that the paper mentions this repository; it is not marked official","listed":"In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper","found_in_text":"Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted","community":"Not in the archive's code links for this paper; a community repository Syntology harvested"},"n_pointer_only_for_licence":18,"samples":[{"code_sha256_prefix":"46e8ab27730924a9","entry":"DocumentPayload","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"46e8ab27730924a9"}},{"code_sha256_prefix":"320e151285bf8507","entry":"JinaEmbeddingModel","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"320e151285bf8507"}},{"code_sha256_prefix":"aea7e26e65d857e5","entry":"ParagraphPayload","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"aea7e26e65d857e5"}},{"code_sha256_prefix":"6a3228ba6030b84c","entry":"SectionPayload","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"6a3228ba6030b84c"}},{"code_sha256_prefix":"069158d689ff80d8","entry":"SentencePayload","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"069158d689ff80d8"}},{"code_sha256_prefix":"15c952712553def5","entry":"StoredNode","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"15c952712553def5"}},{"code_sha256_prefix":"500778942c83248c","entry":"TreeNode","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"500778942c83248c"}},{"code_sha256_prefix":"e08819c54ed28b5a","entry":"_detect_device","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"e08819c54ed28b5a"}},{"code_sha256_prefix":"01bc94c373659103","entry":"_normalize","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"01bc94c373659103"}},{"code_sha256_prefix":"1bb38824b3bd6c48","entry":"average_embeddings","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran_fixture","verification_level":1,"contract_check":"RAISES","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"1bb38824b3bd6c48"}},{"code_sha256_prefix":"0287add59cf39750","entry":"paragraph_payload_from_text","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"0287add59cf39750"}},{"code_sha256_prefix":"f087c84a8cc6ed08","entry":"sections_from_text","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"f087c84a8cc6ed08"}},{"code_sha256_prefix":"aebc0efc1e03e644","entry":"sentence_payloads_from_text","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"aebc0efc1e03e644"}},{"code_sha256_prefix":"80f1ea2827f23418","entry":"split_paragraphs","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"80f1ea2827f23418"}},{"code_sha256_prefix":"7d740ec94a7e44e8","entry":"split_sentences","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"7d740ec94a7e44e8"}},{"code_sha256_prefix":"c3d5d1849212a614","entry":"DocumentIndexer","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"c3d5d1849212a614"}},{"code_sha256_prefix":"1d1accc5bae7d216","entry":"EmbeddingModel","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"1d1accc5bae7d216"}},{"code_sha256_prefix":"1bf84862f6855b5b","entry":"NodeKind","repo":"KohakuBlueleaf/KohakuRAG","repo_kind":"found_in_text","path":"src/kohakurag/indexer.py","file_url":"https://github.com/KohakuBlueleaf/KohakuRAG/blob/HEAD/src/kohakurag/indexer.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"1bf84862f6855b5b"}}]},"arxiv_metadata":{"licence":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)","fields":["title","abstract","authors","date"],"primary_category":"cs.CL","source":"arxiv_2026.jsonl"},"syntology_extracted_results":{"kind":"leaderboard_placements","source":"Syntology's leaderboard-shaped extractor over the paper's own arXiv-HTML tables: a model pointed at a cell, the number was read from that cell and checked against the board's metric, dataset, split and scale, and an independent check accepted the entry; not reviewed by the paper's authors or the archive's editors","extractor_model":"global.anthropic.claude-sonnet-4-5-20250929-v1:0","verifier_model":null,"prompt_sha":"fa63d4bb9d755694","coverage":{"sentence":"Syntology has checked 6,885 of the 9,623 papers on this site that are newer than the archive; results from the others appear after they are checked.","papers_newer_than_archive":9623,"papers_checked":6885},"entries":[],"not_placed":{"boards":0,"rejected_by_independent_check":0,"refused_by_a_rule":0,"check_did_not_answer":0,"proposed_without_a_cell":0,"declined_by_site":0}}}