Common Open Research Emulator

emane emulating-networks emulation emulator network python rf wireless

Find a file

Blake Harnden 281a848bbf grpc: fixed documentation mistake in grpc server		2022-09-13 12:46:56 -07:00
.github	moved python black configuration to pyproject.toml and fixed bad exclude	2020-07-14 13:33:40 -07:00
daemon	grpc: fixed documentation mistake in grpc server	2022-09-13 12:46:56 -07:00
docs	docs: updated install doc to provide a better example for installing emane python bindings into a virtual environment	2022-08-30 12:25:34 -07:00
man	daemon: removing python tlv related code and tests related to it	2022-03-08 14:18:47 -08:00
netns	daemon: removing python tlv related code and tests related to it	2022-03-08 14:18:47 -08:00
package	install: add option to avoid y/n prompt when uninstalling core during post install script	2022-07-29 14:03:45 -07:00
.editorconfig	added net client to consolidate bridge and interface creation	2019-09-26 15:20:32 -07:00
.gitignore	daemon: added core player writer and player to core library and added wireless event handling, fixed issues with wireless nodes being written to xml	2022-03-31 16:31:20 -07:00
ASSIGNMENT_OF_COPYRIGHT.pdf	updated assignment of copyright file name to add to dist file	2017-12-18 09:28:41 -08:00
bootstrap.sh	daemon: removing python tlv related code and tests related to it	2022-03-08 14:18:47 -08:00
CHANGELOG.md	updated changelog for 8.2.0 release	2022-03-21 21:43:24 -07:00
configure.ac	install: bumped version to 9.0.0 for next release	2022-05-11 09:19:00 -07:00
Dockerfile.centos	update dockerfiles to fix default branch name in the oracle linux dockerfile and update pip in the centos dockerfile to get back to working order	2022-06-27 09:38:52 -07:00
Dockerfile.oracle	update dockerfiles to fix default branch name in the oracle linux dockerfile and update pip in the centos dockerfile to get back to working order	2022-06-27 09:38:52 -07:00
Dockerfile.ubuntu	install: updated and added dockerfiles for ubuntu/centos, updated notes on install page to correlate	2022-05-25 21:43:52 -07:00
LICENSE	updates to simplify tracking the copyright and an update to 2018, still room for improvement	2018-03-15 10:36:54 -07:00
Makefile.am	install: updates to support building deb/rpm packages that contain python wheels and install core from a single file, updates to core to install scripts by way of python directly	2022-07-27 16:00:10 -07:00
README.md	install: updated install instructions to use the right command for centos example	2022-02-28 10:03:34 -08:00
setup.sh	install: adjustments to install scripts to better support alternative versions of python, PYTHON_DEP added for system package adjustments	2022-05-27 20:10:48 -07:00
tasks.py	install: added task using a subset of the previous auto install to support auto setup and building of core packages	2022-07-29 14:12:17 -07:00

README.md

CORE

CORE: Common Open Research Emulator

See the LICENSE file included in this distribution.

About

The Common Open Research Emulator (CORE) is a tool for emulating networks on one or more machines. You can connect these emulated networks to live networks. CORE consists of a GUI for drawing topologies of lightweight virtual machines, and Python modules for scripting network emulation.

Quick Start

The following should get you up and running on Ubuntu 18+ and CentOS 7+ from a clean install, it will prompt you for sudo password. This would install CORE into a python3 virtual environment and install OSPF MDR from source. For more detailed installation see here.

git clone https://github.com/coreemu/core.git
cd core
# install dependencies to run installation task
./setup.sh
# run the following or open a new terminal
source ~/.bashrc
# Ubuntu
inv install
# CentOS
inv install -p /usr

Documentation & Support

We are leveraging GitHub hosted documentation and Discord for persistent chat rooms. This allows for more dynamic conversations and the capability to respond faster. Feel free to join us at the link below.