yacs-client 0.1.0a1

Thin Python client for the licensed YACS desktop engine

YACS Python client

yacs-client is the small, dependency-free Python interface to the licensed YACS desktop engine. It provides secure local discovery, background-job helpers, and a command-line interface. It contains no circuit solver or other proprietary YACS implementation code.

Install

Install into the Python environment that will automate YACS:

python -m pip install yacs-client

YACS Desktop must be installed and have a valid license. Installing this package does not install or unlock the solver.

Python API

from yacs_client import Desktop

with Desktop.connect() as yacs:
    result = yacs.analyze(circuit, analysis)

Long-running operations can be managed explicitly:

with Desktop.connect() as yacs:
    job = yacs.analyze(circuit, analysis, wait=False)
    print(job.status())
    result = job.result()

For large results, job.download("result.json") streams to a temporary file, verifies the engine-provided SHA-256 digest, and only then atomically replaces the destination.

CLI

yacs status
yacs analyze request.json --output result.json
yacs run refine_roots request.json --output roots.json

The v1 API accepts normalized JSON request objects. Complete .yacs workspace parsing remains engine-owned so client releases do not duplicate private or rapidly evolving desktop normalization rules.

Security boundary

The client connects only to numeric loopback addresses discovered through a private per-session descriptor. It rejects redirects, bypasses system HTTP proxies, verifies the engine instance handshake, and receives a scoped token that cannot access desktop or licensing-control endpoints.

The descriptor is a short-lived capability available to processes running as the same operating-system user. Do not copy or publish it.

Compatibility

Client releases are versioned independently from YACS Desktop. This release supports YACS Desktop Automation API v1.

Development and managed-installation overrides:

• YACS_APP_PATH
• YACS_CONNECTION_FILE
• YACS_AUTOMATION_SESSION_DIR

License

The client is MIT licensed. YACS Desktop and its numerical engine are separate products governed by their own license terms.