SmartTools

Installation

SmartTools requires Python 3.8+ and works on Linux, macOS, and Windows.

Install with pip

The simplest way to install SmartTools:

pip install smarttools

Or with pipx for isolated installation:

pipx install smarttools

Verify Installation

smarttools --version
smarttools --help

Configure a Provider

SmartTools needs at least one AI provider configured. The easiest is Claude CLI:

# Install Claude CLI (if you have an Anthropic API key)
pip install claude-cli

# Or use OpenAI
pip install openai

# Configure your provider
smarttools config

Wrapper Scripts Location

SmartTools installs wrapper scripts to ~/.local/bin/. Make sure this is in your PATH:

# Add to ~/.bashrc or ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

Development Installation

To contribute or modify SmartTools:

git clone https://gitea.brrd.tech/rob/SmartTools.git
cd SmartTools
pip install -e ".[dev]"