Installation

Requirements

opp_repl requires Python 3.10 or later. It runs on Linux and macOS.

The released version is available from PyPI:

pip install opp_repl

For development or to track the latest changes, clone the repository and install in editable mode instead:

git clone https://github.com/omnetpp/opp_repl.git
cd opp_repl
pip install -e .

Either form pulls in the mandatory dependencies — IPython (for the interactive shell) and pandas (used pervasively for result tables).

Several features require additional packages. Install them individually or all at once:

pip install -e ".[all]"       # everything
pip install -e ".[cluster]"   # just one group

Extra	Packages	Purpose
`mcp`	mcp, httpx	MCP server for AI assistant integration
`optimize`	scipy, optimparallel	Parameter optimization
`chart`	matplotlib, numpy	Chart tests and image export
`diffcharts`	PyQt6	`opp_diff_charts` GUI for browsing chart and module-image diffs
`cluster`	dask, distributed	SSH cluster execution via Dask
`github`	requests	GitHub API integration
`ide`	py4j	OMNeT++ IDE integration
`all`	(all of the above)	Everything

Before starting opp_repl you typically need OMNeT++ on the path. Source its setenv script, then source the opp_repl one:

cd ~/workspace/omnetpp && . setenv
cd ~/workspace/opp_repl && . setenv

After this, the opp_repl command and all opp_* command-line tools are available.

opp_repl --help

If this prints the usage message, the installation is working.