m4-infra 0.0.0.dev0__tar.gz

m4_infra-0.0.0.dev0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hannes Ill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

m4_infra-0.0.0.dev0/PKG-INFO

@@ -0,0 +1,324 @@
+Metadata-Version: 2.4
+Name: m4-infra
+Version: 0.0.0.dev0
+Summary: Infrastructure for AI-assisted clinical research with EHR datasets
+Keywords: mimic-iv,clinical-data,mcp,llm,medical,healthcare,duckdb,bigquery
+Author-Email: Rafi Al Attrach <rafiaa@mit.edu>, Pedro Moreira <pedrojfm@mit.edu>, Rajna Fani <rajnaf@mit.edu>
+Maintainer-Email: Rafi Al Attrach <rafiaa@mit.edu>, Pedro Moreira <pedrojfm@mit.edu>, Rajna Fani <rajnaf@mit.edu>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Healthcare Industry
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Classifier: Topic :: Database :: Database Engines/Servers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Project-URL: Homepage, https://github.com/rafiattrach/m4
+Project-URL: Repository, https://github.com/rafiattrach/m4
+Project-URL: Documentation, https://github.com/rafiattrach/m4#readme
+Project-URL: Issues, https://github.com/rafiattrach/m4/issues
+Project-URL: Changelog, https://github.com/rafiattrach/m4/releases
+Requires-Python: >=3.10
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: requests>=2.30.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: polars[pyarrow]>=0.20.10
+Requires-Dist: appdirs>=1.4.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: fastmcp>=0.1.0
+Requires-Dist: google-cloud-bigquery>=3.0.0
+Requires-Dist: db-dtypes>=1.0.0
+Requires-Dist: sqlparse>=0.4.0
+Requires-Dist: pyjwt[crypto]>=2.8.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: duckdb>=1.4.1
+Requires-Dist: matplotlib>=3.10.8
+Requires-Dist: lifelines>=0.30.0
+Description-Content-Type: text/markdown
+
+# M4: A Toolbox for LLMs on Clinical Data
+
+<p align="center">
+  <img src="webapp/public/m4_logo_transparent.png" alt="M4 Logo" width="180"/>
+</p>
+
+<p align="center">
+  <strong>Query clinical datasets with natural language through Claude, Cursor, or any MCP client</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.python.org/downloads/"><img alt="Python" src="https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white"></a>
+  <a href="https://modelcontextprotocol.io/"><img alt="MCP" src="https://img.shields.io/badge/MCP-Compatible-green?logo=ai&logoColor=white"></a>
+  <a href="https://github.com/hannesill/m4/actions/workflows/tests.yaml"><img alt="Tests" src="https://github.com/hannesill/m4/actions/workflows/tests.yaml/badge.svg"></a>
+</p>
+
+M4 is an infrastructure layer for multimodal EHR data that provides LLM agents with a unified toolbox for querying clinical datasets.
+It supports tabular data and clinical notes, dynamically selecting tools by modality to query MIMIC-IV, eICU, and custom datasets through a single natural-language interface.
+
+[Usage example](https://claude.ai/share/93f26832-f298-4d1d-96e3-5608d7f0d7ad)
+
+> M4 is a fork of the [M3](https://github.com/rafiattrach/m3) project and would not be possible without it 🫶 Please [cite](#citation) their work when using M4!
+
+
+## Quickstart (3 steps)
+
+### 1. Install uv
+
+**macOS/Linux:**
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+**Windows (PowerShell):**
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### 2. Initialize M4
+
+```bash
+mkdir my-research && cd my-research
+uv init && uv add m4-infra
+uv run m4 init mimic-iv-demo
+```
+
+This downloads the free MIMIC-IV demo dataset (~16MB) and sets up a local DuckDB database.
+
+### 3. Connect your AI client
+
+**Claude Desktop:**
+```bash
+uv run m4 config claude --quick
+```
+
+**Other clients (Cursor, LibreChat, etc.):**
+```bash
+uv run m4 config --quick
+```
+
+Copy the generated JSON into your client's MCP settings, restart, and start asking questions!
+
+<details>
+<summary>Different setup options</summary>
+
+* If you don't want to use uv, you can just run pip install m4-infra
+
+* If you want to use Docker, look at <a href="docs/DEVELOPMENT.md">docs/DEVELOPMENT.md</a>
+</details>
+
+
+## Code Execution
+
+For complex analysis that goes beyond simple queries, M4 provides a Python API that returns Python data types instead of formatted strings (e.g. pd.DataFrame for SQL queries). This transforms M4 from a query tool into a complete clinical data analysis environment.
+
+```python
+from m4 import set_dataset, execute_query, get_schema
+
+set_dataset("mimic-iv")
+
+# Get schema as a dict
+schema = get_schema()
+print(schema['tables'])  # ['admissions', 'diagnoses_icd', ...]
+
+# Query returns a pandas DataFrame
+df = execute_query("""
+    SELECT diagnosis, COUNT(*) as n
+    FROM diagnoses_icd
+    GROUP BY diagnosis
+    ORDER BY n DESC
+    LIMIT 10
+""")
+
+# Use full pandas power: filter, join, compute statistics
+df[df['n'] > 100].plot(kind='bar')
+```
+
+The API uses the same tools as the MCP server, so behavior is consistent. But instead of parsing text, you get DataFrames you can immediately analyze, visualize, or feed into downstream pipelines.
+
+**When to use code execution:**
+- Multi-step analyses where each query informs the next
+- Large result sets (thousands of rows) that shouldn't flood your context
+- Statistical computations, survival analysis, cohort characterization
+- Building reproducible analysis notebooks
+
+See [Code Execution Guide](docs/CODE_EXECUTION.md) for the full API reference.
+
+
+## Agent Skills
+
+M4 ships with skills that teach AI coding assistants how to use the Python API effectively. Skills are contextual prompts that activate when relevant—when you ask about clinical data analysis, the assistant automatically knows how to use M4's API.
+
+**Supported tools:** Claude Code, Cursor, Cline, Codex CLI, Gemini CLI, GitHub Copilot
+
+```bash
+m4 skills                        # Interactive tool selection
+m4 skills --tools claude,cursor  # Install for specific tools
+m4 skills --list                 # Show installed skills
+m4 config claude --skills        # Install during Claude Desktop setup
+```
+
+See [Skills Guide](docs/SKILLS.md) for details on the available skills and how to create custom ones.
+
+
+## Example Questions
+
+Once connected, try asking:
+
+**Tabular data (mimic-iv, eicu):**
+- *"What tables are available in the database?"*
+- *"Show me the race distribution in hospital admissions"*
+- *"Find all ICU stays longer than 7 days"*
+- *"What are the most common lab tests?"*
+
+**Clinical notes (mimic-iv-note):**
+- *"Search for notes mentioning diabetes"*
+- *"List all notes for patient 10000032"*
+- *"Get the full discharge summary for this patient"*
+
+
+## Supported Datasets
+
+| Dataset | Modality | Size | Access | Local | BigQuery |
+|---------|----------|------|--------|-------|----------|
+| **mimic-iv-demo** | Tabular | 100 patients | Free | Yes | No |
+| **mimic-iv** | Tabular | 365k patients | [PhysioNet credentialed](https://physionet.org/content/mimiciv/) | Yes | Yes |
+| **mimic-iv-note** | Notes | 331k notes | [PhysioNet credentialed](https://physionet.org/content/mimic-iv-note/) | Yes | Yes |
+| **eicu** | Tabular | 200k+ patients | [PhysioNet credentialed](https://physionet.org/content/eicu-crd/) | Yes | Yes |
+
+These datasets are supported out of the box. However, it is possible to add any other custom dataset by following [these instructions](docs/CUSTOM_DATASETS.md).
+
+Switch datasets anytime:
+```bash
+m4 use mimic-iv     # Switch to full MIMIC-IV
+m4 status           # Show active dataset details
+m4 status --all     # List all available datasets
+```
+
+<details>
+<summary><strong>Setting up MIMIC-IV or eICU (credentialed datasets)</strong></summary>
+
+1. **Get PhysioNet credentials:** Complete the [credentialing process](https://physionet.org/settings/credentialing/) and sign the data use agreement for the dataset.
+
+2. **Download the data:**
+   ```bash
+   # For MIMIC-IV
+   wget -r -N -c -np --user YOUR_USERNAME --ask-password \
+     https://physionet.org/files/mimiciv/3.1/ \
+     -P m4_data/raw_files/mimic-iv
+
+   # For eICU
+   wget -r -N -c -np --user YOUR_USERNAME --ask-password \
+     https://physionet.org/files/eicu-crd/2.0/ \
+     -P m4_data/raw_files/eicu
+   ```
+   Put the downloaded data in a `m4_data` directory that ideally is located within the project directory. Name the directory for the dataset `mimic-iv`/`eicu`.
+
+3. **Initialize:**
+   ```bash
+   m4 init mimic-iv   # or: m4 init eicu
+   ```
+
+This converts the CSV files to Parquet format and creates a local DuckDB database.
+</details>
+
+
+## Available Tools
+
+M4 exposes these tools to your AI client. Tools are filtered based on the active dataset's modality.
+
+**Dataset Management:**
+| Tool | Description |
+|------|-------------|
+| `list_datasets` | List available datasets and their status |
+| `set_dataset` | Switch the active dataset |
+
+**Tabular Data Tools** (mimic-iv, mimic-iv-demo, eicu):
+| Tool | Description |
+|------|-------------|
+| `get_database_schema` | List all available tables |
+| `get_table_info` | Get column details and sample data |
+| `execute_query` | Run SQL SELECT queries |
+
+**Clinical Notes Tools** (mimic-iv-note):
+| Tool | Description |
+|------|-------------|
+| `search_notes` | Full-text search with snippets |
+| `get_note` | Retrieve a single note by ID |
+| `list_patient_notes` | List notes for a patient (metadata only) |
+
+
+## More Documentation
+
+| Guide | Description |
+|-------|-------------|
+| [Code Execution](docs/CODE_EXECUTION.md) | Python API for programmatic access |
+| [Skills](docs/SKILLS.md) | Claude Code skills for contextual assistance |
+| [Tools Reference](docs/TOOLS.md) | MCP tool documentation |
+| [BigQuery Setup](docs/BIGQUERY.md) | Google Cloud for full datasets |
+| [Custom Datasets](docs/CUSTOM_DATASETS.md) | Add your own PhysioNet datasets |
+| [Development](docs/DEVELOPMENT.md) | Contributing, testing, architecture |
+| [OAuth2 Authentication](docs/OAUTH2_AUTHENTICATION.md) | Enterprise security setup |
+
+## Roadmap
+
+M4 is designed as a growing toolbox for LLM agents working with EHR data. Planned and ongoing directions include:
+
+- **More Tools**
+  - Implement tools for current modalities (e.g. statistical reports, RAG)
+  - Add tools for new modalities (images, waveforms)
+
+- **Better context handling**
+  - Concise, dataset-aware context for LLM agents
+
+- **Dataset expansion**
+  - Out-of-the-box support for additional PhysioNet datasets
+  - Improved support for institutional/custom EHR schemas
+
+- **Evaluation & reproducibility**
+  - Session export and replay
+  - Evaluation with the latest LLMs and smaller expert models
+
+The roadmap reflects current development goals and may evolve as the project matures.
+
+## Troubleshooting
+
+**"Parquet not found" error:**
+```bash
+m4 init mimic-iv-demo --force
+```
+
+**MCP client won't connect:**
+Check client logs (Claude Desktop: Help → View Logs) and ensure the config JSON is valid.
+
+**Need to reconfigure:**
+```bash
+m4 config claude --quick   # Regenerate Claude Desktop config
+m4 config --quick          # Regenerate generic config
+```
+
+## Citation
+
+M4 builds on the M3 project. Please cite:
+
+```bibtex
+@article{attrach2025conversational,
+  title={Conversational LLMs Simplify Secure Clinical Data Access, Understanding, and Analysis},
+  author={Attrach, Rafi Al and Moreira, Pedro and Fani, Rajna and Umeton, Renato and Celi, Leo Anthony},
+  journal={arXiv preprint arXiv:2507.01053},
+  year={2025}
+}
+```
+
+---
+
+<p align="center">
+  <a href="https://github.com/hannesill/m4/issues">Report an Issue</a> ·
+  <a href="docs/DEVELOPMENT.md">Contribute</a>
+</p>

m4_infra-0.0.0.dev0/README.md

@@ -0,0 +1,279 @@
+# M4: A Toolbox for LLMs on Clinical Data
+
+<p align="center">
+  <img src="webapp/public/m4_logo_transparent.png" alt="M4 Logo" width="180"/>
+</p>
+
+<p align="center">
+  <strong>Query clinical datasets with natural language through Claude, Cursor, or any MCP client</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.python.org/downloads/"><img alt="Python" src="https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white"></a>
+  <a href="https://modelcontextprotocol.io/"><img alt="MCP" src="https://img.shields.io/badge/MCP-Compatible-green?logo=ai&logoColor=white"></a>
+  <a href="https://github.com/hannesill/m4/actions/workflows/tests.yaml"><img alt="Tests" src="https://github.com/hannesill/m4/actions/workflows/tests.yaml/badge.svg"></a>
+</p>
+
+M4 is an infrastructure layer for multimodal EHR data that provides LLM agents with a unified toolbox for querying clinical datasets.
+It supports tabular data and clinical notes, dynamically selecting tools by modality to query MIMIC-IV, eICU, and custom datasets through a single natural-language interface.
+
+[Usage example](https://claude.ai/share/93f26832-f298-4d1d-96e3-5608d7f0d7ad)
+
+> M4 is a fork of the [M3](https://github.com/rafiattrach/m3) project and would not be possible without it 🫶 Please [cite](#citation) their work when using M4!
+
+
+## Quickstart (3 steps)
+
+### 1. Install uv
+
+**macOS/Linux:**
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+**Windows (PowerShell):**
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### 2. Initialize M4
+
+```bash
+mkdir my-research && cd my-research
+uv init && uv add m4-infra
+uv run m4 init mimic-iv-demo
+```
+
+This downloads the free MIMIC-IV demo dataset (~16MB) and sets up a local DuckDB database.
+
+### 3. Connect your AI client
+
+**Claude Desktop:**
+```bash
+uv run m4 config claude --quick
+```
+
+**Other clients (Cursor, LibreChat, etc.):**
+```bash
+uv run m4 config --quick
+```
+
+Copy the generated JSON into your client's MCP settings, restart, and start asking questions!
+
+<details>
+<summary>Different setup options</summary>
+
+* If you don't want to use uv, you can just run pip install m4-infra
+
+* If you want to use Docker, look at <a href="docs/DEVELOPMENT.md">docs/DEVELOPMENT.md</a>
+</details>
+
+
+## Code Execution
+
+For complex analysis that goes beyond simple queries, M4 provides a Python API that returns Python data types instead of formatted strings (e.g. pd.DataFrame for SQL queries). This transforms M4 from a query tool into a complete clinical data analysis environment.
+
+```python
+from m4 import set_dataset, execute_query, get_schema
+
+set_dataset("mimic-iv")
+
+# Get schema as a dict
+schema = get_schema()
+print(schema['tables'])  # ['admissions', 'diagnoses_icd', ...]
+
+# Query returns a pandas DataFrame
+df = execute_query("""
+    SELECT diagnosis, COUNT(*) as n
+    FROM diagnoses_icd
+    GROUP BY diagnosis
+    ORDER BY n DESC
+    LIMIT 10
+""")
+
+# Use full pandas power: filter, join, compute statistics
+df[df['n'] > 100].plot(kind='bar')
+```
+
+The API uses the same tools as the MCP server, so behavior is consistent. But instead of parsing text, you get DataFrames you can immediately analyze, visualize, or feed into downstream pipelines.
+
+**When to use code execution:**
+- Multi-step analyses where each query informs the next
+- Large result sets (thousands of rows) that shouldn't flood your context
+- Statistical computations, survival analysis, cohort characterization
+- Building reproducible analysis notebooks
+
+See [Code Execution Guide](docs/CODE_EXECUTION.md) for the full API reference.
+
+
+## Agent Skills
+
+M4 ships with skills that teach AI coding assistants how to use the Python API effectively. Skills are contextual prompts that activate when relevant—when you ask about clinical data analysis, the assistant automatically knows how to use M4's API.
+
+**Supported tools:** Claude Code, Cursor, Cline, Codex CLI, Gemini CLI, GitHub Copilot
+
+```bash
+m4 skills                        # Interactive tool selection
+m4 skills --tools claude,cursor  # Install for specific tools
+m4 skills --list                 # Show installed skills
+m4 config claude --skills        # Install during Claude Desktop setup
+```
+
+See [Skills Guide](docs/SKILLS.md) for details on the available skills and how to create custom ones.
+
+
+## Example Questions
+
+Once connected, try asking:
+
+**Tabular data (mimic-iv, eicu):**
+- *"What tables are available in the database?"*
+- *"Show me the race distribution in hospital admissions"*
+- *"Find all ICU stays longer than 7 days"*
+- *"What are the most common lab tests?"*
+
+**Clinical notes (mimic-iv-note):**
+- *"Search for notes mentioning diabetes"*
+- *"List all notes for patient 10000032"*
+- *"Get the full discharge summary for this patient"*
+
+
+## Supported Datasets
+
+| Dataset | Modality | Size | Access | Local | BigQuery |
+|---------|----------|------|--------|-------|----------|
+| **mimic-iv-demo** | Tabular | 100 patients | Free | Yes | No |
+| **mimic-iv** | Tabular | 365k patients | [PhysioNet credentialed](https://physionet.org/content/mimiciv/) | Yes | Yes |
+| **mimic-iv-note** | Notes | 331k notes | [PhysioNet credentialed](https://physionet.org/content/mimic-iv-note/) | Yes | Yes |
+| **eicu** | Tabular | 200k+ patients | [PhysioNet credentialed](https://physionet.org/content/eicu-crd/) | Yes | Yes |
+
+These datasets are supported out of the box. However, it is possible to add any other custom dataset by following [these instructions](docs/CUSTOM_DATASETS.md).
+
+Switch datasets anytime:
+```bash
+m4 use mimic-iv     # Switch to full MIMIC-IV
+m4 status           # Show active dataset details
+m4 status --all     # List all available datasets
+```
+
+<details>
+<summary><strong>Setting up MIMIC-IV or eICU (credentialed datasets)</strong></summary>
+
+1. **Get PhysioNet credentials:** Complete the [credentialing process](https://physionet.org/settings/credentialing/) and sign the data use agreement for the dataset.
+
+2. **Download the data:**
+   ```bash
+   # For MIMIC-IV
+   wget -r -N -c -np --user YOUR_USERNAME --ask-password \
+     https://physionet.org/files/mimiciv/3.1/ \
+     -P m4_data/raw_files/mimic-iv
+
+   # For eICU
+   wget -r -N -c -np --user YOUR_USERNAME --ask-password \
+     https://physionet.org/files/eicu-crd/2.0/ \
+     -P m4_data/raw_files/eicu
+   ```
+   Put the downloaded data in a `m4_data` directory that ideally is located within the project directory. Name the directory for the dataset `mimic-iv`/`eicu`.
+
+3. **Initialize:**
+   ```bash
+   m4 init mimic-iv   # or: m4 init eicu
+   ```
+
+This converts the CSV files to Parquet format and creates a local DuckDB database.
+</details>
+
+
+## Available Tools
+
+M4 exposes these tools to your AI client. Tools are filtered based on the active dataset's modality.
+
+**Dataset Management:**
+| Tool | Description |
+|------|-------------|
+| `list_datasets` | List available datasets and their status |
+| `set_dataset` | Switch the active dataset |
+
+**Tabular Data Tools** (mimic-iv, mimic-iv-demo, eicu):
+| Tool | Description |
+|------|-------------|
+| `get_database_schema` | List all available tables |
+| `get_table_info` | Get column details and sample data |
+| `execute_query` | Run SQL SELECT queries |
+
+**Clinical Notes Tools** (mimic-iv-note):
+| Tool | Description |
+|------|-------------|
+| `search_notes` | Full-text search with snippets |
+| `get_note` | Retrieve a single note by ID |
+| `list_patient_notes` | List notes for a patient (metadata only) |
+
+
+## More Documentation
+
+| Guide | Description |
+|-------|-------------|
+| [Code Execution](docs/CODE_EXECUTION.md) | Python API for programmatic access |
+| [Skills](docs/SKILLS.md) | Claude Code skills for contextual assistance |
+| [Tools Reference](docs/TOOLS.md) | MCP tool documentation |
+| [BigQuery Setup](docs/BIGQUERY.md) | Google Cloud for full datasets |
+| [Custom Datasets](docs/CUSTOM_DATASETS.md) | Add your own PhysioNet datasets |
+| [Development](docs/DEVELOPMENT.md) | Contributing, testing, architecture |
+| [OAuth2 Authentication](docs/OAUTH2_AUTHENTICATION.md) | Enterprise security setup |
+
+## Roadmap
+
+M4 is designed as a growing toolbox for LLM agents working with EHR data. Planned and ongoing directions include:
+
+- **More Tools**
+  - Implement tools for current modalities (e.g. statistical reports, RAG)
+  - Add tools for new modalities (images, waveforms)
+
+- **Better context handling**
+  - Concise, dataset-aware context for LLM agents
+
+- **Dataset expansion**
+  - Out-of-the-box support for additional PhysioNet datasets
+  - Improved support for institutional/custom EHR schemas
+
+- **Evaluation & reproducibility**
+  - Session export and replay
+  - Evaluation with the latest LLMs and smaller expert models
+
+The roadmap reflects current development goals and may evolve as the project matures.
+
+## Troubleshooting
+
+**"Parquet not found" error:**
+```bash
+m4 init mimic-iv-demo --force
+```
+
+**MCP client won't connect:**
+Check client logs (Claude Desktop: Help → View Logs) and ensure the config JSON is valid.
+
+**Need to reconfigure:**
+```bash
+m4 config claude --quick   # Regenerate Claude Desktop config
+m4 config --quick          # Regenerate generic config
+```
+
+## Citation
+
+M4 builds on the M3 project. Please cite:
+
+```bibtex
+@article{attrach2025conversational,
+  title={Conversational LLMs Simplify Secure Clinical Data Access, Understanding, and Analysis},
+  author={Attrach, Rafi Al and Moreira, Pedro and Fani, Rajna and Umeton, Renato and Celi, Leo Anthony},
+  journal={arXiv preprint arXiv:2507.01053},
+  year={2025}
+}
+```
+
+---
+
+<p align="center">
+  <a href="https://github.com/hannesill/m4/issues">Report an Issue</a> ·
+  <a href="docs/DEVELOPMENT.md">Contribute</a>
+</p>