Simplifying OMNeT++ Model Installations

opp_env is a powerful tool that allows for the easy and automated installation of OMNeT++ simulation frameworks and models, including dependencies like INET Framework and OMNeT++ itself.

Terminal
$ opp_env install simu5g-latest
✓ Installing OMNeT++ 6.0.3...
✓ Installing INET 4.5.2...
✓ Installing Simu5G 1.2.2...
$ opp_env shell
Ready to simulate! 🚀

The Problem: Manual Installation Hassles

Installing many OMNeT++ models and model frameworks can be tedious and error-prone.

⚙️

Version Dependencies

Models often require specific OMNeT++ versions and dependencies like INET, Veins, or Simu5G in correct versions.

🔧

Configuration Complexity

Adjusting variables in config files, sourcing environment scripts, and importing projects into the IDE.

🐛

Compatibility Issues

Compiling older models can be challenging due to bitrot from compiler and library changes.

Enter opp_env

We developed opp_env to solve these problems automatically.

  • 📦 Download and install simulation models, including the appropriate OMNeT++ version
  • 🖥️ Provide a ready-to-use shell environment for running simulations
  • 🔄 Set up a development environment from a remote Git repository
1

List Models

opp_env list
2

Install Model

opp_env install simu5g-latest
3

Start Shell

opp_env shell

Powerful Features

opp_env provides everything you need for efficient OMNeT++ simulation development

🤖

Automated Installation

Automatically installs OMNeT++ simulation frameworks and models with all dependencies resolved.

🔄

Reproducible Builds

Powered by Nix package manager for consistent, isolated, and reproducible installations across machines.

🖥️

Ready-to-Use Environment

Easy shell command that sets up a complete environment for working with simulation frameworks.

⚙️

Customizable Configuration

Advanced configuration options for fine-tuned control over the installation process.

🌐

Cross-Platform Support

Supports Linux and macOS systems. Windows 11 support via WSL2.

📚

Extensive Model Library

Access to over 70 simulation models including INET, Veins, SimuLTE, Simu5G, and more.

Installation on Linux and macOS

Get started with opp_env in just a few simple steps

1

Install Nix Package Manager

opp_env relies on Nix for reproducible builds and dependency management.

curl -L https://nixos.org/nix/install | sh
2

Install opp_env

Install opp_env using pip from PyPI.

pip install opp-env
3

Verify Installation

Check that opp_env is properly installed and working.

opp_env --help
💡

Need detailed instructions?

Visit the installation guide for platform-specific instructions and troubleshooting.

Installation on Windows

Get started with opp_env on with a single command

1

Install opp_env using a Windows Subsystem for Linux (WSL) image

opp_env can be used by downloading and installing a WSL image.

curl.exe -L https://github.com/omnetpp/opp_env/releases/download/wsl/opp_env.wsl | wsl --import opp_env -
2

Start the WSL image

Start the opp_env WSL image.

wsl -d opp_env
💡

Need detailed instructions?

Visit the installation guide for platform-specific instructions and troubleshooting.

Usage

Learn how to use opp_env with practical examples

Quick Start Example

Here's how to get started with Simu5G in just a few commands:

$ mkdir my_workspace && cd my_workspace
$ opp_env init
$ opp_env install simu5g-latest
✓ Installing OMNeT++ 6.0.3...
✓ Installing INET 4.5.2...
✓ Installing Simu5G 1.2.2...
$ opp_env shell
(opp_env)$ cd simu5g-1.2.2/simulations/NR/standalone
(opp_env)$ ./run

Common Commands

List Available Models

opp_env list

Shows all available simulation models and their versions.

Get Model Information

opp_env info simu5g-latest

Displays detailed information about a specific model including dependencies.

One-Command Setup

opp_env shell -w my_workspace --init --install simu5g-latest

Creates workspace, installs model, and opens shell in one command.

Run Specific Command

opp_env run simu5g-latest -- ./run

Runs a command in the model environment without opening an interactive shell.

Available Models

Access to over 70 simulation models and frameworks

Core Frameworks

  • OMNeT++ - Discrete event simulation framework
  • INET - Internet protocol suite simulation

Wireless & Mobile

  • Simu5G - 5G NR and LTE simulation
  • Veins - Vehicular network simulation
  • SimuLTE - LTE network simulation
  • Castalia - Wireless sensor networks

Specialized Models

  • CORE4INET - Real-time Ethernet
  • Artery - V2X communication
  • Nesting - TSN simulation
  • QUISP - Quantum networks

Use opp_env list to see the complete list of available models with version numbers.

Why Choose opp_env?

01

Save Time

No more manual dependency hunting or configuration headaches. Get up and running in minutes, not hours.

02

Avoid Errors

Eliminate version conflicts and compatibility issues with automated dependency resolution.

03

Reproducible Results

Ensure consistent simulation environments across different machines and team members.

04

Focus on Research

Spend your time on simulation design and analysis, not on installation and setup.

Ready to Simplify Your OMNeT++ Workflow?

Join researchers and developers worldwide who are using opp_env to streamline their simulation projects.