feat(tui): add interactive Terminal UI for mmore commands

.gitignore

@@ -114,6 +114,7 @@ venv.bak/
 # Milvus DB
 db/
 *.db
+*.db.lock
 
 # Project files
 tmp/

README.md

@@ -105,6 +105,22 @@ uv pip install "mmore[process,cpu]"
 
 > :warning: **Check the instructions for contributors directly at [`docs/for_devs.md`](./docs/for_devs.md)**
 
+### Interactive TUI
+
+Prefer a guided experience over editing YAML by hand? Install the `tui` extra and launch the interactive Terminal UI:
+
+```bash
+uv sync --extra tui
+mmore tui
+```
+
+From the launcher you can:
+
+- run any stage (process / postprocess / index / rag / chat) interactively,
+- chain the full pipeline (process → postprocess → index → chat),
+- generate stage YAML configs through a guided wizard,
+- pick from existing example configs without leaving the terminal.
+
 ### Minimal Example
 
 You can use our predefined CLI commands to execute parts of the pipeline. Note that you might need to prepend `python -m` to the command if the package does not properly create bash aliases.

docs/source/developer_documentation/for_devs.md

@@ -31,6 +31,7 @@ This guide will help you set up your development environment and contribute to t
     - [Writing tests](#writing-tests)
   - [🔀 Pull Request Process](#-pull-request-process)
     - [PR checklist](#pr-checklist)
+  - [🖥️ Interactive TUI](#️-interactive-tui)
   - [💡 Development tips](#-development-tips)
     - [Working with `uv`](#working-with-uv)
   - [❓ Questions](#-questions)
@@ -256,6 +257,25 @@ def test_something_on_gpu():
 - [ ] Examples are provided for new features
 - [ ] Commit messages are clear and descriptive
 
+## 🖥️ Interactive TUI
+
+MMORE ships with a Terminal UI that wraps the CLI commands behind guided menus and config wizards. Useful for trying the pipeline without writing YAML by hand.
+
+Launch it from a project working directory:
+
+```bash
+mmore tui
+```
+
+From the main menu you can:
+
+- **Run a single command** — pick any stage (`process`, `postprocess`, `index`, `retrieve`, `rag`, `ragcli`, `websearch`), then either select an existing YAML, generate one through a guided wizard, or type a path manually. Generated configs are written to `./tui-configs/` and validated against the stage's dataclass before running.
+- **Run full pipeline** — chains `process → postprocess → index` using existing configs.
+- **Build a full pipeline config (guided wizard)** — walks through the three stages in order, wiring the postprocess output JSONL into the index config automatically.
+- **Chat with indexed documents** — shortcut to `ragcli`.
+
+Stages whose extras are missing are disabled in the menu with an install hint (e.g. `uv sync --extra rag --extra cpu`). Press `Ctrl-C` inside any sub-flow to cancel back to the main menu; press it again at the main menu to quit.
+
 ## 💡 Development tips
 
 ### Working with `uv`

pyproject.toml

@@ -41,7 +41,7 @@ dependencies = [
     "python-dotenv>=1.0",
     "typing_extensions>=4.15.0,<5.0",
     "PyYAML>=6.0",
-    "setuptools<81"
+    "setuptools<81",
 ]
 
 [project.optional-dependencies]
@@ -128,8 +128,15 @@ api = [
 
 # --- Composite + variant extras ---
 
+tui = [
+    # Interactive terminal launcher (`mmore tui`)
+    "questionary>=2.0",
+    "rich>=13",
+    "uv",
+]
+
 all = [
-    "mmore[process,rag,api,websearch]",
+    "mmore[process,rag,api,websearch,tui]",
 ]
 
 cpu = [

src/mmore/cli.py

@@ -265,6 +265,19 @@ def ragcli(config_file: str):
     my_rag_cli.launch_cli()
 
 
+@main.command()
+def tui():
+    """Launch the interactive Terminal UI."""
+    try:
+        from .tui import run
+    except ModuleNotFoundError as e:
+        if e.name in ("questionary", "rich", "prompt_toolkit"):
+            click.echo("TUI dependency missing. Install with: uv sync --extra tui")
+            raise SystemExit(1)
+        raise
+    run()
+
+
 @main.group()
 def colpali():
     """ColPali pipeline commands for PDF processing, indexing, and retrieval."""

src/mmore/run_process.py

@@ -44,11 +44,19 @@ class ProcessInference:
     previous_results: Optional[str] = None
 
 
+def merged_results_path(output_path: str) -> str:
+    """Path where `process` writes its final merged JSONL.
+
+    Single source of truth for downstream tooling (TUI, scripts) that needs
+    to locate the JSONL produced by a `process` run from its config.
+    """
+    return os.path.join(output_path, "merged", "merged_results.jsonl")
+
+
 def _write_merged_results(output_path, reused_samples, dispatched=True):
     """Merge per-processor JSONL files and reused samples into a single output."""
-    merged_output_path = os.path.join(output_path, "merged")
-    output_file = os.path.join(merged_output_path, "merged_results.jsonl")
-    os.makedirs(merged_output_path, exist_ok=True)
+    output_file = merged_results_path(output_path)
+    os.makedirs(os.path.dirname(output_file), exist_ok=True)
 
     total_results = 0
     with open(output_file, "w") as f:

src/mmore/tui/__init__.py

@@ -0,0 +1,3 @@
+from mmore.tui.app import run
+
+__all__ = ["run"]