async-param-server 1.1.2

A distributed parameter server for managing configuration across processes

Parameter Server

Dead simple TCP-based parameter storage that actually works. No cap.

Quick Start

# Install dependencies
make install

# Run server
make server

Note, it uses example parameter yml file.

Python Usage

from param_server.client import AsyncParameterClient

async with AsyncParameterClient() as client:
    await client.set("/camera/exposure", 100)
    value = await client.get("/camera/exposure")
    print(f"Exposure: {value}")

Production Setup

Parameters.yml

Add your production parameters to file config/params.yml.

Docker Compose (recommended)

# Build container
make docker-build

# Start container
make docker-run

# Stop container
make stop

# Server runs on 0.0.0.0:8888

Configuration (when running without make)

Drop a YAML file with your defaults:

camera:
  exposure: 100
  gain: 1.5
  fps: 30

network:
  timeout: 5000
  retries: 3

Load it: --config your-config.yml

CLI Commands

# Basic operations
param-cli set /path/to/param value
param-cli get /path/to/param
param-cli delete /path/to/param
param-cli list --prefix /camera

# Live monitoring
param-cli watch /camera/exposure

# Health check
param-cli ping

Client Libraries

Async

from param_server.client import AsyncParameterClient

client = AsyncParameterClient("localhost", 8888)
await client.connect()
await client.set("/test", 123)
value = await client.get("/test")
await client.disconnect()

Features

• Persistent connections (low latency)
• Auto-reconnection (handles network issues)
• Type support: str, int, float, bool
• Concurrent operations
• Tree-like parameter paths
• JSON/tree CLI output formats
• Docker ready

Port Configuration

Default port is 8888. Change it:

# Server
param-server --port 9999

# Client
param-cli --port 9999 ping

# Python
AsyncParameterClient("localhost", 9999)

# or 
ParameterClient("localhost", 9999)

Troubleshooting

Connection refused

# Check if server is running
param-cli ping

# Check port
netstat -tlnp | grep 8888

Permission denied

# Use different port
param-server --port 9999

Docker issues

# Check logs
docker compose logs param-server

# Rebuild
docker compose build --no-cache

That's it. Simple as.

@themladypan