LeapNP: A Modular Python Framework for Benchmarking Learned Heuristics in Numeric Planning †

This paper introduces LeapNP (Learning and Planning Framework for Numeric Problems), a lightweight, Python-native framework engineered to support both classical and numeric planning tasks. Designed with a fully modular interface, it specifically aims to facilitate the seamless integration of deep learning methodologies. The design philosophy of LeapNP stems from the observation that traditional planners, while highly efficient, lack the necessary flexibility for experimental research, particularly at the intersection of learning and planning. Most state-of-the-art engines are built as highly optimized, rigid executables that are resistant to internal modification. LeapNP disrupts this paradigm by offering a framework where the entire planning stack is accessible and mutable. Users can seamlessly plug in custom implementations for grounding, define novel state representations, or design bespoke search strategies, thereby enabling a level of integration with learning models that is currently impractical with standard tools. By significantly lowering the engineering barrier, our planner fosters rapid experimentation and accelerates research in neuro-symbolic planning. We also present a comprehensive suite of search algorithms, designed to evaluate different properties of learned heuristics. These include two algorithms designed to exploit batching to maximize inference throughput, and a greedy algorithm meant to test the intrinsic robustness of the learned models, running them as general policies.