{"id":27242,"library":"poml","title":"POML - Prompt Orchestration Markup Language","description":"POML (Prompt Orchestration Markup Language) is a Python library for defining, composing, and managing prompts in a structured markup language. It allows you to define reusable prompt components, variables, and orchestration logic. As of version 0.0.8, the library is in early alpha with basic functionality for parsing and rendering POML templates. Release cadence is irregular.","status":"active","version":"0.0.8","language":"python","source_language":"en","source_url":"https://github.com/promptslab/poml","tags":["prompt management","llm","templating","markup"],"install":[{"cmd":"pip install poml","lang":"bash","label":"PyPI"}],"dependencies":[],"imports":[{"wrong":"from poml import POML","symbol":"Prompt","correct":"from poml import Prompt"},{"symbol":"Backend","correct":"from poml import Backend"},{"symbol":"OutputFormat","correct":"from poml import OutputFormat"}],"quickstart":{"code":"from poml import POML\n\npoml = POML()\ntemplate = '''\n[context]\nuser_name = \"{{user_name}}\"\n\n[instructions]\nGreet the user warmly.\n'''\nrendered = poml.render(template, {\"user_name\": \"Alice\"})\nprint(rendered)","lang":"python","description":"Instantiate a POML object, define a template, and render with variables."},"warnings":[{"fix":"Update code from `result['content']` to `result` directly.","message":"POML 0.0.8 changed the API: render() now returns a string instead of a dict. Previous 0.0.7 returned {'content': ...}.","severity":"breaking","affected_versions":"0.0.7 and earlier"},{"fix":"Replace `poml.parse(template)` with `poml.load(template)`.","message":"The `poml.parse()` function is deprecated and will be removed in 0.1.0. Use `poml.load()` instead.","severity":"deprecated","affected_versions":"0.0.8"},{"fix":"Configure your editor to replace tabs with spaces when editing .poml files.","message":"Templates must be indented consistently. Mixing tabs and spaces causes parsing errors. Use spaces only.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'0.0.8':41 'allow':27 'alpha':47 'basic':49 'cadenc':58 'compon':33 'compos':17 'defin':16,30 'earli':46 'function':50 'irregular':60 'languag':5,10,25 'librari':14,43 'llm':63 'logic':37 'manag':19,62 'markup':4,9,24,65 'orchestr':3,8,36 'pars':52 'poml':1,6,55 'prompt':2,7,20,32,61 'python':13 'releas':57 'render':54 'reusabl':31 'structur':23 'templat':56,64 'variabl':34 'version':40","created_at":"2026-05-01T17:45:14.823169+00:00","updated_at":"2026-05-01T17:45:14.823169+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/poml/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["llm-agents","ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}