add cli command and readme

Author: gwbischof

README.md

@@ -1,3 +1,45 @@
 # Workflows
 
 Repository of workflows for the FXI beamline.
+
+## Running the Exporter Locally
+
+First, install dependencies:
+
+```bash
+pixi install
+```
+
+Then from the project directory:
+
+```bash
+pixi run exporter <uid> [output_dir]
+```
+
+For example:
+
+```bash
+pixi run exporter 02b93a93-43cf-45ad-8fda-792c1373dcec /tmp/exports
+```
+
+If `output_dir` is omitted, it defaults to `/tmp/exports`.
+
+### Running from anywhere
+
+Use the `-m` flag to specify the manifest path:
+
+```bash
+pixi run -m /path/to/fxi-workflows/pixi.toml exporter <uid>
+```
+
+Or add an alias to your shell config (`~/.zshrc` or `~/.bashrc`):
+
+```bash
+alias exporter='pixi run -m /path/to/fxi-workflows/pixi.toml exporter'
+```
+
+Then run from anywhere:
+
+```bash
+exporter <uid>
+```

end_of_run_workflow.py

@@ -117,13 +117,22 @@ def end_of_run_workflow_local(uid, output_dir="/tmp/exports"):
     logger.info(f"Export complete: uid={uid} scan_id={scan_id}")
 
 
-if __name__ == "__main__":
+def main():
+    import os
     import sys
 
+    # Clear Prefect Cloud env vars so the flow runs locally.
+    os.environ.pop("PREFECT_API_URL", None)
+    os.environ.pop("PREFECT_API_KEY", None)
+
     if len(sys.argv) < 2:
-        print("Usage: python end_of_run_workflow.py <uid> [output_dir]")
+        print("Usage: exporter <uid> [output_dir]")
         sys.exit(1)
 
     uid = sys.argv[1]
     output_dir = sys.argv[2] if len(sys.argv) > 2 else "/tmp/exports"
     end_of_run_workflow_local(uid, output_dir=output_dir)
+
+
+if __name__ == "__main__":
+    main()

pixi.toml

@@ -3,6 +3,9 @@ channels = ["conda-forge"]
 name = "prefect3 test"
 platforms = ["linux-64", "osx-64"]
 
+[tasks]
+exporter = "python end_of_run_workflow.py"
+
 [dependencies]
 prefect = "3.*"
 python = "<3.14"

pyproject.toml

@@ -1,3 +1,14 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fxi-workflows"
+version = "0.1.0"
+
+[project.scripts]
+exporter = "end_of_run_workflow:main"
+
 [tool.black]
 line-length = 88
 exclude = '''