{"about":{"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.","site":"https://codewithpapers.app","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","syntology":{"site":"https://syntology.ai","developers":"https://syntology.ai/developers","mcp":{"server":"https://syntology.ai/mcp","transport":"streamable-http","server_card":"https://syntology.ai/.well-known/mcp/server-card.json","auth":{"type":"trial token, no account","trial_token":"https://syntology.ai/api/oauth/trial/token","method":"POST","docs":"https://syntology.ai/developers"}},"have":"https://syntology.ai/api/graph/have?x=<method, arXiv id or title> (free, answers coverage only)","paper_base":"https://syntology.ai/paper/","atlas_base":"https://app.syntology.ai/?focus="},"machine_readable":[{"url":"https://codewithpapers.app/llms.txt","what":"the machine catalog: every machine-readable file, counted"},{"url":"https://codewithpapers.app/index/manifest.json","what":"paper-to-code index by arXiv id, with Syntology's counts"},{"url":"https://codewithpapers.app/search/manifest.json","what":"site search index (titles, authors) and its files"},{"url":"https://codewithpapers.app/download","what":"bulk files: Syntology's layer, described there"},{"url":"https://codewithpapers.app/build_manifest.json","what":"the build record: inputs, counts, exclusions, probes"}]},"url":"/paper/language-models-as-black-box-optimizers-for","title":"Language Models as Black-Box Optimizers for Vision-Language Models","arxiv_id":"2309.05950","date":"2023-09-12","proceeding":"CVPR 2024 1","authors":["Shihong Liu","Zhiqiu Lin","Samuel Yu","Ryan Lee","Tiffany Ling","Deepak Pathak","Deva Ramanan"],"abstract":"Vision-language models (VLMs) pre-trained on web-scale datasets have demonstrated remarkable capabilities on downstream tasks when fine-tuned with minimal data. However, many VLMs rely on proprietary data and are not open-source, which restricts the use of white-box approaches for fine-tuning. As such, we aim to develop a black-box approach to optimize VLMs through natural language prompts, thereby avoiding the need to access model parameters, feature embeddings, or even output logits. We propose employing chat-based LLMs to search for the best text prompt for VLMs. Specifically, we adopt an automatic hill-climbing procedure that converges to an effective prompt by evaluating the performance of current prompts and asking LLMs to refine them based on textual feedback, all within a conversational process without human-in-the-loop. In a challenging 1-shot image classification setup, our simple approach surpasses the white-box continuous prompting method (CoOp) by an average of 1.5% across 11 datasets including ImageNet. Our approach also outperforms both human-engineered and LLM-generated prompts. We highlight the advantage of conversational feedback that incorporates both positive and negative prompts, suggesting that LLMs can utilize the implicit gradient direction in textual feedback for a more efficient search. In addition, we find that the text prompts generated through our strategy are not only more interpretable but also transfer well across different VLM architectures in a black-box manner. Lastly, we apply our framework to optimize the state-of-the-art black-box VLM (DALL-E 3) for text-to-image generation, prompt inversion, and personalization.","url_abs":"https://arxiv.org/abs/2309.05950v5","url_pdf":"https://arxiv.org/pdf/2309.05950v5.pdf","source":{"archive":"pwc-archive (Hugging Face), CC BY-SA 4.0","snapshot":"2025-07-28","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","row_kind":"abstracts"},"code_links":[{"paper_slug":"language-models-as-black-box-optimizers-for","repo_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":0,"framework":"pytorch","reach":{"status":"ok"}}],"tasks":[{"task_slug":"few-shot-image-classification","task_name":"Few-Shot Image Classification"},{"task_slug":"image-classification","task_name":"Image Classification"},{"task_slug":"image-generation","task_name":"Image Generation"},{"task_slug":"text-to-image-generation-1","task_name":"Text to Image Generation"},{"task_slug":"text-to-image-generation","task_name":"Text-to-Image Generation"},{"task_slug":"image-classification","task_name":"image-classification"}],"methods":[{"method_slug":"clip","method_name":"CLIP"},{"method_slug":"coop","method_name":"CoOp"}],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":"https://syntology.ai/paper/2309.05950","atlas_url":"https://app.syntology.ai/?focus=2309.05950","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2309.05950"},"calls":[{"tool":"get_harvested_code_for_paper","arguments":{"arxiv_id":"2309.05950"},"returns":"the samples harvested from this paper, each with its run record; it does not verify the paper"},{"tool":"get_code","arguments_in":"samples[].code_sha256","returns":"one stored sample by its code_sha256; not shown on this site"}]},"developers":"https://syntology.ai/developers","held":true,"reason":"in_graph_layer","checked_against":null,"agent_calls":[{"tool":"get_harvested_code_for_paper","arguments":{"arxiv_id":"2309.05950"},"call":"get_harvested_code_for_paper(arxiv_id=\"2309.05950\")"},{"tool":"get_code","arguments_in":{"code_sha256":"syntology.samples[].code_sha256"},"call":"get_code(code_sha256=\"…\")"},{"tool":"get_citation_path","arguments":{"paper_1":"2309.05950"},"arguments_in":{"paper_2":"another paper's arXiv id or title"},"call":"get_citation_path(paper_1=\"2309.05950\", paper_2=\"…\")"},{"tool":"get_concepts_for_paper","arguments":{"arxiv_id":"2309.05950"},"call":"get_concepts_for_paper(arxiv_id=\"2309.05950\")"}],"by_repo":[{"repo":"shihongl1998/llm-as-a-blackbox-optimizer","kind":"official","samples":11,"ran":8,"instrument":2,"unverified":3}],"by_repo_is":"one row per repository in the archive's code links, Syntology's graph links or the samples; samples 0 means no sample is linked to this paper, a statement about Syntology's coverage, not about the repository: with harvested_for_other_papers present, Syntology harvested the repository for that many other papers, and without it, Syntology harvested nothing from it; placed_by_identical_code counts samples whose link records no repository, placed here because identical code was harvested from this repository for another paper; ran counts executions on a synthesized input and instrument counts failures of Syntology's instrument, not of the code","read_at":"2026-10-05T00:36:11+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","ran_record":{"url":"https://syntology.ai/api/ran/2309.05950.json","schema":"syntology.ran_record/1","counts_crosswalk":{"n_samples":"syntology.counts.lifted","n_ran":"syntology.counts.executed","n_ran_checked":"syntology.counts.checked","n_instrument":"syntology.counts.instrument_failures","n_unverified":"syntology.counts.no_recorded_run"},"note":"live record, measured at request time; may be newer than this page's graph read","badge":"https://syntology.ai/api/ran/2309.05950.svg"},"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":[{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer","reach":{"status":"ok"}}],"summary":{"ran_draft_wrong":2,"ran":6,"unverified":3},"n_samples":11,"n_ran":8,"n_constructed":0,"n_ran_checked":6,"n_instrument":2,"n_unverified":3,"n_instrument_is":"failures of Syntology's instrument, not of the code","every_run_is_an_instrument_failure":false,"key_notes":{"n_ran_checked":"legacy name, kept unchanged so existing readers do not break: it counts the samples that ran with no instrument failure (honoured, violated, and ran with no contract checked); it does not mean a contract was checked, and the pages print it as 'K with no instrument failure', not 'K checked'","n_constructed":"a sub-count of the samples that ran, never subtracted from them and never a failure: an executed sample whose run returned an instance of its own class (fixture_out_type equals the entry name): the run built an object and did not compute a result (Syntology's RAN record, counts.constructed)"},"by_repo_kind":{"official":{"samples":11,"ran":8,"n_ran_checked":6,"n_instrument":2,"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":11,"inline_ok_is":"inline_ok is true only when both licence gates allow Syntology to serve this code's text: this paper's link (inline_ok_link, from the licence of this paper's copy) and the stored copy of the same code that Syntology serves, which may have been first harvested from another repository. withheld_clause is Syntology's own wording of which gate keeps the text a pointer and why, and is null when inline_ok is true. This site shows no code text either way; n_pointer_only_for_licence counts samples with inline_ok false (both gates), n_pointer_only_link_allows those of them whose inline_ok_link is true","n_pointer_only_link_allows":0,"fixture_fields_is":{"signature_and_fixture_out_type":"the arguments Syntology's fixture called the sample with, each as name:type/rank/element kind (? where none was recorded), and the type of what the fixture's run returned, exactly as the harness recorded them; the arguments and the returned type were recorded by two separate runs of the same fixture. No output value is shown, and a returned type says nothing about whether the output was right","level_recorded_at":"when Syntology's graph wrote the sample's verification level, not when the code executed; absent where the level was written before the date was kept, and never filled in with the build date","present_on":"samples that ran only; a key is absent, never empty, where the graph records nothing"},"n_ran_with_level_date":8,"n_ran_without_level_date":0,"n_ran_signature_not_shown":0,"levels_written_between":{"first":"2026-09-22","last":"2026-09-25","is":"the first and last UTC dates on which Syntology's graph wrote a verification level for a sample on this page that ran, not when the code executed"},"code_page_min_papers":5,"code_page_is":"a page for the entry name across every paper's harvested code; the name is a string, not an identity","samples":[{"code_sha256":"f41cb1a19b154297","code_sha256_prefix":"f41cb1a19b154297","entry":"encode_image","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"auto_prompt_image_optimization.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/auto_prompt_image_optimization.py","link_basis":"harvester_set","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":"deterministic","behaviour_fingerprint":false,"signature":"image_path:str/0/str","fixture_out_type":"str","level_recorded_at":"2026-09-22T14:31:46.068493+00:00","code_page":"/code/encode-image","census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"f41cb1a19b154297"}},{"code_sha256":"60d87e4e28792d30","code_sha256_prefix":"60d87e4e28792d30","entry":"get_experiment_name","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"utils.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"args:Args/0/?","fixture_out_type":"dict","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"60d87e4e28792d30"}},{"code_sha256":"5bc725a3a530c2c4","code_sha256_prefix":"5bc725a3a530c2c4","entry":"get_message","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"prompt_pool.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/prompt_pool.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"prompt_method:str/0/str, good_templates_str:str/0/str, bad_templates_str:str/0/str, random_templates_str:str/0/str, num_templates_from_gpt:int/0/int, dataset:list/1/str","fixture_out_type":"str","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":"/code/get-message","census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"5bc725a3a530c2c4"}},{"code_sha256":"e07e33e12b2f42d7","code_sha256_prefix":"e07e33e12b2f42d7","entry":"get_split_transformer","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"engine/clip/partial_model.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/engine/clip/partial_model.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"clip_model:callable/0/?, layer_idx:int/0/int","fixture_out_type":"Encoder","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"e07e33e12b2f42d7"}},{"code_sha256":"219ed3eef816ba50","code_sha256_prefix":"219ed3eef816ba50","entry":"get_split_vit","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"engine/clip/partial_model.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/engine/clip/partial_model.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"model:callable/0/?, layer_idx:int/0/int","fixture_out_type":"Encoder","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"219ed3eef816ba50"}},{"code_sha256":"0aa8eb7ae30a6420","code_sha256_prefix":"0aa8eb7ae30a6420","entry":"get_text_encoder","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"engine/clip/partial_model.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/engine/clip/partial_model.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"text_layer_idx:int/0/int, clip_model:callable/0/?","fixture_out_type":"Encoder","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"0aa8eb7ae30a6420"}},{"code_sha256":"e62bfda6e308ebbc","code_sha256_prefix":"e62bfda6e308ebbc","entry":"load_templates_from_txt","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"load_laioncoco_templates.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/load_laioncoco_templates.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"path:str/0/str","fixture_out_type":"list","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"e62bfda6e308ebbc"}},{"code_sha256":"92f525cf6230e44e","code_sha256_prefix":"92f525cf6230e44e","entry":"read_classnames","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"engine/datasets/imagenet.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/engine/datasets/imagenet.py","link_basis":"harvester_set","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"text_file:str/0/str","fixture_out_type":"OrderedDict","level_recorded_at":"2026-09-25T23:22:42.264232+00:00","code_page":null,"census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"92f525cf6230e44e"}},{"code_sha256":"31025d8eb991afe7","code_sha256_prefix":"31025d8eb991afe7","entry":"ask_chatgpt_for_prompt","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"auto_prompt_prompt_inversion.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/auto_prompt_prompt_inversion.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":null,"census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"31025d8eb991afe7"}},{"code_sha256":"c47aa9e5b049a11d","code_sha256_prefix":"c47aa9e5b049a11d","entry":"build_model","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"engine/clip/model.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/engine/clip/model.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":"/code/build-model","census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"c47aa9e5b049a11d"}},{"code_sha256":"5ca56bc26635e339","code_sha256_prefix":"5ca56bc26635e339","entry":"get_init_templates","repo":"shihongl1998/llm-as-a-blackbox-optimizer","repo_kind":"official","path":"utils.py","file_url":"https://github.com/shihongl1998/llm-as-a-blackbox-optimizer/blob/HEAD/utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":null,"census":null,"licence":"NONE","inline_ok":false,"inline_ok_link":false,"withheld_clause":"GitHub detected no licence in this paper's repository, shihongl1998/llm-as-a-blackbox-optimizer when it was checked","mcp_get_code":{"code_sha256":"5ca56bc26635e339"}}]},"code_links_note":null,"arxiv_metadata":null,"syntology_extracted_results":null,"record_sha256":"1ccb208ba75e1d2f060daadcc732d06c7edd9bfdab339a1ffe2c1ccab349614b","record_changed_at":"2026-10-04","record_changed_at_basis":"changed"}