{"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-2512-02494","title":"A Fully First-Order Layer for Differentiable Optimization","arxiv_id":"2512.02494","date":"2025-12-02","proceeding":"ICML","authors":["Zihao Zhao","Kai-Chia Mo","Shing-Hei Ho","Brandon Amos","Kai Wang"],"abstract":"Differentiable optimization layers enable learning systems to make decisions by solving embedded optimization problems. However, computing gradients via implicit differentiation requires solving a linear system with Hessian terms, which is both compute- and memory-intensive. To address this challenge, we propose a novel algorithm that computes the gradient using only first-order information. The key insight is to rewrite the differentiable optimization as a bilevel optimization problem and leverage recent advances in bilevel methods. Specifically, we introduce an active-set Lagrangian hypergradient oracle that avoids Hessian evaluations and provides finite-time, non-asymptotic approximation guarantees. We show that an approximate hypergradient can be computed using only first-order information in $\\tilde{O}(1)$ time, leading to an overall complexity of $\\tilde{O}(δ^{-1}ε^{-3})$ for constrained bilevel optimization, which matches the best known rate for non-smooth non-convex optimization. Furthermore, we release an open-source Python library that can be easily adapted from existing solvers. The source code is available at https://github.com/guaguakai/FFOLayer.","url_abs":"https://arxiv.org/abs/2512.02494","url_pdf":"https://arxiv.org/pdf/2512.02494","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":null,"atlas_url":"https://app.syntology.ai/?focus=2512.02494","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2512.02494"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-24T18:15:14+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/GT-KOALA/FFOLayer","reach":{"status":"ok","spdx":"MIT"}}],"summary":{"unverified":27},"by_repo_kind":{"found_in_text":{"samples":27,"ran":0,"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":0,"samples":[{"code_sha256_prefix":"5da01a2cfc6e4a3c","entry":"AltDiffLayer","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/AltDiff_my.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/AltDiff_my.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"5da01a2cfc6e4a3c"}},{"code_sha256_prefix":"721a2edf0c8c6c88","entry":"AltDiffLayer","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/AltDiff_socp.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/AltDiff_socp.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"721a2edf0c8c6c88"}},{"code_sha256_prefix":"f059057e92cf65ce","entry":"BPQPLayer","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/BPQP_cvxpy.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/BPQP_cvxpy.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"f059057e92cf65ce"}},{"code_sha256_prefix":"5ae4fc2c87a7123b","entry":"FFOLayer","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/ffocp_eq.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/ffocp_eq.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"5ae4fc2c87a7123b"}},{"code_sha256_prefix":"40c8b005ce29c676","entry":"active_counts_dict","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/ffocp_eq.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/ffocp_eq.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"40c8b005ce29c676"}},{"code_sha256_prefix":"0ed505c799b8ab88","entry":"alt_diff_qp_ball","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/AltDiff_socp.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/AltDiff_socp.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"0ed505c799b8ab88"}},{"code_sha256_prefix":"965a326c258ca206","entry":"alt_qp_solve_batched","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/AltDiff_my.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/AltDiff_my.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"965a326c258ca206"}},{"code_sha256_prefix":"51a84d27ffe9312e","entry":"bpqp_backward","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/BPQP.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/BPQP.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"51a84d27ffe9312e"}},{"code_sha256_prefix":"bc3853e5579d499e","entry":"bpqp_backward","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/BPQP_cvxpy.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/BPQP_cvxpy.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"bc3853e5579d499e"}},{"code_sha256_prefix":"9073396df5ed4d7f","entry":"compact_active_rows","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/ffoqp_eq.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/ffoqp_eq.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"9073396df5ed4d7f"}},{"code_sha256_prefix":"472594fac39e3ee0","entry":"ffoqp","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/ffoqp.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/ffoqp.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"472594fac39e3ee0"}},{"code_sha256_prefix":"a007b5cf56c8bae4","entry":"get_feasible_b","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"sudoku/models_sudoku.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/sudoku/models_sudoku.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"a007b5cf56c8bae4"}},{"code_sha256_prefix":"cb22acf193c96cee","entry":"get_feasible_h","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"sudoku/models_sudoku.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/sudoku/models_sudoku.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"cb22acf193c96cee"}},{"code_sha256_prefix":"2b5d032faf67c537","entry":"kkt_schur_complement","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/ffoqp_eq.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/ffoqp_eq.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"2b5d032faf67c537"}},{"code_sha256_prefix":"ad95d972f968bea3","entry":"make_schur_op","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/ffoqp_eq.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/ffoqp_eq.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"ad95d972f968bea3"}},{"code_sha256_prefix":"72e51987bf0b497f","entry":"osqp_solve","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/BPQP.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/BPQP.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"72e51987bf0b497f"}},{"code_sha256_prefix":"e79ddef8d0f4a1b9","entry":"pack_osqp","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/BPQP.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/BPQP.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"e79ddef8d0f4a1b9"}},{"code_sha256_prefix":"cdcb4c4d2efd9bcd","entry":"proj","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/AltDiff.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/AltDiff.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"cdcb4c4d2efd9bcd"}},{"code_sha256_prefix":"75a806c121e013d2","entry":"relu","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/AltDiff.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/AltDiff.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"75a806c121e013d2"}},{"code_sha256_prefix":"6e7c154f827b7fea","entry":"setup_cvxpy_synthetic_problem","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"synthetic_task/models.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/synthetic_task/models.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"6e7c154f827b7fea"}},{"code_sha256_prefix":"a2a1f2f1f52d1afe","entry":"setup_cvxpy_synthetic_problem_with_cones","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"synthetic_task/models.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/synthetic_task/models.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"a2a1f2f1f52d1afe"}},{"code_sha256_prefix":"b7c2cacc2ff70644","entry":"sgn","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"baselines/AltDiff.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/baselines/AltDiff.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"b7c2cacc2ff70644"}},{"code_sha256_prefix":"e9c8c0ade37ae3f5","entry":"slice_params_for_batch","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/utils.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"e9c8c0ade37ae3f5"}},{"code_sha256_prefix":"ffbf19d3814db061","entry":"solve_loss","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"ffo_sdp.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/ffo_sdp.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"ffbf19d3814db061"}},{"code_sha256_prefix":"61f11299147431ec","entry":"to_numpy","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/ffoqp.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/ffoqp.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"61f11299147431ec"}},{"code_sha256_prefix":"00d531ce728a6d76","entry":"to_numpy","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/utils.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"00d531ce728a6d76"}},{"code_sha256_prefix":"ed333bcc321221bc","entry":"to_torch","repo":"GT-KOALA/FFOLayer","repo_kind":"found_in_text","path":"src/ffolayer/utils.py","file_url":"https://github.com/GT-KOALA/FFOLayer/blob/HEAD/src/ffolayer/utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"ed333bcc321221bc"}}]},"arxiv_metadata":{"licence":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)","fields":["title","abstract","authors","date"],"primary_category":"cs.LG","source":"arxiv_api"},"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,795 of the 9,581 papers on this site that are newer than the archive; results from the others appear after they are checked.","papers_newer_than_archive":9581,"papers_checked":6795},"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}}}