Install & Compatibility
Where this runs
tested against v0.2.0 · 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
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 17.8MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 1.5s · import 0.000s · 18MB
16MB installed
● package 16MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
run
✓ from pytailwindcss import run
✗ from pytailwindcss import run_tailwind_cli
install
✓ from pytailwindcss import install
PyTailwindCssBinaryNotFound
✓ from pytailwindcss import PyTailwindCssBinaryNotFound
This quickstart demonstrates how to use `run_tailwind_cli` to compile CSS. It creates a temporary directory with a `tailwind.config.js`, `input.css`, and a dummy HTML file, runs the build process, prints a snippet of the output, and then cleans up all temporary files. Ensure you have `tailwind.config.js` and `input.css` in your project for real use.
import os
from pathlib import Path
from pytailwindcss import run_tailwind_cli
import sys
# Define a temporary directory for the quickstart example
temp_dir = Path("pytailwindcss_quickstart_temp")
temp_dir.mkdir(exist_ok=True)
# Create dummy files for the quickstart to be runnable
config_path = temp_dir / "tailwind.config.js"
input_css_path = temp_dir / "input.css"
output_css_path = temp_dir / "output.css"
templates_dir = temp_dir / "templates"
templates_dir.mkdir(exist_ok=True)
html_path = templates_dir / "index.html"
# Write dummy config
config_path.write_text("""
module.exports = {
content: ['./templates/*.html'],
theme: {
extend: {},
},
plugins: [],
}
""")
# Write dummy input CSS
input_css_path.write_text("""
@tailwind base;
@tailwind components;
@tailwind utilities;
h1 { @apply text-blue-600; }
""")
# Write dummy HTML
html_path.write_text("""
<!DOCTYPE html>
<html>
<head>
<link href="output.css" rel="stylesheet">
</head>
<body>
<h1 class="text-xl font-bold">Hello Tailwind</h1>
</body>
</html>
""")
original_cwd = Path.cwd()
os.chdir(temp_dir) # Change CWD for the CLI to find files relative to temp_dir
print(f"Running Tailwind CSS build in {temp_dir}...")
try:
# Example arguments for a basic build
# Using relative paths because we changed CWD
result = run_tailwind_cli([
'-i', 'input.css',
'-o', 'output.css',
'--minify'
])
if result.returncode == 0:
print("Tailwind CSS build successful!")
if output_css_path.exists():
print("\nGenerated output.css (first 200 chars):\n")
print(output_css_path.read_text()[:200])
else:
print("output.css not found, but build reported success.")
else:
print(f"Tailwind CSS build failed with return code {result.returncode}.")
if result.stdout:
print(f"Stdout:\n{result.stdout.decode(sys.getdefaultencoding())}")
if result.stderr:
print(f"Stderr:\n{result.stderr.decode(sys.getdefaultencoding())}")
except Exception as e:
print(f"An unexpected error occurred: {e}")
finally:
os.chdir(original_cwd) # Restore original CWD
# Clean up dummy files
print(f"\nCleaning up temporary files in {temp_dir}...")
for f in temp_dir.iterdir():
if f.is_file():
f.unlink()
elif f.is_dir():
for sub_f in f.iterdir():
sub_f.unlink()
f.rmdir()
temp_dir.rmdir()
print("Cleanup complete.")
tailwindcss --version
Upgrade
Version history
0.3.1latest on PyPI · released Jun 12, 2026
Audit
Dependencies
No dependency data recorded yet.