{"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/osprey-pixel-understanding-with-visual","title":"Osprey: Pixel Understanding with Visual Instruction Tuning","arxiv_id":"2312.10032","date":"2023-12-15","proceeding":"CVPR 2024 1","authors":["Yuqian Yuan","Wentong Li","Jian Liu","Dongqi Tang","Xinjie Luo","Chi Qin","Lei Zhang","Jianke Zhu"],"abstract":"Multimodal large language models (MLLMs) have recently achieved impressive general-purpose vision-language capabilities through visual instruction tuning. However, current MLLMs primarily focus on image-level or box-level understanding, falling short in achieving fine-grained vision-language alignment at pixel level. Besides, the lack of mask-based instruction data limits their advancements. In this paper, we propose Osprey, a mask-text instruction tuning approach, to extend MLLMs by incorporating fine-grained mask regions into language instruction, aiming at achieving pixel-wise visual understanding. To achieve this goal, we first meticulously curate a mask-based region-text dataset with 724K samples, and then design a vision-language model by injecting pixel-level representation into LLM. Specifically, Osprey adopts a convolutional CLIP backbone as the vision encoder and employs a mask-aware visual extractor to extract precise visual mask features from high resolution input. Experimental results demonstrate Osprey's superiority in various region understanding tasks, showcasing its new capability for pixel-level instruction tuning. In particular, Osprey can be integrated with Segment Anything Model (SAM) seamlessly to obtain multi-granularity semantics. The source code, dataset and demo can be found at https://github.com/CircleRadon/Osprey.","url_abs":"https://arxiv.org/abs/2312.10032v3","url_pdf":"https://arxiv.org/pdf/2312.10032v3.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":"osprey-pixel-understanding-with-visual","repo_url":"https://github.com/circleradon/osprey","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"Apache-2.0"}},{"paper_slug":"osprey-pixel-understanding-with-visual","repo_url":"https://github.com/syscv/sam-hq","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"Apache-2.0"}}],"tasks":[{"task_slug":"language-modelling","task_name":"Language Modelling"}],"methods":[{"method_slug":"clip","method_name":"CLIP"},{"method_slug":"focus","method_name":"Focus"}],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":"https://syntology.ai/paper/2312.10032","atlas_url":"https://app.syntology.ai/?focus=2312.10032","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2312.10032"},"calls":[{"tool":"get_harvested_code_for_paper","arguments":{"arxiv_id":"2312.10032"},"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":"2312.10032"},"call":"get_harvested_code_for_paper(arxiv_id=\"2312.10032\")"},{"tool":"get_code","arguments_in":{"code_sha256":"syntology.samples[].code_sha256"},"call":"get_code(code_sha256=\"…\")"},{"tool":"get_citation_path","arguments":{"paper_1":"2312.10032"},"arguments_in":{"paper_2":"another paper's arXiv id or title"},"call":"get_citation_path(paper_1=\"2312.10032\", paper_2=\"…\")"},{"tool":"get_concepts_for_paper","arguments":{"arxiv_id":"2312.10032"},"call":"get_concepts_for_paper(arxiv_id=\"2312.10032\")"}],"by_repo":[{"repo":"circleradon/osprey","kind":"official","samples":10,"ran":8,"instrument":3,"unverified":2},{"repo":"syscv/sam-hq","kind":"listed","samples":0,"ran":0,"instrument":0,"unverified":0,"harvested_for_other_papers":1,"harvested_for":["2306.01567"],"harvested_for_calls":[{"arxiv_id":"2306.01567","tool":"get_harvested_code_for_paper","arguments":{"arxiv_id":"2306.01567"},"call":"get_harvested_code_for_paper(arxiv_id=\"2306.01567\")"}]}],"by_repo_harvested_for_is":"harvested_for: the arXiv ids (as Syntology's graph holds them) of every paper whose samples Syntology's graph links to this repository, in arXiv-id order, complete; the page names the first 3 and says how many more. A link only: it does not say the papers are the same work, that one copied the other, or that the code implements this paper's method; harvested_for_calls gives the get_harvested_code_for_paper call for each arXiv-shaped id among them","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/2312.10032.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/2312.10032.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/syscv/sam-hq","reach":{"status":"ok","spdx":"Apache-2.0"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/circleradon/osprey","reach":{"status":"ok","spdx":"Apache-2.0"}}],"summary":{"ran_draft_wrong":3,"ran":2,"ran_honours":2,"ran_violates":2,"ran_fixture":1,"unverified":4},"n_samples":14,"n_ran":10,"n_constructed":0,"n_ran_checked":6,"n_instrument":4,"n_unverified":4,"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":10,"ran":8,"n_ran_checked":5,"n_instrument":3,"repositories":1},"unlocated":{"samples":4,"ran":2,"n_ran_checked":1,"n_instrument":1,"repositories":0,"is":"identical to code Syntology harvested from another paper's repository; this paper's own copy was not located, so no repository is named and no licence is recorded"}},"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":6,"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":2,"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":2,"n_ran_signature_not_shown":0,"levels_written_between":{"first":"2026-09-22","last":"2026-09-26","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":"f87bbcb499baf746","code_sha256_prefix":"f87bbcb499baf746","entry":"anns_to_gpt_format","repo":"circleradon/osprey","repo_kind":"official","path":"osprey/data_generation/generate_gpt_prompt.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/osprey/data_generation/generate_gpt_prompt.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,"signature":"anns:list/1/dict","fixture_out_type":"str","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"f87bbcb499baf746"}},{"code_sha256":"6c0e03018d4aaf50","code_sha256_prefix":"6c0e03018d4aaf50","entry":"box_tostr","repo":"circleradon/osprey","repo_kind":"official","path":"osprey/data_generation/generate_gpt_prompt.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/osprey/data_generation/generate_gpt_prompt.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"box:Tensor/1/float","fixture_out_type":"str","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"6c0e03018d4aaf50"}},{"code_sha256":"7c1f8f327d8bd531","code_sha256_prefix":"7c1f8f327d8bd531","entry":"change_box","repo":"circleradon/osprey","repo_kind":"official","path":"osprey/data_generation/generate_gpt_prompt.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/osprey/data_generation/generate_gpt_prompt.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"boxes:list/1/ndarray, width:int/0/int, height:int/0/int","fixture_out_type":"list","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"7c1f8f327d8bd531"}},{"code_sha256":"592b3c1a88f93d7c","code_sha256_prefix":"592b3c1a88f93d7c","entry":"expand2square","repo":"circleradon/osprey","repo_kind":"official","path":"osprey/mm_utils.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/osprey/mm_utils.py","link_basis":"harvester_set","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":"well_formed","behaviour_fingerprint":false,"signature":"pil_img:Image/0/?, background_color:tuple/1/int","fixture_out_type":"Image","level_recorded_at":"2026-09-22T14:31:46.068493+00:00","code_page":"/code/expand2square","census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"592b3c1a88f93d7c"}},{"code_sha256":"c3ee9d07c900dd55","code_sha256_prefix":"c3ee9d07c900dd55","entry":"load_image_from_base64","repo":"circleradon/osprey","repo_kind":"official","path":"osprey/mm_utils.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/osprey/mm_utils.py","link_basis":"harvester_set","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"image:str/0/str","fixture_out_type":"PngImageFile","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":"/code/load-image-from-base64","census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"c3ee9d07c900dd55"}},{"code_sha256":"763f6fe20bd52fbb","code_sha256_prefix":"763f6fe20bd52fbb","entry":"parse_score","repo":null,"repo_kind":null,"path":null,"file_url":null,"link_basis":"identical_code_first_harvested_elsewhere","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":"well_formed","behaviour_fingerprint":true,"signature":"review:str/0/str","fixture_out_type":"list","retrieve_with":{"tool":"get_code","code_sha256":"763f6fe20bd52fbb"},"code_page":"/code/parse-score","census":null,"licence":null,"inline_ok":false,"inline_ok_link":false,"withheld_clause":"this paper's copy of the code was not recorded (its link names no repository or source path), so no licence was read for it","mcp_get_code":{"code_sha256":"763f6fe20bd52fbb"}},{"code_sha256":"344dff4791fd1381","code_sha256_prefix":"344dff4791fd1381","entry":"process_images","repo":"circleradon/osprey","repo_kind":"official","path":"osprey/mm_utils.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/osprey/mm_utils.py","link_basis":"harvester_set","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"images:list/1/Image, image_processor:callable/0/?, model_cfg:MockModelConfig/0/?","fixture_out_type":"Tensor","level_recorded_at":"2026-09-26T03:58:20.443611+00:00","code_page":"/code/process-images","census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"344dff4791fd1381"}},{"code_sha256":"91176208680551c3","code_sha256_prefix":"91176208680551c3","entry":"show_mask","repo":"circleradon/osprey","repo_kind":"official","path":"demo/osprey_inference.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/demo/osprey_inference.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"mask:ndarray/2/float, image:ndarray/3/int, random_color:bool/0/bool, img_trans:float/0/float, mask_trans:float/0/float, return_color:bool/0/bool","fixture_out_type":"ndarray","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":"/code/show-mask","census":null,"licence":"Apache-2.0","inline_ok":false,"inline_ok_link":true,"withheld_clause":"this paper's link allows the body inline (Apache-2.0), but get_code serves the stored copy, first harvested from callsys/ControlCap, and GitHub detected no licence in that repository when it was checked","mcp_get_code":{"code_sha256":"91176208680551c3"}},{"code_sha256":"10893c4608c08075","code_sha256_prefix":"10893c4608c08075","entry":"split_to_even_chunks","repo":null,"repo_kind":null,"path":null,"file_url":null,"link_basis":"identical_code_first_harvested_elsewhere","language":"python","status":"ran_fixture","verification_level":1,"contract_check":"RAISES","metamorphic_tier":"well_formed","behaviour_fingerprint":false,"signature":"indices:list/1/int, lengths:dict/0/?, num_chunks:int/0/int","fixture_out_type":"list","code_page":"/code/split-to-even-chunks","census":null,"licence":null,"inline_ok":false,"inline_ok_link":false,"withheld_clause":"this paper's copy of the code was not recorded (its link names no repository or source path), so no licence was read for it","mcp_get_code":{"code_sha256":"10893c4608c08075"}},{"code_sha256":"f9939a84b9a65279","code_sha256_prefix":"f9939a84b9a65279","entry":"violates_moderation","repo":"circleradon/osprey","repo_kind":"official","path":"osprey/utils.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/osprey/utils.py","link_basis":"harvester_set","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"text:str/0/str","fixture_out_type":"bool","level_recorded_at":"2026-09-26T03:58:20.443611+00:00","code_page":"/code/violates-moderation","census":null,"licence":"Apache-2.0","inline_ok":false,"inline_ok_link":true,"withheld_clause":"this paper's link allows the body inline (Apache-2.0), but get_code serves the stored copy, first harvested from Mi3-Lab/doScenes-VLM-Planning, and AGPL-3.0, as GitHub detects it on that repository, is not in the permissive set Syntology serves inline","mcp_get_code":{"code_sha256":"f9939a84b9a65279"}},{"code_sha256":"898545959577e449","code_sha256_prefix":"898545959577e449","entry":"build_osprey_dataset","repo":"circleradon/osprey","repo_kind":"official","path":"osprey/datasets/data_modules.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/osprey/datasets/data_modules.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":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"898545959577e449"}},{"code_sha256":"bb35e3ac741bb2c9","code_sha256_prefix":"bb35e3ac741bb2c9","entry":"get_mm_adapter_state_maybe_zero_3","repo":null,"repo_kind":null,"path":null,"file_url":null,"link_basis":"identical_code_first_harvested_elsewhere","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":"/code/get-mm-adapter-state-maybe-zero-3","census":null,"licence":null,"inline_ok":false,"inline_ok_link":false,"withheld_clause":"this paper's copy of the code was not recorded (its link names no repository or source path), so no licence was read for it","mcp_get_code":{"code_sha256":"bb35e3ac741bb2c9"}},{"code_sha256":"735025744c1ab0cf","code_sha256_prefix":"735025744c1ab0cf","entry":"maybe_zero_3","repo":null,"repo_kind":null,"path":null,"file_url":null,"link_basis":"identical_code_first_harvested_elsewhere","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":"/code/maybe-zero-3","census":null,"licence":null,"inline_ok":false,"inline_ok_link":false,"withheld_clause":"this paper's copy of the code was not recorded (its link names no repository or source path), so no licence was read for it","mcp_get_code":{"code_sha256":"735025744c1ab0cf"}},{"code_sha256":"37899f22fb191b37","code_sha256_prefix":"37899f22fb191b37","entry":"pretty_print_semaphore","repo":"circleradon/osprey","repo_kind":"official","path":"osprey/utils.py","file_url":"https://github.com/circleradon/osprey/blob/HEAD/osprey/utils.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":"/code/pretty-print-semaphore","census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"37899f22fb191b37"}}]},"code_links_note":null,"arxiv_metadata":null,"syntology_extracted_results":null,"record_sha256":"c778588d617d935a8a79272387238a8b23b6f291f96a1f5d5ef8bb4bd461939e","record_changed_at":"2026-10-05","record_changed_at_basis":"changed"}