{"id":26754,"library":"aws-glue-sessions","title":"AWS Glue Interactive Sessions Kernel","description":"Provides a Jupyter kernel for AWS Glue Interactive Sessions, enabling interactive development of PySpark, Ray, and SQL jobs from any Jupyter environment (including IDEs). Current version 1.0.9. Released occasionally, no fixed cadence.","status":"active","version":"1.0.9","language":"python","source_language":"en","source_url":"https://github.com/awslabs/aws-glue-sessions","tags":["aws","glue","jupyter","kernel","interactive-sessions","pyspark","ray"],"install":[{"cmd":"pip install 'aws-glue-sessions>=1.0.0' jupyter","lang":"bash","label":"Install with Jupyter"}],"dependencies":[{"reason":"Required to register the kernel; kernel spec is installed at package install time","package":"jupyter","optional":false},{"reason":"Peered dependency; needed for kernel communication","package":"jupyter_client","optional":false}],"imports":[],"quickstart":{"code":"pip install 'aws-glue-sessions>=1.0.0' jupyter\npython -m sp流水线 install --user --symlink\njupyter kernelspec list  # should list glue_pyspark, glue_spark, glue_ray\njupyter notebook  # launch Jupyter, select Glue PySpark kernel","lang":"bash","description":"Install the kernel and verify it appears in Jupyter. Then launch a notebook and select the Glue Interactive Sessions kernel."},"warnings":[{"fix":"Ensure you are installing in the same Python environment as Jupyter: run 'which jupyter' and 'pip list | grep aws-glue-sessions'. Reinstall if needed.","message":"The kernel spec is installed during pip install, not via jupyter kernelspec install. If you see 'No kernel named glue_pyspark', reinstall the package or check your Jupyter installation is on the same Python environment.","severity":"gotcha","affected_versions":"all"},{"fix":"Install with --user flag: pip install --user 'aws-glue-sessions>=1.0.0' or run as admin. On some systems, use 'python -m jupyter_client.kernelspec --user' manually.","message":"When using from an IDE (VS Code, PyCharm), the kernel spec must be registered globally. The package uses jupyter_client.install_kernel_spec() which may require write permissions to Jupyter's kernel directory.","severity":"gotcha","affected_versions":"all"},{"fix":"Do not import anything from the package; simply install and use the kernel from Jupyter.","message":"The old import path 'from aws_glue_sessions import ...' is no longer supported. The package does not expose Python modules; it only registers kernel specs.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN (if using temp creds) or configure ~/.aws/credentials before launching Jupyter.","message":"Interactive Sessions require AWS credentials to be configured (via environment variables, AWS CLI, or IAM role). The kernel will fail to start with 'No credentials provided' if not set.","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":"Reinstall the package in the correct Python environment: pip install --user 'aws-glue-sessions>=1.0.0' and verify with jupyter kernelspec list.","cause":"Kernel spec not installed; user tried to select a kernel that doesn't exist.","error":"KeyError: 'glue_pyspark'"},{"fix":"Set environment variables AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY (and optionally AWS_SESSION_TOKEN) or configure AWS CLI.","cause":"AWS credentials not configured. The kernel fails to start a Glue session.","error":"NoCredentialsError: Unable to locate credentials"},{"fix":"Do not import the package. Install it and launch Jupyter to select the kernel from the interface.","cause":"User mistakenly tries to import the package as a Python module instead of using it as a Jupyter kernel.","error":"ModuleNotFoundError: No module named 'aws_glue_sessions'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}