streamlm 0.1.11

A command-line interface for interacting with various Large Language Models with streaming markdown output

StreamLM

A command-line interface for interacting with various Large Language Models with beautiful markdown-formatted responses.

Installation

uv (recommended)

uv tool install streamlm

PyPI

pip install streamlm

Homebrew (macOS/Linux)

brew install jeffmylife/streamlm/streamlm

Usage

After installation, you can use the lm command:

lm explain quantum computing
lm -m gpt-4o "write a Python function"
lm -m claude-3-5-sonnet "analyze this data"

Raw Markdown Output

StreamLM includes beautiful built-in markdown formatting, but you can also output raw markdown for piping to other tools:

# Output raw markdown without Rich formatting
lm --md "explain machine learning" > output.md

# Pipe to your favorite markdown formatter (like glow)
lm --md "write a Python tutorial" | glow

# Use with other markdown tools
lm --raw "create documentation" | pandoc -f markdown -t html

Supported Models

StreamLM provides access to various Large Language Models including:

• OpenAI: GPT-4o, o1, o3-mini, GPT-4o-mini
• Anthropic: Claude-3-7-sonnet, Claude-3-5-sonnet, Claude-3-5-haiku
• Google: Gemini-2.5-flash, Gemini-2.5-pro, Gemini-2.0-flash-thinking
• DeepSeek: DeepSeek-R1, DeepSeek-V3
• xAI: Grok-4, Grok-3-beta, Grok-3-mini-beta
• Local models: Via Ollama (Llama3.3, Qwen2.5, DeepSeek-Coder, etc.)

Options

• --model / -m: Choose the LLM model
• --image / -i: Include image files for vision models
• --context / -c: Add context from a file
• --max-tokens / -t: Set maximum response length
• --temperature / -temp: Control response creativity (0.0-1.0)
• --think: Show reasoning process (for reasoning models)
• --debug / -d: Enable debug mode
• --raw / --md: Output raw markdown without Rich formatting

Features

• 🎨 Beautiful markdown-formatted responses
• 🖼️ Image input support for compatible models
• 📁 Context file support
• 🧠 Reasoning model support (DeepSeek, OpenAI o1, etc.)
• 🔧 Extensive model support across providers
• ⚡ Fast and lightweight
• 🛠️ Easy configuration

Links

• PyPI Package
• Homebrew Tap
• Issues

License

MIT License - see LICENSE file for details.

Development

Setup

# Clone the repository
git clone https://github.com/jeffmylife/streamlm.git
cd streamlm

# Install with dev dependencies
uv pip install -e ".[dev]"

Running Tests

All tests use uv run for consistency:

# Run all tests
uv run pytest tests/ -v

# Run with coverage
uv run pytest tests/ -v --cov=src --cov-report=term-missing

# Run specific test types
uv run pytest tests/test_cli.py -v                    # Unit tests only
uv run pytest tests/test_integration.py -v            # Integration tests only

Release Process

# Make your changes
uv version --bump patch
git add .
git commit -m "feat: your changes"
git push

# Create GitHub release (this triggers everything automatically)
gh release create v0.1.11 --generate-notes