​

Python SDK Installation

​

Requirements

• Python 3.8 or higher
• pip (Python package installer)
• A Claro API key (get one here)

​

Install via pip

pip install baytos-claro

​

Verify Installation

python -c "import baytos.claro; print(claro.__version__)"

​

Virtual Environment (Recommended)

# Create virtual environment with uv (fastest)
uv venv

# Activate it
source .venv/bin/activate  # On macOS/Linux
# or
.venv\Scripts\activate  # On Windows

# Install Claro
uv pip install baytos-claro

# Create virtual environment
python -m venv venv

# Activate it
source venv/bin/activate  # On macOS/Linux
# or
venv\Scripts\activate  # On Windows

# Install Claro
pip install baytos-claro

# Create conda environment
conda create -n myproject python=3.11

# Activate it
conda activate myproject

# Install Claro
pip install baytos-claro

# Add Claro to your project
poetry add claro

# Install dependencies
poetry install

​

Install from Source

pip install git+https://github.com/baytos-ai/claro-python.git

​

Upgrading

pip install --upgrade claro

pip show claro

​

Dependencies

• requests - HTTP client for API calls
• pydantic - Data validation and settings management
• typing-extensions - Type hints for older Python versions

​

Platform Support

• Operating Systems: Linux, macOS, Windows
• Python Versions: 3.8, 3.9, 3.10, 3.11, 3.12
• Architectures: x86_64, ARM64

​

Configuration

export BAYT_API_KEY="your_api_key_here"

BAYT_API_KEY=your_api_key_here

​

Troubleshooting

# macOS
brew install python3

# Ubuntu/Debian
sudo apt-get install python3-pip

# Windows: Download from python.org

pip install --user claro

# Check which Python you're using
which python
python --version

# Try using python3 explicitly
python3 -m pip install baytos-claro
python3 -c "import baytos.claro; print(claro.__version__)"

pip install --upgrade certifi

pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org claro

​

Next Steps