shibuya

library2026.5.19pypypiunverified

A clean, responsive, and customizable Sphinx documentation theme with light/dark mode. Current version 2026.1.9, requires Python >=3.10. Active development with frequent releases.

web-framework

pip install shibuya

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · SHIBUYA

shibuya

web-frameworkpythonv2026.5.19

Install

5.3s avg

Import

—

Disk

95MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2026.5.19 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 92.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 5.3s · import 0.000s · 93MB

95MB installed

● package 95MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

html_theme

✓ html_theme = 'shibuya' # in conf.py

Set html_theme in Sphinx conf.py, not an import statement. There is no Python module to import.

Configure Shibuya as your Sphinx documentation theme.

# In your Sphinx conf.py import os html_theme = 'shibuya' html_theme_options = { 'accent_color': 'blue', 'light_logo': 'logo-light.png', 'dark_logo': 'logo-dark.png', }

Debug

Known issues

gotchaThe theme is configured via `html_theme = 'shibuya'` in conf.py, not by importing a package. Users new to Sphinx often try `import shibuya` which does nothing.

fix

Set `html_theme = 'shibuya'` in your Sphinx conf.py file.

affects: all

breakingFrom version 2025.12.13, a 'Copy Page' button and 'Open in AI' dropdown are added by default. If you have custom CSS or JavaScript, these may overlap.

fix

To disable, add `'copy_button': False` and/or `'open_in_ai': False` to html_theme_options.

affects: >=2025.12.13

deprecatedThe 'source_url' option for edit button is deprecated. Use 'edit_page_url' or 'raw_source_url' instead.

fix

Replace `'source_url': ...` with `'edit_page_url': ...` in theme options.

affects: >=2025.12.17

gotchaWhen using `raw_source_url`, the path must be absolute URL. Relative paths cause errors in the copy page button.

fix

Ensure `raw_source_url` starts with `https://` or is a full URL.

affects: >=2025.12.19

Upgrade

Version history

2026.5.19latest on PyPI · released May 19, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

15 hits · last 30 days

node

Resources

githubhttps://github.com/lepture/shibuya ↗

packagehttps://pypi.org/project/shibuya/ ↗

homepagehttps://shibuya.lepture.com ↗

docshttps://shibuya.lepture.com/ ↗