{"id":27092,"library":"jupyterlite-core","title":"JupyterLite Core","description":"JupyterLite is a JupyterLab distribution that runs entirely in the browser, powered by WebAssembly. The jupyterlite-core package provides the CLI and build tools to create and deploy JupyterLite sites. Current version 0.7.4, requires Python >=3.10. Follows irregular release cadence with occasional alphas.","status":"active","version":"0.7.4","language":"python","source_language":"en","source_url":"https://github.com/jupyterlite/jupyterlite","tags":["jupyter","webassembly","browser","cli","lite"],"install":[{"cmd":"pip install jupyterlite-core","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"jupyterlite-core does not expose a Python module for import; use the CLI or call via subprocess.","wrong":"import jupyterlite","symbol":"jupyter lite CLI","correct":"Run as shell command: 'jupyter lite init' or 'jupyter lite build'"}],"quickstart":{"code":"import os\n# Initialize a JupyterLite site\nos.system('jupyter lite init --site-dir ./public')\n# Add extra piplite packages\nexit_code = os.system('jupyter lite add --source-url https://... @jupyterlab/theme-light-extension')\n# Build the site\nos.system('jupyter lite build --site-dir ./public')","lang":"python","description":"Initialize, add packages, and build a JupyterLite site programmatically (using os.system for clarity). For CLI usage, run directly from terminal."},"warnings":[{"fix":"Use jupyter lite add only for core-compatible extensions. Test in a staging environment.","message":"jupyter lite add currently has limited support; not all JupyterLab extensions can be added. Check extension compatibility before assuming it works.","severity":"gotcha","affected_versions":">=0.7.0,<0.8.0"},{"fix":"Run 'jupyter lite init --site-dir ./public' first, then all commands from that directory or with --site-dir.","message":"CLI commands must be run from a directory containing a jupyter-lite.json config file, or you must specify --site-dir. Otherwise the command may fail or produce unexpected results.","severity":"gotcha","affected_versions":">=0.7.0"},{"fix":"Use --site-dir instead of --output-dir.","message":"The 'jupyter lite build' command's --output-dir flag was renamed to --site-dir in v0.7.0. Using --output-dir still works but emits a deprecation warning.","severity":"deprecated","affected_versions":">=0.7.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install jupyterlite-core' and ensure the environment's bin/Scripts directory is in PATH.","cause":"JupyterLite CLI is not installed in the active Python environment.","error":"jupyter: command not found"},{"fix":"Upgrade jupyterlite-core: 'pip install --upgrade jupyterlite-core'. If using conda, ensure consistent channel.","cause":"Incompatible version of jupyterlite-core or a dependency; often caused by mixing versions from PyPI and npm.","error":"TypeError: __init__() got an unexpected keyword argument 'quiet'"},{"fix":"Use CLI through 'jupyter lite' commands or import specific submodules like 'from jupyterlite_core import ...' (note underscore).","cause":"Attempting to import from jupyterlite-core directly as 'import jupyterlite' does not work; the package does not expose a top-level module.","error":"ModuleNotFoundError: No module named 'jupyterlite'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}