Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ryu component-based software defined networking framework
Python Erlang Other

ryu.contrib: Be explicit about sys.path modification

Avoid the automatic modification of sys.path because it hurts
ryu-as-a-library use cases.
An example is the recent versions of neutron OVS-agent,
which optionally imports OVS python bindings, and ends up to
use a wrong copy in ryu.contrib.ovs.

Signed-off-by: YAMAMOTO Takashi <>
Signed-off-by: FUJITA Tomonori <>
latest commit cdd7084b94
@yamt yamt authored fujita committed


What's Ryu

Ryu is a component-based software defined networking framework.

Ryu provides software components with well defined API that make it easy for developers to create new network management and control applications. Ryu supports various protocols for managing network devices, such as OpenFlow, Netconf, OF-config, etc. About OpenFlow, Ryu supports fully 1.0, 1.2, 1.3, 1.4 and Nicira Extensions.

All of the code is freely available under the Apache 2.0 license. Ryu is fully written in Python.

Quick Start

Installing Ryu is quite easy:

% pip install ryu

If you prefer to install Ryu from the source code:

% git clone git://
% cd ryu; python ./ install

If you want to use Ryu with OpenStack, please refer networking-ofagent project.

If you want to write your Ryu application, have a look at Writing ryu application document. After writing your application, just type:

% ryu-manager

Optional Requirements

Some functionalities of ryu requires extra packages:

  • OF-Config requires lxml
  • NETCONF requires paramiko
  • BGP speaker (net_cntl) requires paramiko

If you want to use the functionalities, please install requirements:

% pip install lxml
% pip install paramiko


Ryu Official site is

If you have any questions, suggestions, and patches, the mailing list is available at ryu-devel ML. The ML archive at Gmane is also available.

Something went wrong with that request. Please try again.