{"id":24659,"library":"stream-manager","title":"AWS IoT Greengrass Stream Manager SDK","description":"The AWS IoT Greengrass Stream Manager SDK for Python allows you to manage and interact with the Greengrass Stream Manager feature, enabling efficient export of data streams to AWS cloud services. Current version 1.1.1, released infrequently.","status":"active","version":"1.1.1","language":"python","source_language":"en","source_url":"https://github.com/aws/aws-greengrass-stream-manager-python","tags":["aws","iot","greengrass","stream-manager","sdk"],"install":[{"cmd":"pip install stream-manager","lang":"bash","label":"Standard install"}],"dependencies":[],"imports":[{"note":"StreamManagerClient is in the client submodule, not top-level","wrong":"from stream_manager import StreamManagerClient","symbol":"StreamManagerClient","correct":"from stream_manager.client import StreamManagerClient"}],"quickstart":{"code":"from stream_manager.client import StreamManagerClient\nfrom stream_manager.sagemaker_edge_manager import SagemakerEdgeManager\n\n# Note: client requires valid Greengrass group configuration\nclient = StreamManagerClient()\nprint(\"Stream manager client created\")\n# Remember to close the client to release resources\nclient.close()","lang":"python","description":"Creates a Stream Manager client and immediately closes it. In production, manage the connection lifecycle carefully."},"warnings":[{"fix":"Update imports to `from stream_manager.client import StreamManagerClient`.","message":"Version 1.0.x: The import paths changed. `from stream_manager import StreamManagerClient` no longer works; use `from stream_manager.client import StreamManagerClient`.","severity":"breaking","affected_versions":"pre-1.0, 1.0.0+"},{"fix":"Always close the client after use, ideally via `client.close()` or a `try/finally` block.","message":"Resource leaks are common if the client is not closed explicitly. Use context managers (`with` statement) or ensure `client.close()` is called.","severity":"gotcha","affected_versions":"all"},{"fix":"Run code only on a Greengrass Core device or use mock/unit tests when developing off-device.","message":"The SDK requires AWS IoT Greengrass Core environment and will fail silently if not running on Greengrass Core. Expect import or connection errors outside Greengrass.","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":"Install stream-manager >=1.0 and use `from stream_manager.client import StreamManagerClient`.","cause":"Using wrong import path or outdated version (<1.0).","error":"ModuleNotFoundError: No module named 'stream_manager.client'"},{"fix":"Use `from stream_manager.client import StreamManagerClient`.","cause":"Trying to import from top-level package, but it's in a submodule.","error":"ImportError: cannot import name 'StreamManagerClient' from 'stream_manager'"},{"fix":"Check that code runs on a Greengrass Core device and that the client is properly initialized.","cause":"Client creation failed silently (e.g., not running on Greengrass Core) and returned None.","error":"AttributeError: 'NoneType' object has no attribute 'close'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}