intersphinx-registry
This package provides convenient utilities and data to write a sphinx config file.
Decision gist · record as of 2026-08-14
Yes. The package has zero runtime dependencies, permissive licensing, active maintenance, and solves a real friction point in Sphinx configuration. Install the base package if you maintain Sphinx documentation; add the [cli] extra if you want command-line lookup tools.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with no runtime dependencies.
- Active maintenance, last release 50 days ago.
License · maintenance · safety
permissive license (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal restrictions.
last release 2026-06-25 (50 days) · last repo commit 2026-08-10 · 20 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 82,391 downloads/mo, #14,166 on PyPI
Alternatives
Verify before relying
pip install intersphinx_registry
In conf.py:
from intersphinx_registry import get_intersphinx_mapping
intersphinx_mapping = get_intersphinx_mapping(
packages={"ipython", "matplotlib", "pandas", "python"}
)- Whether the registry covers all widely-used packages or only a subset of the ecosystem
- How frequently the registry is updated when package documentation URLs change
- Performance characteristics when querying large numbers of packages
What it is and what it does
Intersphinx Registry is a utility that maintains a curated mapping of intersphinx targets for a large portion of the Python ecosystem. Instead of manually tracking and updating documentation URLs for each dependency in your Sphinx configuration, you can call a single function to retrieve pre-configured mappings for packages you actually use.
The package serves two main purposes: it simplifies Sphinx configuration by providing sensible defaults for common packages, and it offers command-line tools to look up documentation targets, reverse-lookup URLs to find their Sphinx references, and scan reStructuredText files to suggest intersphinx references as replacements for hardcoded URLs. It requires no runtime dependencies and installs cleanly.
Use it for
- Automatically populate intersphinx_mapping in a Sphinx conf.py for projects that depend on popular packages like NumPy, SciPy, or Pandas
- Search across multiple package documentation inventories from the command line to find the correct intersphinx target for a symbol
- Convert hardcoded documentation URLs in existing .rst files into proper Sphinx cross-references
- Reverse-lookup a documentation URL to discover its corresponding Sphinx domain and target reference
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package has zero runtime dependencies, permissive licensing, active maintenance, and solves a real friction point in Sphinx configuration. Install the base package if you maintain Sphinx documentation; add the [cli] extra if you want command-line lookup tools.
Install
intersphinx-registry on PyPI
Before you install
Low install friction with no runtime dependencies. Active maintenance, last release 50 days ago.
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal restrictions.
Quickstart
pip install intersphinx_registry
In conf.py:
from intersphinx_registry import get_intersphinx_mapping
intersphinx_mapping = get_intersphinx_mapping(
packages={"ipython", "matplotlib", "pandas", "python"}
)Verify before relying
- Whether the registry covers all widely-used packages or only a subset of the ecosystem
- How frequently the registry is updated when package documentation URLs change
- Performance characteristics when querying large numbers of packages
Package facts
| License | permissive license permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 50 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 82,391 / month, #14,166 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT License |
Evidence: intersphinx_registry-0.2606.25-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “sphinx intersphinx mapping”
- intersphinx-registryProvides a pre-built intersphinx mapping registry for common Python…
- sphobjinvInspect, search, and manipulate Sphinx objects.inv inventory files…
- pydoctorpydoctor generates API documentation from Python source code through…
Give your agent the search over MCP, or paste the wish link into any chat.
More Sphinx packages
Parses Python docstrings in ReST, Google, Numpydoc, and Epydoc formats, extracting structured information like descriptions, parameters, return types, and exceptions.
Install it if you need to programmatically read and extract structured data from Python docstrings.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
A Sphinx extension that outputs documentation in serialized HTML formats (JSON and pickle) alongside standard HTML.
Alabaster is a clean, responsive Sphinx theme for documentation that requires Python 3.10 or newer and Sphinx 6.2 or newer.
A Sphinx extension that generates HTML help files from reStructuredText documentation source.
A Sphinx extension that converts documentation source files into QtHelp format, enabling integration with Qt-based help systems and documentation viewers.
However, be aware that maintenance is dormant—if you rely on it long-term, monitor Sphinx compatibility and consider whether QtHelp remains the right format for your…
See also sphobjinv · sphinx-issues · sphinx-hoverxref · sphinx-codeautolink · sphinx-notfound-page · recommonmark · sphinx-pyproject · sphinx-favicon · sphinx-reredirects