CLI Installation

Quick Install

pip install socket0-sdk[cli]

Installation Methods

Using pip

pip install socket0-sdk[cli]

Using UV

uv pip install socket0-sdk[cli]

Development Installation

# Clone repository
git clone https://github.com/socket0/socket0-python-sdk.git
cd socket0-python-sdk

# Install with CLI (editable mode)
uv pip install -e ".[cli]"

Verify Installation

s0 --version
s0 --help

Dependencies

When you install socket0-sdk[cli], you get:

Package	Version	Purpose
typer[all]	>=0.12.0	CLI framework
rich	>=13.7.0	Terminal formatting
python-dotenv	>=1.0.0	Environment variable support

Plus all core SDK dependencies:

• httpx - Async HTTP client
• pycryptodomex - Cryptography
• pydantic - Data validation

Shell Completion

Bash

# Add to ~/.bashrc or ~/.bash_profile
eval "$(_S0_COMPLETE=bash_source s0)"

Zsh

# Add to ~/.zshrc
eval "$(_S0_COMPLETE=zsh_source s0)"

Fish

# Add to ~/.config/fish/completions/s0.fish
_S0_COMPLETE=fish_source s0 | source

Troubleshooting

Command Not Found

If s0 is not found after installation:

1. Verify installation: pip list | grep socket0-sdk
2. Check Python path: which python
3. Reinstall: pip install --force-reinstall socket0-sdk[cli]

Import Errors

If you get import errors when running CLI commands:

# Ensure CLI dependencies are installed
pip install socket0-sdk[cli]

# Or upgrade
pip install --upgrade socket0-sdk[cli]

Permission Denied

If you get permission errors:

# Use --user flag
pip install --user socket0-sdk[cli]

# Or use a virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install socket0-sdk[cli]

Next Steps

• CLI Overview - Learn about available commands
• SDK Tools - SDK development commands
• Vault Management - Vault operation commands