Install supypowers and supyagent, configure your first LLM provider, and verify your setup.

Installation

Install uv

Supyagent uses uv for isolated dependency management. Each tool script runs with its own dependencies without polluting your global environment.

macOS / Linux

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

Windows

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

Verify the installation:

uv --version
# uv 0.6.x

Supypowers is the tool execution engine. Install it first:

uv pip install supypowers

Verify:

supypowers --help

uv pip install supyagent

For browser automation tools (headless Chrome):

uv pip install "supyagent[browser]"

For the API server (Vercel AI SDK compatible):

uv pip install "supyagent[serve]"

Supyagent uses LiteLLM for multi-provider LLM access. You need at least one API key.

supyagent config set

This opens an interactive menu where you select a provider and paste your key. Keys are encrypted with Fernet and stored in ~/.supyagent/config/.

supyagent config set ANTHROPIC_API_KEY
# Prompts for the value (hidden input)

supyagent config import .env

Provider	Key Name	Model Example
Anthropic	`ANTHROPIC_API_KEY`	`anthropic/claude-sonnet-4-5-20250929`
OpenAI	`OPENAI_API_KEY`	`openai/gpt-4o`
Google	`GEMINI_API_KEY`	`google/gemini-2.5-flash`
OpenRouter	`OPENROUTER_API_KEY`	`openrouter/anthropic/claude-3.5-sonnet`
Ollama	(none needed)	`ollama/llama3.2`

See the Models page for the full provider list.

Run the diagnostic tool:

supyagent doctor

You should see green checks for:

Your environment is ready. Head to the Quickstart to create your first agent.