iq-sdk 0.1.0

SDK for creating and managing distributed workers and tools with socket.io connectivity

iq-sdk

A Python SDK for creating and managing distributed workers in IQ Flow orchestration platform.

Quickstart

# Create project directory
mkdir my_iq_tools_project
cd my_iq_tools_project

# Set up virtual environment
python -m venv .venv
source .venv/bin/activate

# Install iq-sdk
pip install iq-sdk

# Initialize project
iq init .

This creates a complete project with configuration, Docker setup, GitHub Actions, and more.

Next steps:

# Set your password in .env
echo "IQ_SITE_DEFAULT_PASSWORD=secret" >> .env

# Create a tool
iq tool create hello

# Create a worker
iq worker create main --tools hello

# Start the worker
iq worker start main

→ Full Quickstart Guide

Features

• Site-Based Configuration - Manage multiple sites with host/env/user/password
• CLI for Project Scaffolding - Complete setup with iq init
• Socket.IO Worker Connectivity - Workers connect to one or more sites
• Secure Secrets Handling - Passwords via ENV or K8s-style file references
• Configurable Threading - Set thread counts, enable autoscaling
• Docker Integration - Built-in support for baker-cli

Project Structure

After iq init, you get:

my-project/
├── config/
│   └── settings.yml      # Sites and tool configuration
├── .env                  # Secrets (passwords)
├── .gitignore
├── pyproject.toml
├── build-settings.yml    # Docker build config
├── tools/                # Your tool implementations
├── .devcontainer/        # VS Code DevContainer
├── .github/workflows/    # GitHub Actions
└── docker/               # Dockerfile & compose

CLI Reference

Site Management

iq site list              # List all sites
iq site list --check      # Check connectivity
iq site add prod --host http://prod:3000
iq site drop prod

Tool Management

iq tool create NAME       # Create a tool
iq tool list              # List tools

Worker Management

iq worker list            # Show configured tools/workers
iq worker list --check    # Check tool availability
iq worker start [OPTIONS]

Options:
  --threads, -t INT      Thread count
  --max-threads INT      Max threads (autoscaling)
  --autoscale            Enable autoscaling
  --tool TOOL            Tools to register (repeatable)
  --site, -s SITE        Sites to connect (repeatable)
  --config, -c FILE      Config file

Configuration

Sites (config/settings.yml)

site:
  id: "default"
  host: "http://localhost:3000"
  user: "worker"
  tools:
    - "my-tool"

sites:
  - id: "production"
    host: "http://prod:3000"
    user: "prod-worker"
    tools:
      - "my-tool"

Secrets (.env)

# Direct password
IQ_SITE_DEFAULT_PASSWORD=secret
IQ_SITE_PRODUCTION_PASSWORD=prod-secret

# Or file reference (K8s/Docker secrets)
IQ_SITE_PRODUCTION_PASSWORD_FILE=/run/secrets/prod-password

# For JSON/YAML secrets, extract with _PASSWORD_KEY
IQ_SITE_STAGING_PASSWORD_FILE=/etc/secrets/creds.json
IQ_SITE_STAGING_PASSWORD_KEY=database.password

Environment Override

export IQ_SITE_PRODUCTION_HOST='http://new-host:3000'
export IQ_WORKER__THREADS=8

Documentation

• Quickstart - Get started in 5 minutes
• Creating Tools - Build your own tools
• Worker Configuration - Threading and autoscaling
• Site Configuration - Multi-site setup
• Docker Deployment - Container deployment

Development

For contributing or local development:

git clone https://github.com/iq-company/iq-sdk.git
cd iq-sdk
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# Test your changes
iq init demo
cd demo

→ Development Guide

License

MIT License - see LICENSE for details.