Skip to main content
LDCon: an agent guiding a laser feedback loop

LDCon

Still in active development.

Laser locking, characterization and a Web dashboard. ECDL and DFB/DBR control are implemented, with digital-servo PI control and TOPTICA DLCpro adapters.

pip install "ldcon[web,instruments,analysis]"
ldcon-simulate --mode deterministic
ldcon-examples ./my-lab

Python 3.10+ on Linux. experiment-core installs automatically. Optional agent messaging: pip install "ldcon[agents]" (installs fanharvard-agentbridge). Provider CLIs and their authentication are separate.

Supported agent interfaces: Claude Code, Codex and OpenCode, with a DeepSeek Harness adapter for card tasks.

Agents monitor results, diagnose problems and run bounded characterization, parameter tuning and recovery through registered control cards. Humans choose the experiment, target, hardware configuration and physical safety limits, and authorize safety-relevant changes. The fast feedback loop runs on the controller; the agent is not the real-time servo.

Locking and quality: wavemeter feedback drives PI control of ECDL piezo or DFB/DBR current; slower temperature/current corrections and feedforward are available where configured. Quality is reported using frequency error/stability, mode hops, position-independent fringe secondary peaks/width and dither response. Missing data remains unknown; quality labels are distinct from physical safety.

Configuration Hardware
ECDL / digital servo Wavemeter and data feed, compatible digital servo/DAC, piezo driver, current/TEC controllers and supported AWGs (e.g. Siglent SDG)
DFB/DBR Wavemeter, current/TEC controller (e.g. Thorlabs CLD1015); compatible digital servo/DAC and modulation input for native current PI
ECDL / DLCpro TOPTICA DLCpro, wavemeter feedback; AWG/trigger connections for configured feedforward scans
Spectral quality / studies Fringe image source for secondary-peak analysis; scope/telemetry and AWG where required by the selected measurement

For digital-servo hardware and integration details, please contact kenjishu@fas.harvard.edu.

Tests use simulations, fake instruments and loopback services to cover control contracts, owner exclusivity, uncertain writes, cancellation/recovery, tuning, sweeps, configuration, quality reporting and Web behavior. They do not certify a new physical setup. See test suite.

Bundled examples include Sr422, Sr1092 and ThF685 laser definitions, decks and assignments, with output disabled and placeholder connections. Installation starts no hardware or service and includes no credentials. Publishing · MIT license

FanHarvard site configuration and deployment: ldcon-fanharvard.

Metadata

Release files for ldcon 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ldcon 0.2.2
File Size Uploaded Provenance Actions
ldcon-0.2.2.tar.gz 2.1 MB With provenance Details for ldcon-0.2.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ldcon 0.2.2
File Interpreter ABI Platform Actions
ldcon-0.2.2-py3-none-any.whl Python 3 none any Details for ldcon-0.2.2-py3-none-any.whl

Total release size: 3.9 MB

Release files / ldcon-0.2.2.tar.gz

Download URL ldcon-0.2.2.tar.gz
Size 2.1 MB
Tags Source
SHA-256 checksum
How to use checksums
3981e790e1230cb24ae9abde3b15a112694db85022d109d299d128f42b7c80ec
BLAKE2b-256 checksum
How to use checksums
859cc0f3b93e3f849993eccb9c830bce33052b7365a8cc79c8c5e435fe4a1cbb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

Release files / ldcon-0.2.2-py3-none-any.whl

Download URL ldcon-0.2.2-py3-none-any.whl
Size 1.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
a58c3628bad31313e43d7726c739782ebe3b42e558a8144d0b8d4f4b6dc274f6
BLAKE2b-256 checksum
How to use checksums
9600757af11de12c36f22347a7be5de9dc149d24edb3c0183346663d167f7b3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

Security for ldcon 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ldcon-0.2.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page