Installation & Setup
Production-ready configuration for high-throughput applications.
Quick Install
Python 3.8+
pip install tubox-client
Connection Pooling
The SDK maintains a thread-safe connection pool with automatic health checks and exponential backoff retry logic. Each connection uses a persistent TCP socket with 4-byte length-prefixed Crous binary protocol.
Default Pool Size
10 connections
Max Concurrent
100 operations
advanced_config.py
Production Config
from tubox_client import TuboxClient, ClientConfig
# Fine-tuned for high-throughput workloads
config = ClientConfig(
host="10.0.0.5",
port=7188,
min_pool_size=5, # Warm connections
max_pool_size=50, # Peak capacity
connect_timeout=5.0, # Fast-fail on network issues
request_timeout=30.0, # Long-running queries
retry_max_attempts=3 # Exponential backoff
)
client = TuboxClient(**config.to_dict())
Session-Based Auth
await client.authenticate(username, password)
Exchanges credentials for a 24-hour session token. All subsequent requests automatically include this token in the binary protocol header.
Last updated: Dec 14, 2025