Heritage Themes for JupyterLab
Colour themes drawn from the colour traditions of different cultures. 65 dark and light themes in 32 families, in one extension; each family maps the named colours of one tradition to syntax roles.
Install
The extension needs JupyterLab 4.6 or later and Python 3.10 or later.
-
Install the extension into the environment that JupyterLab runs in:
pip install jupyterlab-heritage-themes
To install a particular build, download
heritage-themes-jupyterlab-<version>.zipfrom the GitHub releases and runpip installon the wheel in it, such asjupyterlab_heritage_themes-1.9.0-py3-none-any.whl. -
Restart JupyterLab and reload it in the browser.
-
Choose a theme, for example Holi Night, under Settings | Theme.
To remove the extension, run pip uninstall jupyterlab-heritage-themes.
What is coloured
Each theme colours the whole of JupyterLab: the menu bar, tabs, tool bars, side panels, file browser, status bar, dialogs, menus and fields; notebooks, with their cells, prompts, selections and outputs, including the ANSI colours of tracebacks and of text that programs print in colour; rendered Markdown; and the code of notebooks, consoles and text editors, in every language that JupyterLab highlights. Scroll bars follow the theme.
Themes
| Family | Themes | Tradition |
|---|---|---|
| Ainu | Ainu Kaparamip (Dark), Ainu Attus (Light) |
The appliqué robes of the Ainu of Hokkaido: bold appliqué keywords, red method declarations at the openings, green thread strings, yellow fields and blue-violet numbers, on indigo cotton or elm-bark cloth. |
| Aizome | Aizome Kachi (Dark), Aizome Kamenozoki (Light) |
Japanese indigo dyeing in a single hue: hierarchy by depth of dye, with sashiko-white declarations, green-leaning asagi strings and violet-leaning kon numbers. |
| Bengal | Bengal Baluchari (Dark), Bengal Laal Paar (Light) |
Bengal's looms and Durga Puja: aparajita keywords, Baluchari-magenta strings, paddy-green methods and terracotta types, on wine-dark Baluchari silk or a white laal paar sari with a red border. |
| Danqing | Danqing Ink (Dark), Danqing Paper (Light) |
Chinese painting pigments, led by the blue-green landscape: azurite keywords, malachite strings, cinnabar methods and gamboge types on inkstone or aged xuan paper, with Spock blocks marked like red seal stamps. |
| Edo | Edo Cha (Dark), Edo Nezumi (Light) |
The forty-eight browns and hundred greys of Edo-period dress: muted indigo keywords, brown literals, tinted-grey names, and a hidden red lining for the caret and labels. |
| Gujarat | Gujarat Navratri (Dark), Gujarat Rann (Light) |
Gujarat's Navratri, Rann of Kutch and patola silk: parrot-green keywords, patola-red types, turmeric methods and garba-pink strings, on a mirror-worked night or the white salt desert. |
| Hmong | Hmong Batik (Dark), Hmong Hemp (Light) |
The batik and cross-stitch of the Hmong pleated skirt: names in the tones of indigo batik, with pink keywords, lime strings and orange numbers from the cross-stitch, on indigo or undyed hemp. |
| Holi | Holi Night, Holi Day |
The Indian festival of colours at full strength: gulabi-pink keywords, saffron strings, green types and blue methods, thrown like gulal over the ash of the Holika bonfire or over white cotton. |
| Kalaallisuut | Kalaallisuut Qernertoq (Dark), Kalaallisuut Qaqortoq (Light) |
The West Greenlandic national dress and its colours for age and marital status: red keywords, confirmation pink strings, yellow kamik numbers, blue anorak types, green bead methods and black-and-white fields. |
| Kalamkari | Kalamkari Indigo (Dark), Kalamkari Cotton (Light) |
Indian hand-painted textiles and their natural dyes, kept muted: aubergine keywords, indigo types, madder methods and myrobalan strings on a vat of indigo or unbleached cotton, outlined in iron-black ink. |
| Kashubia | Kashubia Zemia (Dark), Kashubia Niebò (Light) |
The seven colours of Kashubian embroidery: cornflower keywords, navy types and light-blue methods under yellow strings, green fields and red numbers, on black earth or white linen. |
| Kerala | Kerala Backwaters (Dark), Kerala Kasavu (Light) |
Kerala's backwaters, Kathakali stage and kasavu loom: kathi-red keywords, zari-gold strings, pacha-green methods and backwater-teal types, on palm-dark water at night or off-white handloom with a gold border. |
| Łowicz | Łowicz Wycinanka (Dark), Łowicz Kodra (Light) |
The striped wool and layered paper cut-outs of Łowicz: orange keywords, green strings, emerald types and violet methods with yellow fields and cinnabar numbers, on a black template or a white paper strip. |
| Maramureș | Maramureș Zadie (Dark), Maramureș Cânepă (Light) |
The striped aprons and flowered skirts of Maramureș, coloured by age: married red keywords, pumpkin-flower strings, blue numbers, dark green types, rose methods and leather-brown fields. |
| Maya | Maya Corte (Dark), Maya Huipil (Light) |
The town dress of the Guatemalan Maya read through the K'iche' colour roads: green keywords, red strings, yellow types, purple methods and indigo fields, on the jaspe corte or the white huipil. |
| Morocco | Morocco Majorelle (Dark), Morocco Marrakech (Dark), Morocco Zellige (Dark) |
Three Moroccan walls on saturated backgrounds: Majorelle ultramarine with yellow pots, Marrakech red clay with turquoise doors, and zellige jade with saffron and cobalt tile. |
| Mudhif | Mudhif Qir (Dark), Mudhif Qasab (Light) |
The reed guest house of the Marsh Arabs of Iraq: hierarchy from the tone and weight of reed gold, with green reed shoots for strings and the willow fire for numbers. |
| Mughal | Mughal Night, Mughal Wasli (Light) |
Mughal miniature painting: lapis-lazuli keywords, vermilion types, gold-leaf methods and verdigris strings on a lamp-lit night or burnished wasli paper, with Spock labels lettered in gold. |
| Ndebele | Ndebele Nzima (Dark), Ndebele Mhlophe (Light) |
The painted walls of the Ndebele homestead: keywords drawn as the black outline, with sky-blue types, green methods, yellow strings and pink fields as the flat fills, on black paint or white lime-wash. |
| Peru | Peru Kulli (Dark), Peru Puka (Dark) |
Andean natural dyes on two dyed-through grounds: q'olle-yellow keywords, ch'illka-green strings and anqas-blue types on purple corn, and ch'illka-green keywords with turquoise methods on cochineal crimson. |
| Podhale | Podhale Kłobuk (Dark), Podhale Sukno (Light) |
The Highlander costume of Podhale: crimson keywords and navy strings from the cords of the parzenica, brass methods, green fields, blue types and coral numbers, on a black felt hat or white broadcloth. |
| Punjab | Punjab Phulkari (Dark), Punjab Basant (Light) |
Punjab's phulkari embroidery and Basant mustard fields: golden-silk keywords, orange-silk methods, turquoise strings and saag-green types, on madder-rust khaddar or a field of flowering mustard. |
| Rajasthan | Rajasthan Blue City (Dark), Rajasthan Pink City (Light) |
The colours of Rajasthan's cities and cloth: kesariya-saffron keywords, rani-pink strings, golden-sandstone types and blue-pottery methods, on the blue houses of Jodhpur by night or the pink sandstone of Jaipur by day. |
| Sardinia | Sardinia Orbace (Dark), Sardinia Camisa (Light) |
The traditional dress of Sardinia: saffron keywords and scarlet strings from the dyed silk and wool, indigo methods, walnut-brown fields and coral numbers, on black orbace or white linen. |
| Shaker | Shaker Prussian (Dark), Shaker Plaster (Light) |
The paint of the Shaker villages: bold meetinghouse keywords in plaster white or Prussian blue, Shaker red strings, pumpkin methods, yellow ochre fields, chrome green types and verdigris numbers. |
| Shuimo | Shuimo Night, Shuimo Day |
Chinese ink-wash painting: hierarchy by ink tone and weight rather than hue, with indigo and ochre washes and a red seal as the only accents. |
| Tamil | Tamil Kolam (Dark), Tamil Olai (Light) |
Tamil Nadu's kolam, palm-leaf manuscripts and Kanchipuram silk: peacock-neck keywords, mango strings, lac-red types and sapphire methods, on a dark granite threshold or a palm leaf. |
| Wixárika | Wixárika Haramara (Dark), Wixárika Wirikuta (Light) |
The yarn paintings and beadwork of the Wixárika (Huichol): the five colours of maize, with yellow keywords, blue strings, purple fields, red types and peyote-green methods, on the black of the western sea or the light of the eastern desert. |
| Wuxing | Wuxing Night, Wuxing Day |
Chinese colour symbolism and the Five Elements: vermilion keywords (Fire), jade strings (Wood), imperial-yellow types (Earth), and a rice-paper or indigo-ink canvas in place of stark white and black (Metal and Water). |
| Yolŋu | Yolŋu Galawu (Dark), Yolŋu Gapaṉ (Light) |
The ochres of Yolŋu bark painting from north-east Arnhem Land: red keywords, yellow strings, orange types, haematite fields and pink numbers, with white or charcoal methods, on stringybark or white clay. |
| Zalipie | Zalipie Sadza (Dark), Zalipie Wapno (Light) |
The painted cottages of Zalipie: lime, soot and clay for text, keywords and comments, and the flowers for names, with rose methods, leaf-green strings and violet types, on a soot plinth or a lime-washed wall. |
| Złotnica | Złotnica Aksamit (Dark), Złotnica Płótno (Light) |
The gold-and-silver embroidered bonnets of Kashubia: hierarchy by metal, tone and weight, with sapphire, burgundy and emerald velvet as the only colours, on green velvet or white linen. |
Each family's page describes its colour tradition. The same themes are available for JetBrains IDEs, VS Code, Visual Studio, Sublime Text, Zed, Neovim, Notepad++, Xcode, Helix, Kakoune, Micro, Vim, Emacs, Nano, Textadept, Lapce, Qt Creator, Amp, Eclipse, Nova, Pygments and terminals: see Heritage Themes on GitHub.
Report a problem or suggest a tradition on the issue tracker. Include the theme, JupyterLab version, language and a screenshot.
1 maintainer
Metadata
1 maintainer
Release files for jupyterlab-heritage-themes 1.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| jupyterlab_heritage_themes-1.9.0-py3-none-any.whl | Python 3 | none | any | Details for jupyterlab_heritage_themes-1.9.0-py3-none-any.whl |
Release files / jupyterlab_heritage_themes-1.9.0-py3-none-any.whl
| Download URL | jupyterlab_heritage_themes-1.9.0-py3-none-any.whl |
|---|---|
| Size | 244.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
532d8247d4d817d6b75dba7864dddccf1f3d854c63ff442a576f9bfcac3c5d18
|
|
BLAKE2b-256 checksum How to use checksums |
6dbc78246039557651b31c3ce3eb33b82db7098882bd66a33198255b01b36edc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logSecurity for jupyterlab-heritage-themes 1.9.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
1 file in this release has been uploaded with provenance metadata.
Attestation for jupyterlab_heritage_themes-1.9.0-py3-none-any.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
