Skip to content

Add Prefect-based async deployment for desk lifter control #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sgbaird merged 9 commits into from
Nov 19, 2025
Merged

Add Prefect-based async deployment for desk lifter control #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
1fd6025
Initial plan
Copilot Nov 18, 2025
bb157d4
Merge commit '30f0163' into copilot/sub-pr-3
Copilot Nov 18, 2025
b3254c6
feat: add complete package structure with CLI, Prefect flows, and com…
Copilot Nov 18, 2025
38aa6be
refactor: remove wrapper tasks, use direct decoration, emphasize Pref…
Copilot Nov 18, 2025
97dbffb
fix: correct imports, use desk-lifter-pool, remove --deploy CLI option
Copilot Nov 18, 2025
a6f2535
feat: add user-editable config.py, remove cron scheduling and get_dep…
Copilot Nov 18, 2025
5e079dc
refactor: address code review comments - remove hardcoding, simplify …
Copilot Nov 18, 2025
ec4fe04
refactor: simplify to single deployment, remove test flows, move test…
Copilot Nov 19, 2025
bcfdcba
feat: add SMOKE_TEST params and allow movements to wait for duty cycle
Copilot Nov 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 40 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,50 @@

# progressive-automations-python

> Python package for programmatically controlling progressive automations tools (e.g., LG-07 modular lifting column via FLTCON).
> Python package for programmatically controlling Progressive Automations desk lifters (e.g., LG-07 modular lifting column via FLTCON) with Prefect workflow orchestration.

A longer description of your project goes here...
Control your desk lifter remotely via Prefect Cloud deployments with asynchronous execution and position polling. Perfect for laboratory automation where the desk position needs to be coordinated with other equipment.

## Setup
## Quick Start

For Raspberry Pi 5 setup instructions, see [docs/raspberry-pi-setup.md](docs/raspberry-pi-setup.md).
```bash
# 1. Install
pip install progressive-automations-python

For bill of materials, see [docs/bill_of_materials.md](docs/bill_of_materials.md).
# 2. Configure Prefect Cloud
prefect cloud login -k <your-api-key>
prefect work-pool create desk-lifter-pool --type process

# 3. Deploy flows
python -c "from progressive_automations_python.deployment import create_deployments; create_deployments()"

# 4. Start worker on Raspberry Pi
prefect worker start --pool desk-lifter-pool
```

## Usage

Trigger movements asynchronously from any Python environment:

```python
from prefect.deployments import run_deployment

# Trigger movement (returns immediately)
flow_run = run_deployment(
name="simple-movement-flow/move-to-position",
parameters={"target_height": 35.5},
timeout=0 # Don't wait, return immediately
)

# Poll status later
# ... (see documentation for polling examples)
```

## Documentation

- [Installation and Usage Guide](docs/installation-and-usage.md) - Complete setup and API reference
- [Raspberry Pi Setup](docs/raspberry-pi-setup.md) - Hardware configuration
- [Bill of Materials](docs/bill_of_materials.md) - Required components


<!-- pyscaffold-notes -->
Expand Down
4 changes: 3 additions & 1 deletion docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,13 @@ Python package for programmatically controlling progressive automations tools (e
:maxdepth: 2

Overview <readme>
Installation and Usage <installation-and-usage>
Raspberry Pi Setup <raspberry-pi-setup>
Bill of Materials <bill_of_materials>
Contributions & Help <contributing>
License <license>
Authors <authors>
Changelog <changelog>
Bill of Materials <bill_of_materials>
Module Reference <api/modules>
```

Expand Down
Loading
Loading