{"id":24273,"library":"promptlayer","title":"PromptLayer","description":"PromptLayer is a platform for prompt engineering and tracking LLM requests. It provides middleware to log, debug, and analyze prompts for OpenAI, Anthropic, and other providers. Current version 1.4.3, actively maintained with regular releases.","status":"active","version":"1.4.3","language":"python","source_language":"en","source_url":"https://github.com/MagnivOrg/prompt-layer","tags":["prompt-engineering","llm","openai","tracking","logging","middleware"],"install":[{"cmd":"pip install promptlayer","lang":"bash","label":"Install PromptLayer"}],"dependencies":[],"imports":[{"note":"The main module is imported directly; no submodule needed.","symbol":"promptlayer","correct":"import promptlayer"},{"note":"PromptLayerOpenAI is a class in the openai submodule, not top-level.","wrong":"from promptlayer import PromptLayerOpenAI","symbol":"PromptLayerOpenAI","correct":"from promptlayer.openai import PromptLayerOpenAI"}],"quickstart":{"code":"import promptlayer\n\n# Initialize PromptLayer with your API key\npromptlayer.api_key = os.environ.get('PROMPTLAYER_API_KEY', '')\n\n# Wrap OpenAI client for tracking\nfrom promptlayer.openai import PromptLayerOpenAI\nimport openai\n\n# Option 1: Use PromptLayerOpenAI client directly\nclient = PromptLayerOpenAI(api_key=os.environ.get('OPENAI_API_KEY', ''), pl_tags=['test'])\nresponse = client.chat.completions.create(\n    model='gpt-3.5-turbo',\n    messages=[{'role': 'user', 'content': 'Hello!'}]\n)\nprint(response.choices[0].message.content)\n\n# Option 2: Patch the default OpenAI module (deprecated in v1.0)\n# promptlayer.openai.patch()\n# response = openai.ChatCompletion.create(...)","lang":"python","description":"Initializes PromptLayer, sets API key, and uses the PromptLayerOpenAI client to track an OpenAI call."},"warnings":[{"fix":"Use `from promptlayer.openai import PromptLayerOpenAI` and instantiate it, or call `promptlayer.openai.patch()` after import.","message":"In version 1.0, the default import changed. Previously `import promptlayer` would patch modules automatically; now you must explicitly use the wrapper classes (e.g., PromptLayerOpenAI) or call `promptlayer.openai.patch()`.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use `PromptLayerOpenAI` wrapper class instead of patching.","message":"The method `promptlayer.openai.patch()` is deprecated. Direct class instantiation is preferred.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Set `promptlayer.api_key = 'your_api_key'` or export `PROMPTLAYER_API_KEY` environment variable.","message":"The `api_key` must be set for PromptLayer to log requests. If not set, requests will fail silently or raise an error depending on the version.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install promptlayer` in your current Python environment.","cause":"PromptLayer not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'promptlayer'"},{"fix":"Upgrade promptlayer: `pip install --upgrade promptlayer`","cause":"Outdated version of promptlayer that does not have the openai submodule (pre-1.0).","error":"AttributeError: module 'promptlayer' has no attribute 'openai'"},{"fix":"Set `promptlayer.api_key = 'your_key'` or export `PROMPTLAYER_API_KEY` environment variable.","cause":"PromptLayer API key missing.","error":"InvalidRequestError: API key not provided. Set your PromptLayer API key via promptlayer.api_key or environment variable."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}