streamtex 0.5.3

AI-powered content framework for Streamlit — create presentations, courses, and web-books with Claude or Cursor, no coding required.

StreamTeX

Think with AI. Present with StreamTeX.

StreamTeX is the first document library designed for generative AI. It uses mainly Python — one of the languages best understood by large language models — so an AI assistant can create, modify, and maintain your documents as naturally as a human developer. You keep full control at all times: every file is readable text, editable by hand or by AI, with no limits imposed by the software or provider.

Why StreamTeX?

Two paths, one tool

StreamTeX supports two complementary approaches that produce exactly the same result:

	Zero-code path	Code-first path
You describe	What you want in natural language	The document in Python
The AI	Generates the entire project	Assists, audits, and fixes
Ideal for	Teachers, consultants, managers	Developers, researchers, engineers
Requires	No programming experience	Basic Python knowledge

10 reasons to choose StreamTeX

1. Built for generative AI — The only document library that AI can create, modify, and maintain end-to-end. Describe what you want in plain language; keep full control over the result.
2. Zero HTML, zero CSS — All formatting through composable Style objects in Python. No web knowledge needed.
3. Pure Python, nothing else — One language for content, logic, and style. No proprietary syntax, no opaque binary format. Readable, diffable, reviewable.
4. Total composability — Styles combine with +, blocks nest freely, documents are structured like code: functions, modules, reuse.
5. Complete independence — No account, no subscription, no mandatory server. Your files are yours — Git-versioned, readable in any text editor.
6. Universal export — Self-contained HTML (single file), PDF, cloud deployment. Works everywhere, forever.
7. Built-in diagrams — Mermaid, PlantUML, TikZ, and LaTeX — no external tools to install.
8. Book navigation — Table of contents, pagination, markers, keyboard navigation. Documents that read like real books.
9. The Streamlit ecosystem — Access all Streamlit widgets while keeping professional typography and layout.
10. One-command deployment — Pre-configured Docker and Render. Local prototype to online document in minutes.

Who is StreamTeX for?

• Teachers & trainers — Interactive, navigable educational documents with professional layouts — no CSS required.
• Professionals & consultants — Self-contained exportable documents (HTML/PDF), independent of any vendor or subscription.
• Developers & engineers — Native Python, composable, Git-versioned, with syntax highlighting and integrated diagrams.
• Researchers & scientists — LaTeX-quality typesetting + web interactivity + built-in diagrams (Mermaid, PlantUML, TikZ).

Getting Started

Prerequisites

• Python 3.11+ — check with python3 --version
• git — check with git --version
• uv (recommended) — fast Python package manager

Install uv (if not already installed):

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# macOS with Homebrew
brew install uv

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or with pip (any platform)
pip install uv

Without uv? StreamTeX can also be installed with pip alone — see Manual Installation below.

StreamTeX supports 4 installation levels. Pick the one that fits your needs.

Quick Start (minimal, no workspace)

From zero to a running project in 3 commands:

uv tool install "streamtex[cli]" -U
stx project new my-project
cd my-project && uv sync && stx run

Standard Setup (recommended)

Full workspace with rich templates, documentation, and Claude AI profiles:

uv tool install "streamtex[cli]" -U
mkdir streamtex-dev && cd streamtex-dev
stx install
stx update
stx project new my-project --template project   # CLI templates: project, collection, slides
cd projects/my-project
stx claude install project .
stx run

Full Setup (all optional features)

Everything above, plus AI image generation, PDF export, and live inspector:

uv tool install "streamtex[cli]" -U
mkdir streamtex-dev && cd streamtex-dev
stx install --preset power --project my-project --template project
stx update
cd projects/my-project
stx run

The power preset automatically installs PDF export, AI image generation, and the live inspector into your project. To add Playwright for PDF export, run:

uv run playwright install chromium

Each uv add installs optional features into the current project's environment. Pick only what you need — or install individual AI providers:

uv add "streamtex[ai-openai]"    # OpenAI only
uv add "streamtex[ai-google]"    # Google Imagen only
uv add "streamtex[ai-fal]"       # fal.ai only

AI image generation requires API keys in your .env file: STX_OPENAI_API_KEY, STX_GOOGLE_AI_KEY, STX_FAL_KEY (only the providers you use). See the AI Guide for configuration details.

Zero-Code with Claude or Cursor

Install StreamTeX and a Claude AI profile, then let the AI build your project:

uv tool install "streamtex[cli]" -U
mkdir streamtex-dev && cd streamtex-dev
stx install && stx update
stx project new my-project
cd projects/my-project
stx claude install project .

Open in Claude Code or Cursor, then use slash commands:

/stx-project:project-init
> "Create a Docker course with 12 slides, dark theme,
>  table of contents and page navigation"

The AI agent designs the project structure, proposes it for your approval, and generates all files — blocks, styles, book.py — ready to run:

stx run

See the AI Guide for all commands, agents, and workflows.

Code-First with Python

import streamlit as st
import streamtex as sx
from streamtex.styles.core import Style

st.set_page_config(page_title="My Book", layout="wide")

style = Style("color: navy; font-size: 1.2em;", "my-style")
sx.st_write(style, "Hello StreamTeX!")

stx run app.py

Manual Installation (without stx CLI)

pip install streamtex
git clone https://github.com/nicolasguelfi/streamtex-claude.git
mkdir my-project && cd my-project
python ../streamtex-claude/install.py project .
stx run

Workspace Presets

The stx install command supports 5 presets:

Preset	Repos	Extras (with --project)	Use case
basic	none	pdf	Workspace only, upgrade later
user	streamtex-claude	pdf	+ Claude AI profiles
standard (default)	streamtex-docs + streamtex-claude	pdf, ai	+ rich templates + local docs
power	streamtex-docs + streamtex-claude	pdf, ai, inspector	+ all extras, requires --project
developer	all 3 repos	pdf, ai, inspector	+ library source + editable install

stx install --preset user       # Claude profiles only
stx install                     # standard (default)
stx install --preset developer  # full developer setup
stx install --preset power --project my-project  # all extras with a project

Upgrade an existing workspace to a higher preset:

stx install --preset developer
stx update

Optional Extras

StreamTeX uses optional dependency groups so you install only what you need:

uv add "streamtex[ai]"           # AI image generation (OpenAI + Google Imagen + fal.ai)
uv add "streamtex[ai-openai]"    # AI images — OpenAI only
uv add "streamtex[ai-google]"    # AI images — Google Imagen only
uv add "streamtex[ai-fal]"       # AI images — fal.ai only
uv add "streamtex[pdf]"          # PDF export via Playwright
uv add "streamtex[inspector]"    # Live code inspector sidebar
uv add "streamtex[cli]"          # stx CLI (already installed as a global tool above)

See the AI Image Generation section in the AI Guide for configuration and usage.

AI-Powered Features

StreamTeX ships with 22 slash commands, 4 specialized agents, and 10 block templates for AI-assisted development.

Project Creation & Customization

Command	What it does
/stx-project:project-init	Create a complete project from a natural-language description
/stx-project:project-customize	Change theme, typography, navigation without editing code
/stx-project:course-generate	Generate book.py structure from a CSV block list
/stx-project:collection-new	Create a multi-project hub

Design & Content

Command	What it does
/stx-designer:slide-new	Create slides from descriptions
/stx-designer:slide-audit	Validate design rules (font sizes, line lengths, spacing)
/stx-designer:slide-fix	Auto-fix design violations
/stx-designer:style-audit	Check styles for consistency

Migration

Command	What it does
/stx-migration:html-migrate	Convert HTML (Google Docs) to StreamTeX blocks
/stx-migration:html-convert-batch	Batch conversion of multiple files
/stx-migration:conversion-audit	Audit conversion quality

AI Agents

Agent	Role
Project Architect	Designs project structure from natural language
Slide Designer	Creates pedagogically structured, polished slides
Slide Reviewer	Reviews and validates completed slides
Presentation Designer	Specialist for live projection (large fonts, minimal text)

See the AI Guide for the complete reference.

Claude & Cursor Integration

StreamTeX provides installable AI profiles via streamtex-claude:

Profile	Audience	Commands	Agents
project	Content creators	19	3
presentation	Live presenters	+3	+1
documentation	Manual authors	10	2
library	Library developers	3	—

Install a profile:

stx claude install project ./my-project

Features

• Styled text — st_write with tuple support for inline mixed-style text
• CSS Grid layouts — st_grid with responsive columns
• Block containers — st_block / st_span context managers
• Lists — st_list with ul/ol, custom bullets, centered alignment
• Images — st_image with base64 encoding and MIME detection
• AI image generation — st_ai_image / st_ai_image_widget with OpenAI, Google Imagen, fal.ai
• Code blocks — st_code with Pygments syntax highlighting
• Diagrams — Mermaid, PlantUML, TikZ with pan/zoom
• LaTeX — math formulas and full documents
• Bibliography — BibTeX/RIS/CSL-JSON import, citations, formatted references
• Book orchestration — st_book with paginated and continuous modes
• Table of Contents — auto-numbering and anchor navigation
• Navigation markers — slide-like PageUp/PageDown navigation
• Collections — multi-project hubs with TOML configuration
• HTML export — self-contained dual-rendering pipeline
• Style composition — Style objects with + / - operators
• Zoom controls — CSS-based width and zoom adjustments
• Block inspector — live code editor in sidebar (optional)
• Block helpers — DI-injectable helpers with 3 usage modes

Documentation

Online manuals (read & explore)

• All manuals (hub)
• Introduction
• Advanced
• AI & Claude
• Deployment Guide
• Developer Guide

Examples (source code)

The manuals are also available as source code — clone and run them locally to study the examples:

git clone https://github.com/nicolasguelfi/streamtex-docs
cd streamtex-docs
uv sync
cd manuals/stx_manual_intro && stx run

See streamtex-docs for the full list of example projects.

Reference

• AI Guide — zero-code workflows with Claude/Cursor
• Cheatsheet (EN)
• Coding Standards

Project Structure

A StreamTeX project follows this layout:

my-project/
├── .claude/                     # AI profiles (commands, skills, agents)
├── .streamlit/
│   └── config.toml              # enableStaticServing = true
├── blocks/
│   ├── __init__.py              # Block registry
│   └── bck_intro.py             # Your blocks (build() function each)
├── static/
│   └── images/                  # Static assets
├── custom/
│   └── styles.py                # Project-specific styles
└── book.py                      # Entry point with st_book()

Installation

# With uv (recommended) — install or upgrade the CLI as a global tool
uv tool install "streamtex[cli]" -U

# With pip (alternative — no uv required)
pip install "streamtex[cli]"

# Or as a project dependency
uv add streamtex          # uv
pip install streamtex     # pip

Optional extras:

uv add "streamtex[cli]"          # stx CLI commands
uv add "streamtex[inspector]"    # Live code inspector sidebar
uv add "streamtex[ai]"           # AI image generation (OpenAI + Google Imagen + fal.ai)
uv add "streamtex[ai-openai]"    # AI images — OpenAI only
uv add "streamtex[ai-google]"    # AI images — Google Imagen only
uv add "streamtex[ai-fal]"       # AI images — fal.ai only
uv add "streamtex[pdf]"          # PDF export via Playwright

Replace uv add with pip install if you don't use uv.

Project Configuration

StreamTeX projects using from streamtex import * require this ruff config in pyproject.toml (automatically generated by stx project new):

[tool.ruff.lint]
ignore = ["F403", "F405", "E701", "E741"]

If your project uses [tool.uv.sources] for editable installs, set UV_NO_SOURCES=1 in CI environments so uv resolves from PyPI instead of local paths.

Keeping Up to Date

Update the CLI

The stx CLI is installed as a global tool with its own frozen copy of the library. You must upgrade it explicitly after each release:

uv tool install "streamtex[cli]" -U

Update your workspace

cd streamtex-dev/
stx update                   # pulls repos, syncs deps, updates profiles

Fine-grained control:

stx update --skip-sync      # skip uv sync
stx update --skip-profiles  # skip Claude profile update

Check workspace status

stx status                   # show preset, repos, profiles, project list

Upgrade a project

stx project upgrade          # upgrade project deps and extras to match current preset

Update a standalone project (no workspace)

cd my-project/
uv add streamtex --upgrade   # update the library dependency

Use /stx-guide update inside Claude Code for guided assistance.

Report Issues & Feedback

Found a bug? Have a suggestion? We'd love to hear from you.

• Bug report: Open a bug report — include the error message, steps to reproduce, and your environment
• Feature request: Request a feature — describe the problem and your proposed solution
• Questions & discussions: GitHub Discussions — ask questions, share ideas, show your projects

When reporting a bug, please include:

1. The full error traceback (copy-paste from the terminal)
2. The command you ran (e.g. stx project new, /stx-designer:init, stx run)
3. Your StreamTeX version (uv pip show streamtex | grep Version)

Contributing

See CONTRIBUTING.md for guidelines on code, content, and AI profile contributions.

Support the Project

If StreamTeX is useful to you, consider sponsoring the project to help maintain and improve it.

Acknowledgments

• Armando — A huge thank you to Armando, who worked alongside me to design and build the very first exploratory prototype that ultimately gave birth to StreamTeX. This project wouldn't be what it is today without that early collaboration.

License

BUSL-1.1 — Copyright (c) 2026 Nicolas Guelfi Converts to Apache 2.0 on 2030-11-29.