OpenMed Agent

AI-powered medical assistant with interactive TUI, agentic workflows, and remote NLP inference

OpenMed Agent provides an intelligent terminal interface for clinical workflows — entity extraction, PII de-identification, and medical reasoning — powered by LLMs and remote NLP inference.

Quick Start

Installation

# Recommended: install the latest binary release
curl -fsSL https://github.com/openmed-labs/openmed-agent/releases/latest/download/install.sh | bash

# Install a pinned binary release
VERSION=0.0.1
curl -fsSL "https://github.com/openmed-labs/openmed-agent/releases/download/v${VERSION}/install.sh" | bash -s -- "${VERSION}"

Python Installation

# Install with TUI support
pip install openmed-agent[tui]

# Or install everything
pip install openmed-agent[all]

Launch the Agent TUI

openmed            # Launch interactive agent TUI
openmed agent      # Explicit agent command

Authenticate (for Codex models)

openmed login      # OAuth flow for Codex authentication

Features

• Interactive Agent TUI — Rich terminal interface for clinical analysis and medical reasoning
• Remote NLP Inference — NER and PII tools connect to remote inference endpoints via Docker
• MCP Server Integration — Connect to medical data sources (PubMed, ICD-10, NPI, CMS)
• Agentic Workflows — Plan-based execution with skill-driven task automation
• Configuration Profiles — dev/prod/test/fast presets with flexible overrides
• PHI Handling Modes — full, deid, strict modes for HIPAA-aware workflows

CLI Commands

openmed                    # Launch agent TUI (default)
openmed agent              # Launch agent TUI with options
openmed config show        # Show current configuration
openmed config profiles    # List available profiles
openmed mcp list           # List MCP server configuration
openmed mcp enable         # Enable MCP servers
openmed mcp doctor         # Check MCP server connectivity
openmed login              # Authenticate via OAuth
openmed oauth status       # Check authentication status

Remote Inference

NER and PII tools require a remote inference endpoint. Set the environment variable:

export OPENMED_INFERENCE_URL=http://localhost:8000

See services/inference/ for the Docker-based inference server.

Binary Releases

Standalone release archives are built by binary-release.yml and published with:

• platform tarballs such as openmed-0.0.1-darwin-arm64.tar.gz
• openmed-manifest.json for install.sh
• openmed-checksums.txt for manual verification

To build a release artifact locally:

uv sync --extra all --extra build
uv run --no-sync python scripts/release/build_binary.py

Contributing

We welcome contributions! Whether it's bug reports, feature requests, or pull requests.

License

OpenMed is released under the Apache-2.0 License.

Citation

If you use OpenMed in your research, please cite:

@misc{panahi2025openmedneropensourcedomainadapted,
      title={OpenMed NER: Open-Source, Domain-Adapted State-of-the-Art Transformers for Biomedical NER Across 12 Public Datasets},
      author={Maziyar Panahi},
      year={2025},
      eprint={2508.01630},
      archivePrefix={arXiv},
      primaryClass={cs.CL},
      url={https://arxiv.org/abs/2508.01630},
}