Metadata-Version: 2.4
Name: open-pharma-plugins
Version: 2.4.1
Summary: Open Pharma Plugins: Agent Skills + MCP tools for pharmaceutical commercial operations — HCP intelligence, territory alignment, competitive intelligence, field training, engagement planning, and campaign creation.
Author: Jason Zhang
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/PharmaGenAI/open-pharma-plugins
Project-URL: Repository, https://github.com/PharmaGenAI/open-pharma-plugins
Project-URL: Issues, https://github.com/PharmaGenAI/open-pharma-plugins/issues
Keywords: mcp,pharma,commercial,agent-skills,hcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: <3.14,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: mcp<2,>=1.0.0
Requires-Dist: anyio<5,>=4.0
Requires-Dist: pydantic<3,>=2.8
Provides-Extra: hcp-intelligence
Requires-Dist: requests<3,>=2.31; extra == "hcp-intelligence"
Provides-Extra: hcp-intelligence-synth
Requires-Dist: requests<3,>=2.31; extra == "hcp-intelligence-synth"
Requires-Dist: openai<4,>=1; extra == "hcp-intelligence-synth"
Provides-Extra: field-training
Requires-Dist: pypdfium2<6,>=4; extra == "field-training"
Requires-Dist: python-pptx<2,>=1; extra == "field-training"
Provides-Extra: field-training-fixtures
Requires-Dist: pypdfium2<6,>=4; extra == "field-training-fixtures"
Requires-Dist: python-pptx<2,>=1; extra == "field-training-fixtures"
Requires-Dist: reportlab<6,>=4; extra == "field-training-fixtures"
Provides-Extra: next-best-engagement
Provides-Extra: territory-alignment
Provides-Extra: competitive-intelligence
Requires-Dist: pypdfium2<6,>=4; extra == "competitive-intelligence"
Requires-Dist: python-docx<2,>=1; extra == "competitive-intelligence"
Provides-Extra: campaign-studio
Requires-Dist: jinja2<4,>=3.1; extra == "campaign-studio"
Requires-Dist: pypdf<7,>=5; extra == "campaign-studio"
Requires-Dist: reportlab<6,>=4; extra == "campaign-studio"
Provides-Extra: all
Requires-Dist: requests<3,>=2.31; extra == "all"
Requires-Dist: openai<4,>=1; extra == "all"
Requires-Dist: pypdfium2<6,>=4; extra == "all"
Requires-Dist: python-pptx<2,>=1; extra == "all"
Requires-Dist: python-docx<2,>=1; extra == "all"
Requires-Dist: reportlab<6,>=4; extra == "all"
Requires-Dist: jinja2<4,>=3.1; extra == "all"
Requires-Dist: pypdf<7,>=5; extra == "all"
Dynamic: license-file

# Open Pharma Plugins

Agent Skills and MCP servers for pharmaceutical commercial operations.

## Architecture

<p align="center"><img src="docs/assets/architecture.svg" width="960" alt="Open Pharma Plugins architecture"></p>

Each capability installs independently as a Skill plus an MCP server. The Python distribution contains the servers; Skills, cookbooks, and marketplace manifests are installed from this repository.

## Install

The guided installer supports Claude Code, Codex, and GitHub Copilot CLI. It requires `uv`/`uvx` and uses independent, immutable capability tags.

Download and inspect the installer before running it:

```bash
curl -fsSLO https://raw.githubusercontent.com/PharmaGenAI/open-pharma-plugins/main/install.sh
less install.sh
bash install.sh
```

Update capabilities already installed in a harness:

```bash
bash install.sh update
```

To install MCP servers without the companion Skills, use one or more extras from the Python distribution:

```bash
python -m pip install "open-pharma-plugins[territory-alignment,competitive-intelligence]"
```

See [Installation](docs/en/installation.md) for tagged releases, local checkouts, rollback, and manual setup.

## Capabilities

| Capability | Tools | Use case |
|---|---:|---|
| [HCP Intelligence](cookbooks/hcp-intelligence/usage.md) | 11 | Build evidence-backed HCP/HCO profiles from public sources |
| [Field Training](cookbooks/field-training/usage.md) | 5 | Create grounded learning packages, assessments, role-play kits, and scorecards from approved documents |
| [Campaign Studio](cookbooks/campaign-studio/usage.md) | 16 | Draft campaigns, validate claims, render assets, and prepare MLR review packages |
| [Next-Best-Engagement](cookbooks/next-best-engagement/usage.md) | 3 | Score HCPs and produce consent-aware engagement plans |
| [Territory Alignment](cookbooks/territory-alignment/usage.md) | 6 | Compare HCP-to-rep assignments and plan visit clusters |
| [Competitive Intelligence](cookbooks/competitive-intelligence/usage.md) | 12 | Collect evidence and produce reproducible briefings and timelines |

## Try it

After installing a capability, reference your files and ask naturally. The Skill selects the relevant MCP tools.

```text
@speakers.csv       Build evidence-backed profiles for these HCPs.
@training.pdf       Create a learning package and assessment from this approved document.
@brief.md           Draft a campaign and prepare it for MLR review.
@alignment.csv      Compare assignments and identify workload imbalances.
```

## Requirements and configuration

- Python 3.10–3.13
- `uv`/`uvx` for the guided plugin installer
- Provider credentials only for the capabilities and external services you use

Run the installer's **Configure** and **Verify** actions to set credentials and check dependencies. Shared configuration lives in `~/.open-pharma-plugins/config`.

See [Configuration](docs/en/configuration.md) and [Data security](docs/en/data_security.md) for settings, local data, provider calls, and compliance boundaries.

## Documentation

- [Installation](docs/en/installation.md) · [Configuration](docs/en/configuration.md)
- [Local development](docs/en/local_development.md) · [Testing](docs/en/testing.md)
- [Contributing](CONTRIBUTING.md) · [Adding a capability](docs/en/how_to_add_new_capability.md)
- [Security policy](SECURITY.md) · [Release guide](docs/en/releasing.md)
- [中文文档](docs/zh/) · [日本語ドキュメント](docs/jp/)
- [Project website](https://pharmagenai.github.io/)

## License

Apache-2.0. See [LICENSE](LICENSE).
