Installation¶

Install Zap¶

Install from PyPI:

pip install zap-ai

Or with uv:

uv add zap-ai

Optional Dependencies¶

For Langfuse tracing support:

pip install zap-ai[langfuse]

Prerequisites¶

1. Temporal Server¶

Zap requires a running Temporal cluster. For local development:

# Using the Temporal CLI (requires Docker)
temporal server start-dev

This starts a local Temporal server at localhost:7233.

For production, consider Temporal Cloud or self-hosting.

2. LLM API Keys¶

Set environment variables for your LLM provider:

# OpenAI
export OPENAI_API_KEY="sk-..."

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

# Azure OpenAI
export AZURE_API_KEY="..."
export AZURE_API_BASE="https://your-resource.openai.azure.com/"

See LiteLLM Providers for the full list of supported providers.

Verify Installation¶

import zap_ai

print(zap_ai.__version__)

Next Steps¶

Continue to Quick Start to build your first agent.