{"id":9856,"library":"jupyter-archive","title":"Jupyter Archive","description":"Jupyter Archive is a JupyterLab extension that enables users to create, download, and extract archive files (zip, tar, tar.gz, tar.bz2) directly within the JupyterLab user interface. It is currently at version 3.4.0 and is maintained as part of the JupyterLab Contrib ecosystem, typically seeing releases aligned with JupyterLab major versions or for significant bug fixes.","status":"active","version":"3.4.0","language":"en","source_language":"en","source_url":"https://github.com/jupyterlab-contrib/jupyter-archive","tags":["jupyter","jupyterlab","extension","archive","zip","tar","file-management"],"install":[{"cmd":"pip install jupyter-archive","lang":"bash","label":"Install for JupyterLab 3.x/4.x"}],"dependencies":[],"imports":[{"note":"jupyter-archive provides server-side handlers and frontend assets, not a typical Python library API for user scripting.","symbol":"jupyter_archive","correct":"This is a JupyterLab extension primarily interacted with via the UI. There are no common direct Python imports for user-facing functionality."}],"quickstart":{"code":"pip install jupyter-archive\njupyter lab","lang":"bash","description":"Install the extension, then launch JupyterLab. Once JupyterLab is running, navigate to the File Browser pane. Right-click on a file or folder to access context menu options for 'Create Archive...' or select an archive file to 'Extract Archive...'. You can also download archives directly from the context menu."},"warnings":[{"fix":"Refer to the `jupyter-archive` GitHub README for explicit JupyterLab version compatibility. If issues arise, try `pip install --upgrade jupyter-archive` and `jupyter lab build`.","message":"JupyterLab extensions can be sensitive to major version upgrades of JupyterLab itself. While `jupyter-archive` aims for compatibility, ensure your `jupyter-archive` version supports your `jupyterlab` version, especially when upgrading JupyterLab from 3.x to 4.x or newer.","severity":"breaking","affected_versions":"<3.0.0 (for JupyterLab <3.0.0), check release notes for specific compatibility."},{"fix":"Monitor resource usage for large operations. Consider performing very large archive operations directly on the server filesystem if possible. Be aware of your hosting environment's limits.","message":"Archiving or extracting very large files/directories can consume significant server resources (CPU, RAM) and take a long time, potentially leading to timeouts if JupyterLab is hosted with strict resource limits or slow I/O.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure the user running the JupyterLab server has appropriate read/write permissions for the source and target directories. Change the target directory to one with appropriate permissions, or adjust filesystem permissions.","message":"Permissions errors are common when attempting to create or extract archives in directories where the JupyterLab server process does not have write access.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"fix":"First, ensure `jupyter-archive` is installed: `pip install jupyter-archive`. Then, try rebuilding JupyterLab assets: `jupyter lab build`. If on an older JupyterLab version (<3.0), you might need `jupyter labextension install @jupyterlab-contrib/jupyter-archive` (though rarely needed for modern Lab).","cause":"The frontend extension assets might not be properly built or loaded, or there's a version mismatch with JupyterLab.","error":"JupyterLab could not load the @jupyterlab-contrib/jupyter-archive extension."},{"fix":"This library is a JupyterLab *extension* primarily for UI interaction, not direct programmatic Python imports for user code. Use its functionality through the JupyterLab file browser UI.","cause":"Attempting to `import jupyter_archive` in a Python script or notebook, assuming it's a standard library for direct use.","error":"ModuleNotFoundError: No module named 'jupyter_archive'"},{"fix":"Check the permissions of the target directory (`/path/to/protected/directory`). Either choose a different directory where the JupyterLab user has write access, or modify the directory permissions (e.g., `chmod 775 /path/to/protected/directory` or change ownership).","cause":"The JupyterLab server process lacks the necessary write permissions for the specified directory where the archive is being created or extracted.","error":"Error creating archive: [Errno 13] Permission denied: '/path/to/protected/directory'"}]}