ConceptioArchivearXiv CS
arXiv CSopen access

HLSFactory-Agent: Large-Scale Agentic HLS Dataset Construction from Academic and Open-Source Projects

· arxiv_cs
arXiv CS · Papers · License: Open Access
Open Source ↗Direct PDF ↓
software-architecturesoftware-engineeringtesting
software engineering, software architecture, testing

HLSFactory-Agent: Large-Scale Agentic HLS Dataset Construction from Academic and Open-Source Projects Kaushik Chandana1,∗ , Jay Imperatori1,∗ , Tanmay Shukla1,∗ , Justin Zhou1,∗ , Stefan Abi-Karam1,2 , Callie Hao1 1

Georgia Institute of Technology, Atlanta, USA 2 Georgia Tech Research Institute, Atlanta, USA {kchandana6, jimperatori6, tshukla31, justin.zhou, stefanabikaram, callie.hao}@gatech.edu

II. M ETHODOLOGY A. Design Curation from Academic Publications and Open-Source Code Repositories The computer architecture, FPGA, and EDA communities have opensourced many HLS designs on platforms like GitHub. We propose scraping relevant publications and finding their associated code repositories. Our source-indexing workflow searches for ”high-level synthesis,” ”high level synthesis,” and ”HLS” keywords across: • FPGA venues: FPGA, FCCM, FPL, FPT, HEART, TRETS • EDA venues: DAC, ICCAD, ASP-DAC, DATE, MLCAD, GLVLSI, HOST, TCAD • Architecture venues: ISCA, MICRO, HPCA, ASPLOS, ESWEEK, MLSys We provide scripts that search publications, merge, and deduplicate entries using keyword matching of titles and abstracts. The repository includes scrapers for DBLP, IEEE Xplore, and Crossref/ACM metadata. Deduplication uses DOI extraction when available and normalized title/year matching otherwise. Output is a CSV/Excel file of candidate papers with metadata and links. We collect 2,517 candidate publications (from between 1984–2026) potentially implementing HLS designs. These publications still require human review; some papers use HLS peripherally, some I. I NTRODUCTION artifacts are unavailable, and some repositories contain generated or vendor-specific code difficult to redistribute. Human curation High-level synthesis (HLS) enables domain-specific hardware identifies papers with public repositories, enabling efficient filtering experts to build flexible, high-performance hardware accelerators. for HLSFactory-Agent design extraction. Recent advances in deep learning and large language models have accelerated the HLS design workflow through quality-of-results B. Agentic Design Extraction from Codebases prediction models, fast design space exploration tools, and LLM-based HLSFactory-Agent is our LLM agent that automatically extracts frameworks for iterative design and optimization. In parallel, compiler HLS designs from unstructured repositories. Built on the open-source engineers have continuously improved HLS compilers to provide Pi agent framework [1], chosen for its simplicity and structured session higher-level design abstractions and faster compilation. logs that enable detailed analysis, it runs inside an Ubuntu Docker These innovations depend critically on access to large and diverse container via a Python API for isolation and reproducibility. This setup HLS design datasets and benchmarks. While popular community gives the LLM agent access to a C++ compiler (Clang), file reading, benchmarks exist, they remain limited in diversity and size, prompting writing, and editing tools, and Bash. We find this minimal toolset efforts to expand HLS design collections and build community dataset sufficient for the agent to self-test extracted designs. We assume that infrastructure. HLSFactory [3], our prior open-source framework, designs compilable with Clang have a high chance of synthesizing with addresses this need by providing infrastructure to curate HLS designs Vitis HLS, since HLS synthesis flows begin with C++ compilation. and automatically generate synthesis and implementation data as The agent prompt outlines the following extraction pipeline: complete packaged datasets for downstream research. Similarly, 1) Analyze the repository and identify all HLS designs or top-level evaluating large language models and agentic coding tools for HLS functions requires robust benchmark collections. Our prior work, HLS-Eval [2], 2) Create one output directory per design under provides this infrastructure with baseline evaluations for HLS code output_hls_designs/<design_name>/ generation and editing tasks. However, both HLSFactory and HLS-Eval 3) Copy all required source files, headers, utilities, and test data face a common bottleneck: manually curating HLS designs from into each design folder academic publications and open-source repositories is labor-intensive, 4) Convert non-Vitis constructs into Vitis-compatible forms error-prone, and requires substantial per-repository engineering effort. (ap_int, ap_fixed, hls::stream) To address this challenge, we present HLSFactory-Agent, an 5) Preserve existing testbenches or generate new ones when AI agent that automates large-scale HLS dataset curation by extracting none exist standalone, synthesizable designs from unstructured academic and 6) Compile source files with Clang in syntax-only mode using open-source repositories. Additionally, we provide open-source the Vitis include path scripts to scrape and index HLS-related papers from major computer 7) Generate a synth.tcl file with top-level function, source architecture, EDA, and FPGA conferences, enabling rapid discovery list, testbench list, target part, and csynth_design of candidate repositories for automated extraction. HLSFactory-Agent records the full agent session in a JSONL trace and exports an HTML transcript for debugging and analyzing ∗ Equal Contribution agent behavior, tool usage, runtime, and token cost.

arXiv:2609.09519v1 [cs.AR] 8 Sep 2026

Abstract—Building large, diverse datasets of high-level synthesis (HLS) designs beyond common community benchmarks remains an open challenge. This challenge is made urgent by the rise of deep learning and LLMs for hardware design, which demand such datasets to train QoR models and benchmark LLMs on HLS tasks. Despite ongoing efforts to broaden sources, dataset curation still depends on manual work: locating HLS designs across academic publications and open source, then extracting standalone designs from larger codebases. The process is error-prone and demands expert knowledge, iterative testing, and substantial per-repository engineering. To address this, we present HLSFactory-Agent, an LLM agent that automates large-scale HLS dataset curation by extracting standalone designs from larger codebases. HLSFactory-Agent runs the open-source Pi agent framework inside Docker containers to build and evaluate each extracted design. This turnkey automation allows users to pass a GitHub link or code directory to HLSFactory-Agent and receive a folder of extracted HLS designs ready to be integrated into the HLSFactory dataset framework. Additionally, we provide open-source scripts to scrape and index papers from computer architecture, EDA, and FPGA conferences that possibly implement or use HLS designs, allowing for faster human discovery and curation of HLS designs for HLSFactory-Agent. We report initial results from running HLSFactory-Agent across a small subset of our indexed repositories, demonstrating successful extraction of synthesizable designs from structured codebases. We open source HLSFactory-Agent and indexing scripts at github.com/sharc-lab/hlsfactory-agent.

Fig. 1: Passing and failing extracted designs by source repository. Green bars count candidate designs whose generated synth.tcl completes Vitis HLS synthesis, red bars count extracted candidates that fail validation, and red crosses mark repositories where the agent produced no candidate design folders. Our evaluation run extracts 271 candidate designs across 26 repositories: 130 passing and 141 failing. III. I NITIAL R ESULTS We evaluate HLSFactory-Agent using the DeepSeek-V4-Flash model on an initial set of 26 public repositories drawn from academic and open-source HLS projects. The set includes projects such as fpgaconvnet-hls, S2CBench, balor, DP-HLS, HP-FFT-HLS, CLINK, ThunderGP, gemm_hls, NN2FPGA, and multiple SFU-HiAccel repositories. We process each repository independently with its own HLSFactory-Agent launched in parallel. We then validate each extracted design using Vitis HLS to synthesize each extracted candidate design. We report a design as ”valid” or ”passing” only if the generated synth.tcl runs HLS synthesis and completes successfully. This is a strict check: designs that contain useful extracted code but fail due to Tcl errors, missing headers, target part issues, unsupported constructs, or timeouts count as failing. Across the 26 repositories, HLSFactory-Agent extracts 271 candidate designs. Of these, 130 pass Vitis HLS synthesis, and 141 fail. Five repositories produce no extracted designs in this initial run. Figure 1 summarizes passing and failing designs by source repository. Several repositories yield many passing designs, while others yield candidate designs but no passing designs, indicating that the agent found plausible kernels but did not extract them into valid standalone Vitis HLS designs. A final group of repositories yields no designs, either because the agent could not identify suitable kernels or because the repository structure was incompatible with the current prompt. Agent traces also reveal the extraction effort per source. Figure 2 plots extracted designs against model inference cost and agent runtime. Repositories yielding more designs require more inference effort. Some projects produce many designs cheaply because of regular structure and easily identified kernels. Others require more runtime for comparable yields because of complex dependencies, generated code, or build assumptions. This suggests that we should evaluate agentic extraction by designs per dollar spent and designs per minute run, not just by total extracted dataset size. IV. O NGOING / F UTURE W ORK As part of ongoing work, we aim to further automate the paper-by-paper review and associated code repository discovery using LLMs to review papers for open code repositories or search for associated repos, rather than relying on human review. Furthermore, we are working to allow HLSFactory-Agent to run Vitis HLS Synthesis within the Docker container to add another layer of verification feedback to the agent and catch more failing cases. Finally, as we extend HLSFactory-Agent and gather new designs, we plan to contribute these designs back to HLSFactory and HLS-Eval benchmarks, enriching design resources for the HLS community.

Fig. 2: Extraction effort per design source. Each point is one repository run. The positive relationship suggests inference-time scaling: more designs extracted require longer, costlier runs. R EFERENCES [1] “earendil-works/pi,” original-date: 2025-08-09T14:03:50Z. [Online]. Available: https://github.com/earendil-works/pi [2] S. Abi-Karam and C. Hao, “HLS-eval: A benchmark and framework for evaluating LLMs on high-level synthesis design tasks,” in 2025 IEEE International Conference on LLM-Aided Design (ICLAD). IEEE, pp. 219–226. [Online]. Available: https://ieeexplore.ieee.org/document/11106033/ [3] S. Abi-Karam, R. Sarkar, A. Seigler, S. Lowe, Z. Wei, H. Chen, N. Rao, L. John, A. Arora, and C. Hao, “HLSFactory: A framework empowering high-level synthesis datasets for machine learning and beyond,” in Proceedings of the 2024 ACM/IEEE International Symposium on Machine Learning for CAD. ACM, pp. 1–9. [Online]. Available: https://dl.acm.org/doi/10.1145/3670474.3685961

Record · ID 673604 · SHA-256 4a91ff723c1f02b0
Retrieved via Conceptio — every document is proof-bundled with source, license, and retrieval metadata.