{"id":27063,"library":"intel-pti","title":"Intel PTI","description":"Intel® Profiling Tools Interface (PTI) provides a Python API for processor trace (Intel PT) and hardware-based profiling. Version 0.17.0; release cadence irregular.","status":"active","version":"0.17.0","language":"python","source_language":"en","source_url":"https://github.com/intel/IntelPTI","tags":["intel","profiling","trace","debug","performance"],"install":[{"cmd":"pip install intel-pti","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Required for data structures and array operations.","package":"numpy","optional":false}],"imports":[{"note":"Direct import of module does not expose PTI class; must use from import.","wrong":"import intel_pti","symbol":"PTI","correct":"from intel_pti import PTI"},{"note":"TraceDecoder is in the decode submodule, not top-level.","wrong":"from intel_pti import TraceDecoder","symbol":"TraceDecoder","correct":"from intel_pti.decode import TraceDecoder"}],"quickstart":{"code":"from intel_pti import PTI\n\npti = PTI()\n# List available trace sources\nprint(pti.list_sources())\n# Decode a trace file (example)\nfrom intel_pti.decode import TraceDecoder\ndecoder = TraceDecoder()\ndecoder.decode('trace.pt')","lang":"python","description":"Initialize PTI, list sources, and decode a trace file."},"warnings":[{"fix":"Check CPU support via 'lscpu | grep intel_pt' or CPUID.","message":"Intel PTI requires Intel PT hardware support (e.g., recent Intel CPUs). Running on unsupported hardware will raise or silently fail.","severity":"gotcha","affected_versions":"all"},{"fix":"Update imports: 'from intel_pti.decode import TraceDecoder' instead of 'from intel_pti import TraceDecoder'.","message":"API changed significantly between 0.15.x and 0.17.x; many classes moved to submodules.","severity":"breaking","affected_versions":"0.15.x - 0.17.0"},{"fix":"Use 'with PTI() as pti:' pattern.","message":"Direct instantiation of PTI() without arguments may be deprecated in future; use context manager.","severity":"deprecated","affected_versions":">=0.17.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'pip install intel-pti' in the correct environment.","cause":"Library not installed or wrong Python environment.","error":"ModuleNotFoundError: No module named 'intel_pti'"},{"fix":"Use 'from intel_pti import PTI'.","cause":"Incorrect import (import intel_pti instead of from intel_pti import PTI).","error":"AttributeError: module 'intel_pti' has no attribute 'PTI'"},{"fix":"Provide full path or ensure file exists in working directory.","cause":"Trace file not found or path incorrect.","error":"OSError: [Errno 2] No such file or directory: 'trace.pt'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}