Skip to main content

nwdiag generates network-diagram image from text

Project description

nwdiag generate network-diagram image file from spec-text file. CI build status Latest PyPI version Number of PyPI downloads


  • Generate network-diagram from dot like text (basic feature).

  • Multilingualization for node-label (utf-8 only).

You can get some examples and generated images on .


Use easy_install or pip:

$ sudo easy_install nwdiag


$ sudo pip nwdiag

spec-text setting sample

Few examples are available. You can get more examples at .


simple.diag is simply define nodes and transitions by dot-like text format:

nwdiag {
  network dmz {
      address = "210.x.x.x/24"

      web01 [address = "210.x.x.1"];
      web02 [address = "210.x.x.2"];
  network internal {
      address = "172.x.x.x/24";

      web01 [address = "172.x.x.1"];
      web02 [address = "172.x.x.2"];


Execute nwdiag command:

$ nwdiag simple.diag
$ ls simple.png


  • Python 3.7 or later

  • blockdiag 1.5.0 or later

  • funcparserlib 0.3.6 or later

  • reportlab (optional)

  • wand and imagemagick (optional)

  • setuptools


Apache License 2.0

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nwdiag-3.0.0.tar.gz (7.8 MB view hashes)

Uploaded Source

Built Distribution

nwdiag-3.0.0-py3-none-any.whl (7.7 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page