diff --git a/src/aliby/bin/run.py b/src/aliby/bin/run.py
index e8495580d456783a35135a89641b15321c4fb02e..e918aa56a6824a9904ba477acf6c7c3724342c3d 100644
--- a/src/aliby/bin/run.py
+++ b/src/aliby/bin/run.py
@@ -1,11 +1,26 @@
 #!/usr/bin/env jupyter
+import argparse
+from aliby.pipeline import Pipeline, PipelineParameters
 
 
 def run():
-    import argparse
-
-    from aliby.pipeline import Pipeline, PipelineParameters
-
+    """
+    Run a default microscopy analysis pipeline.
+
+    Parse command-line arguments and set default parameter values for running a pipeline, then
+    construct and execute the pipeline with the parameters obtained. Command-line arguments can
+    override default parameter values. If a command-line argument is a string representation of
+    an integer, convert it to an integer.
+
+    Returns
+    -------
+    None
+
+    Examples
+    --------
+    FIXME: Add docs.
+    FIXME: GTP-generated. Confirm manually.
+    """
     parser = argparse.ArgumentParser(
         prog="aliby-run",
         description="Run a default microscopy analysis pipeline",