furo
A clean customisable Sphinx documentation theme.
Decision gist · record as of 2026-08-14
Yes. Furo is production-stable, actively maintained, has no known vulnerabilities, and requires only low-friction dependencies. It's widely used (3.8M monthly downloads, top 5000 PyPI packages) by major projects including pip, urllib3, and Blender. Install it if you use Sphinx and want a cleaner, responsive theme with minimal setup.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Sphinx to be installed and a Sphinx documentation project already set up.
- Low friction: pure Python wheel with five runtime dependencies (beautifulsoup4, sphinx, sphinx-basic-ng, pygments, accessible-pygments).
- Actively maintained with recent release (238 days ago) and steady commit activity.
License · maintenance · safety
permissive license (permissive) — MIT license (permissive) — you can use, modify, and distribute Furo freely in both open-source and proprietary projects with minimal restrictions.
last release 2025-12-19 (238 days) · last repo commit 2026-08-10 · 3,560 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,049,326 downloads/mo, #2,773 on PyPI
Alternatives
Verify before relying
pip install furo
Then in your Sphinx conf.py:
html_theme = "furo"- Whether the theme's responsive design performs well on very large or very small screens beyond typical mobile/desktop ranges.
- Performance characteristics when used with very large documentation sets despite being 'biased for smaller docsets'.
What it is and what it does
Furo is a Sphinx theme that replaces the default HTML output styling with a cleaner, more modern design. It depends on Sphinx, beautifulsoup4, sphinx-basic-ng, pygments, and accessible-pygments to render documentation with responsive layouts, customizable color palettes and fonts, and carefully-designed sidebar navigation. The theme is intentionally minimal, prioritizing content over scaffolding, and includes built-in search styling.
You install it into your documentation build environment, set html_theme = "furo" in your Sphinx conf.py, and your HTML output automatically uses the new theme. It's designed to work well across devices and screen sizes, with particular attention to smaller documentation projects where showing the full hierarchy in the sidebar remains manageable.
Use it for
- Generate professional-looking HTML documentation for Python libraries or frameworks using Sphinx.
- Customize documentation appearance (colors, fonts, logo) without writing custom CSS or theme code.
- Create responsive documentation that displays correctly on mobile devices, tablets, and desktops.
- Build documentation for smaller to medium-sized projects where sidebar navigation of the full hierarchy is practical.
- Replace the default Sphinx theme with a modern, minimal design that emphasizes content readability.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
Furo is production-stable, actively maintained, has no known vulnerabilities, and requires only low-friction dependencies. It's widely used (3.8M monthly downloads, top 5000 PyPI packages) by major projects including pip, urllib3, and Blender. Install it if you use Sphinx and want a cleaner, responsive theme with minimal setup.
Install
furo on PyPI
Before you install
Low friction: pure Python wheel with five runtime dependencies (beautifulsoup4, sphinx, sphinx-basic-ng, pygments, accessible-pygments). Actively maintained with recent release (238 days ago) and steady commit activity.
Requires Sphinx to be installed and a Sphinx documentation project already set up.
License in practice
MIT license (permissive) — you can use, modify, and distribute Furo freely in both open-source and proprietary projects with minimal restrictions.
Quickstart
pip install furo
Then in your Sphinx conf.py:
html_theme = "furo"Verify before relying
- Whether the theme's responsive design performs well on very large or very small screens beyond typical mobile/desktop ranges.
- Performance characteristics when used with very large documentation sets despite being 'biased for smaller docsets'.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesbeautifulsoup4sphinxsphinx-basic-ngpygmentsaccessible-pygments |
| Maintenance | Actively maintained 238 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 3,049,326 / month, #2,773 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: Web EnvironmentFramework :: SphinxFramework :: Sphinx :: ThemeIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: DocumentationTopic :: Software Development :: Documentation |
Evidence: furo-2025.12.19-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 › “customizable sphinx html theme”
- furoFuro is a clean, responsive Sphinx theme for generating HTML…
- shibuyaShibuya is a Sphinx documentation theme that renders HTML…
- sphinx-bootstrap-themeA Sphinx theme that applies Bootstrap CSS and JavaScript to…
Give your agent the search over MCP, or paste the wish link into any chat.
More Documentation packages
Docutils converts plaintext documentation in reStructuredText format into multiple output formats including HTML, XML, and LaTeX using a modular processing system.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
Griffe extracts the complete structure and signatures of Python programs to generate API documentation or detect breaking changes in your project's public API.
Install it if you need to programmatically inspect Python code structure, generate API docs, or enforce API stability in CI.
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.
See also pydata-sphinx-theme · sphinx-bootstrap-theme · sphinx-rtd-theme · shibuya · sphinx-press-theme · sphinx-book-theme · Pallets-Sphinx-Themes · sphinx-immaterial