silicate 0.1.7

Silicate — Python bindings for Silicon's renderer

Python bindings for Silicon's renderer.
Create beautiful images of your source code, powered by Rust.

Sponsor

---

Get Started

uv add silicate

import silicate

png_bytes = silicate.generate(
    "print('Hello, World!')",
    language="python",
    theme="Dracula",
)

---

What is Silicate?

Silicate is a Python binding for Silicon, the Rust tool that turns source code into beautifully rendered PNGs. Unlike wrapper approaches that shell out to a CLI, Silicate uses PyO3 to call Silicon's Rust library directly, giving you native performance with a clean Python API.

Features

• Native performance — no subprocess, no temp files; the renderer runs in-process via PyO3.
• 24+ built-in themes — Dracula, Nord, Monokai, GitHub, Solarized, and more.
• Full Silicon control — every renderer option exposed as a keyword argument.
• PNG bytes or file — generate() returns bytes, to_file() writes directly.

Usage

import silicate

# PNG bytes
png_bytes = silicate.generate(
    "print('Hello, World!')",
    language="python",
    theme="Dracula",
)

# Save directly to file
silicate.to_file(
    "fn main() { println!(\"Hello!\"); }",
    "output.png",
    language="rs",
    theme="Nord",
    window_title="main.rs",
)

# Explore available themes and languages
print(silicate.list_themes())
print(silicate.list_languages())

Theme gallery

Dracula	Nord
Monokai Extended	GitHub
Solarized Dark	Your code here

Options

All parameters after code (and output for to_file) are keyword-only:

Parameter	Default	Description
language	"python"	Syntax highlighting language
theme	"Dracula"	Color theme (use list_themes())
font	None	Font list as [("Name", size)], defaults to Hack 26pt
show_line_numbers	True	Display line numbers
show_window_controls	True	macOS-style window buttons
window_title	None	Title bar text
round_corner	True	Rounded image corners
background	"#abb8c3"	Background color (hex)
shadow_color	"#707070"	Shadow color (hex)
shadow_blur_radius	50.0	Shadow blur radius
pad_horiz	80	Horizontal padding (px)
pad_vert	100	Vertical padding (px)
shadow_offset_x	0	Shadow offset in X axis
shadow_offset_y	0	Shadow offset in Y axis
code_pad_right	25	Right padding inside code window (px)
highlight_lines	None	1-based line numbers to highlight
tab_width	4	Spaces per tab
line_offset	1	Starting line number
line_pad	2	Line spacing (px)

Development

# Clone with submodules
git clone --recurse-submodules https://github.com/alltuner/silicate.git
cd silicate

# Create venv and build
uv venv
VIRTUAL_ENV=.venv uvx maturin develop

# Test
uv run python -c "import silicate; print(silicate.list_themes())"

License

MIT

Support the project

Silicate is an open source project built by David Poblador i Garcia through All Tuner Labs.

If this project was useful to you, consider supporting its development.

---

Built by David Poblador i Garcia with the support of All Tuner Labs.
Made with ❤️ in Poblenou, Barcelona.