Catppuccin for Python
Install with pip or your preferred dependency management tool.
pip install catppuccin
For an API reference and usage examples, see our online documentation.
A minimal configuration:
c.TerminalInteractiveShell.true_color = True
c.TerminalInteractiveShell.highlighting_style = "catppuccin-mocha"Putting this into your IPython configuration
and ensuring catppuccin[pygments] is installed in the same environment will
give you Catppuccin Mocha syntax highlighting in the REPL. See here
for an example of a more complete configuration.
Available IPython themes:
catppuccin-lattecatppuccin-frappecatppuccin-macchiatocatppuccin-mocha
If you are looking to contribute, please read through our CONTRIBUTING.md first!
This project is maintained with uv. If you don't have uv yet, you can install it using the installation instructions.
Install the project's dependencies including extras:
uv sync --all-extras
catppuccin/palette.py is generated by a build script based on the contents of palette.json.
To update after downloading a new palette JSON file:
uv run build.py
Formatting this file is done manually as with any other file, see Code Standards below.
All of the tools listed in this section are automatically installed by uv as
part of the dev dependency group.
Tests are run with pytest.
To run tests and display coverage:
pytest --cov catppuccin
Type checking is performed by mypy.
To run type checks:
mypy .
Code linting and formatting is done by ruff.
To lint the code:
ruff check
To format the code:
ruff format
Copyright © 2022-present Catppuccin Org
