{"id":20345513,"url":"https://github.com/napari/napari-plugin-manager","last_synced_at":"2026-01-24T06:48:24.984Z","repository":{"id":154620699,"uuid":"628180153","full_name":"napari/napari-plugin-manager","owner":"napari","description":"napari plugin manager to provide a graphical user interface for installing napari plugins.","archived":false,"fork":false,"pushed_at":"2025-04-11T05:51:49.000Z","size":2040,"stargazers_count":8,"open_issues_count":24,"forks_count":8,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-04-11T06:32:16.901Z","etag":null,"topics":["conda","napari","pip","plugins","python"],"latest_commit_sha":null,"homepage":"https://napari.org/napari-plugin-manager","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/napari.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-04-15T06:30:06.000Z","updated_at":"2025-04-11T05:51:53.000Z","dependencies_parsed_at":"2024-09-09T17:04:22.017Z","dependency_job_id":"15ef0a9f-da60-4794-bf13-12e73616243e","html_url":"https://github.com/napari/napari-plugin-manager","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/napari%2Fnapari-plugin-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/napari%2Fnapari-plugin-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/napari%2Fnapari-plugin-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/napari%2Fnapari-plugin-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/napari","download_url":"https://codeload.github.com/napari/napari-plugin-manager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248358603,"owners_count":21090405,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["conda","napari","pip","plugins","python"],"created_at":"2024-11-14T22:08:48.192Z","updated_at":"2026-01-24T06:48:24.964Z","avatar_url":"https://github.com/napari.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# napari-plugin-manager\n\n[![License](https://img.shields.io/pypi/l/napari-plugin-manager.svg?color=green)](https://github.com/napari/napari-plugin-manager/raw/main/LICENSE)\n[![PyPI](https://img.shields.io/pypi/v/napari-plugin-manager.svg?color=green)](https://pypi.org/project/napari-plugin-manager)\n[![Python Version](https://img.shields.io/pypi/pyversions/napari-plugin-manager.svg?color=green)](https://python.org)\n[![tests](https://github.com/napari/napari-plugin-manager/actions/workflows/test_and_deploy.yml/badge.svg)](https://github.com/napari/napari-plugin-manager/actions/workflows/test_and_deploy.yml)\n[![codecov](https://codecov.io/gh/napari/napari-plugin-manager/branch/main/graph/badge.svg)](https://codecov.io/gh/napari/napari-plugin-manager)\n\n[napari] plugin manager to provide a graphical user interface for installing\n[napari] plugins.\n\nYou can read the documentation at [napari.org/napari-plugin-manager](https://napari.org/napari-plugin-manager).\n\n## Overview\n\nThe `napari-plugin-manager` used to be part of the [napari] codebase before the 0.5.x release\nseries. It's now maintained as a separate project and package to allow uncoupled iterations outside\nof the `napari` release cycle.\n\nFuture work will allow other applications with a plugin ecosytem to customize and\nuse the `plugin-manager`. This package remains under active development and contributions\nare very welcome. Please [open an issue] to discuss potential improvements.\n\nThis package currently provides:\n\n- A package installer process queue that supports both [pip] and [conda] installs.\n- An easy to use GUI for searching, installing, uninstalling and updating plugins that make part of\n  the napari ecosystem. Each plugin entry provides a summary and information on the authors that\n  created the package. The REST API used to query for plugins and plugin information is provided by\n  the [npe2api service](https://api.napari.org).\n- The ability to install other packages via URL of by dragging and dropping artifacts from [PyPI].\n\n![Screenshot of the napari-plugin-manager interface, showcasing the plugin descriptions](https://raw.githubusercontent.com/napari/napari-plugin-manager/refs/heads/main/images/description.png)\n\n`napari-plugin-manager` knows how to detect if napari was installed using `conda` or `pip` and\nprovide the appropriate default installer tool on the `Installation Info` dropdown for each plugin.\n\n`conda` provides an efficient dependency solver that guarantees the stability and correctness of\nthe napari installation and work environment. This is the reason why `conda` is the default tool\nused for the [napari\nbundle](https://napari.org/stable/tutorials/fundamentals/installation_bundle_conda.html), a 1-click\ninstaller available for Mac, Linux and Windows. This installation method is best if you mainly want\nto use napari as a standalone GUI app. However, certain plugins may not be supported.\n\n## Installation\n\n### PyPI\n\n`napari-plugin-manager` is available through the Python Package Index and can be installed using [pip].\n\n```bash\npip install napari-plugin-manager\n```\n\n### Conda\n\n`napari-plugin-manager` is also available for install using [conda] through the [conda-forge channel](https://conda-forge.org/docs/#what-is-conda-forge).\n\n\n```bash\nconda install napari-plugin-manager -c conda-forge\n```\n\n## Using the napari plugin manager\n\n### Enabling/Disabling plugins\n\nInstalled plugins found on the current napari installation are displayed on the top list of the UI.\n\nUsers of napari can choose to enable/disable a specific plugin by checking/unchecking the checkbox\nto the left of each plugin item in the list.\n\n### Filtering\n\nYou can filter available plugins by name or description by typing on the search box\non the top left corner of the UI. Only plugins that match the filter criteria will be shown.\n\nIn the image below filtering by the word `arcos` yields a single plugin, the\n`arcos-gui` plugin. Notice that plugins that provide a display name, will show\nthe package name to the right in parenthesis.\n\n![Screenshot of the napari-plugin-manager interface showcasing the filtering features with the query 'arcos'](https://raw.githubusercontent.com/napari/napari-plugin-manager/main/images/filter.png)\n\n### Refreshing\n\nIf a new plugin has been released but it is not available on the list, you can click on the\n`Refresh` button located at the top right corner, to clear the cache and load all newly\navailable plugins.\n\n### Installing a plugin\n\nTo install a plugin:\n\n1. Select it by scrolling the available plugins list on the bottom, or by directly\nfiltering by name or description.\n2. Select the tool (`conda` or `pip`) and version on the `Installation Info` dropdown.\n3. Start the installation process by clicking on the `Install` button.\n\nYou can cancel the process at any time by clicking the `Cancel` button of each plugin.\n\n**Note**: Not all napari plugins are currently available on conda via the\n[conda-forge channel](https://anaconda.org/conda-forge/). Some plugins will require\na restart to be properly configured.\n\n![Screenshot of the napari-plugin-manager showing the process of installing a plugin](https://raw.githubusercontent.com/napari/napari-plugin-manager/main/images/install.png)\n\n### Installing a plugin via direct entry\n\nYou can also install a napari plugin or any other package via the direct entry option. The following steps\ncorrespond to the options and buttons located at the **bottom of the dialog**.\n\n1. You can type either the name of the package, a url to the resource or drag and drop a compressed file\n   of a previously downloaded package.\n2. Select the tool (`conda` or `pip`) by clicking on the arrow dorpdown of the `Install` button.\n3. Start the installation process by clicking on the `Install` button.\n\nYou can cancel the process at any time by clicking the `Cancel all` button.\n\n![Screenshot of the napari-plugin-manager showing the direct entry options](https://raw.githubusercontent.com/napari/napari-plugin-manager/main/images/direct-entry.png)\n\n### Uninstalling a plugin\n\nTo uninstall a plugin:\n\n1. Select it by scrolling the installed plugins list on the top, or by directly\nfiltering by name or description.\n2. Start the removal process by clicking on the `Uninstall` button.\n\nYou can cancel the process at any time by clicking the `Cancel` button of each plugin.\n\n**Note**: Some plugins will require a restart to be properly removed.\n\n![Screenshot of the napari-plugin-manager showing the process of uninstalling a plugin](https://raw.githubusercontent.com/napari/napari-plugin-manager/main/images/uninstall.png)\n\n### Updating a plugin\n\nWhen a new version of an installed plugin is available, an `Update (vX.Y.Z)`\nbutton will appear to the left of the `Installation Info` dropdown.\n\nTo update a plugin:\n\n1. Select it by scrolling the install plugins list on the top, or by directly\nfiltering by name or description.\n2. Start the update process by clicking on the `Update (vX.Y.Z)` button.\n\nYou can cancel the process at any time by clicking the `Cancel` button of each plugin.\n\n![Screenshot of the napari-plugin-manager showing the process of updating a plugin](https://raw.githubusercontent.com/napari/napari-plugin-manager/main/images/update.png)\n\n### Export/Import plugins\n\nYou can export the list of install plugins by clicking on the `Export` button located on the top right\ncorner of the UI. This will prompt a dialog to select the location and name of the text file where\nthe installed plugin list will be saved.\n\nThe file is plain text and plugins are listed in the [requirements.txt](https://pip.pypa.io/en/stable/reference/requirements-file-format/) format:\n```\nplugin_name==0.1.2\n```\n\nThis file can be shared and then imported by clicking on the `Import` button located on the top right\ncorner of the UI. This will prompt a dialog to select the location of the text file to import.\n\nAfter selecting the file, the plugin manager will attempt to install all the listed plugins using the auto-detected default installer.\n\n![Screenshot of the napari-plugin-manager showing the process of import/export](https://raw.githubusercontent.com/napari/napari-plugin-manager/main/images/import-export.png)\n\n### Batch actions\n\nYou don't need wait for one action to finish before you can start another one. You can add more\ntasks to the queue (install/uninstall/update) by clicking on the corresponding action buttons\nplugin by plugin. The actions will be carried out sequentially and in the order in which you\nstarted them.\n\nYou can cancel all the started installer actions at any time by clicking `Cancel all`\nbutton at the bottom of the UI.\n\n## Troubleshooting\n\nIn order to visualize more detailed information on the installer process output, you can\nclick on the `Show status` button located at the bottom left corner of the UI. To hide\nthis detailed information you can click on the `Hide status` button.\n\nSome issues that you might experience when using the installer include:\n\n* Incompatible packages due to conflicting dependencies.\n* Network connectivity errors.\n\n![Screenshot of the napari-plugin-manager interface showcasing the status information, which is initially hidden by default.](https://raw.githubusercontent.com/napari/napari-plugin-manager/main/images/status.png)\n\n## License\n\nDistributed under the terms of the [BSD-3] license, \"napari-plugin-manager\" is free and open source\nsoftware.\n\n## Issues\n\nIf you encounter any problems, please [file an issue] along with a detailed description.\n\n[napari]: https://github.com/napari/napari\n[@napari]: https://github.com/napari\n[BSD-3]: http://opensource.org/licenses/BSD-3-Clause\n[file an issue]: https://github.com/napari/napari-plugin-manager/issues\n[open an issue]: https://github.com/napari/napari-plugin-manager/issues\n[pip]: https://pypi.org/project/pip/\n[conda]: https://conda.org\n[PyPI]: https://pypi.org/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnapari%2Fnapari-plugin-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnapari%2Fnapari-plugin-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnapari%2Fnapari-plugin-manager/lists"}