Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gaphor/gaphor

Gaphor is the simple modeling tool
https://github.com/gaphor/gaphor

c4model diagram fta gnome gtk mbse model-based-systems-engineering modeling python stpa sysml uml

Last synced: about 2 months ago
JSON representation

Gaphor is the simple modeling tool

Host: GitHub
URL: https://github.com/gaphor/gaphor
Owner: gaphor
Created: 2009-06-24T20:01:13.000Z (about 15 years ago)
Default Branch: main
Last Pushed: 2024-05-17T19:36:22.000Z (4 months ago)
Last Synced: 2024-05-19T00:05:59.757Z (4 months ago)
Topics: c4model, diagram, fta, gnome, gtk, mbse, model-based-systems-engineering, modeling, python, stpa, sysml, uml
Language: Python
Homepage: https://gaphor.org
Size: 47.2 MB
Stars: 1,718
Watchers: 47
Forks: 187
Open Issues: 99
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSES/Apache-2.0.txt
- Security: SECURITY.md

Awesome Lists containing this project

awesome-python-applications - Repo
fucking-Awesome-Linux-Software - ![Open-Source Software - A simple and fast software and systems modeling tool. (Applications / Development)
open-source-mac-os-apps - Gaphor - Gaphor is the simple modeling tool for UML and SysML. ![python_icon] (Applications / Graphics)
Awesome-Linux-Software - ![Open-Source Software - A simple and fast software and systems modeling tool. (Applications / Development)
open-source-mac-os-apps - Gaphor - Gaphor is the simple modeling tool for UML and SysML. ![python_icon] (Applications / Graphics)
awesome-starred - gaphor/gaphor - Gaphor is the simple modeling tool (python)
awesome-python-applications - Repo

README

        


[![Build](https://github.com/gaphor/gaphor/actions/workflows/full-build.yml/badge.svg)](https://github.com/gaphor/gaphor/actions/workflows/full-build.yml?query=branch%3Amain)

[![Docs build state](https://readthedocs.org/projects/gaphor/badge/?version=latest)](https://docs.gaphor.org)

[![PyPI](https://img.shields.io/pypi/v/gaphor.svg)](https://pypi.org/project/gaphor)

[![PyPI - Downloads](https://img.shields.io/pypi/dm/gaphor)](https://pypistats.org/packages/gaphor)

[![Matrix](https://img.shields.io/badge/chat-on%20Matrix-success)](https://app.element.io/#/room/#gaphor_Lobby:gitter.im)

[![Maintainability](https://api.codeclimate.com/v1/badges/f00974f5d7fe69fe4ecd/maintainability)](https://codeclimate.com/github/gaphor/gaphor/maintainability)

[![Test Coverage](https://api.codeclimate.com/v1/badges/f00974f5d7fe69fe4ecd/test_coverage)](https://codeclimate.com/github/gaphor/gaphor/test_coverage)

[![Translation Status](https://hosted.weblate.org/widgets/gaphor/-/gaphor/svg-badge.svg)](https://hosted.weblate.org/engage/gaphor)

[![Sourcery](https://img.shields.io/badge/Sourcery-enabled-brightgreen)](https://sourcery.ai)

[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg)](https://github.com/RichardLitt/standard-readme)

[![All Contributors.org](https://img.shields.io/github/all-contributors/gaphor/gaphor/main)](#contributors)

Gaphor is a UML and SysML modeling application written in Python.

It is designed to be easy to use, while still being powerful. Gaphor implements a fully-compliant UML 2 data model, so it is much more than a picture drawing tool. You can use Gaphor to quickly visualize different aspects of a system as well as create complete, highly complex models.



## 📑 Table of Contents

- [📑 Table of Contents](#-table-of-contents)

- [📜 Background](#-background)

- [💾 Install](#-install)

- [🔦 Usage](#-usage)

- [♥ Contributing](#-contributing)

  - [🌍 Translations](#-translations)

  - [♿️ Code of Conduct](#️-code-of-conduct)

- [©️ License](#️-license)

## 📜 Background

Gaphor is a UML and SysML modeling application written in Python. We designed

it to be easy to use, while still being powerful. Gaphor implements a

fully-compliant UML 2 data model, so it is much more than a picture drawing

tool. You can use Gaphor to quickly visualize different aspects of a system as

well as create complete, highly complex models.

Gaphor is designed around the following principles:

- Simplicity: The application should be easy to use. Only some basic knowledge of UML or SysML is required.

- Consistency: UML is a graphical modeling language, so all modeling is done in a diagram.

- Workability: The application should not bother the user every time they do something non-UML-ish.

Gaphor is a GUI application. It has a modern [GTK](https://gtk.org)-based interface and uses

[Cairo](https://www.cairographics.org/) for consistent rendering.

Gaphor is a library.

You can use it from [scripts and Jupyter notebooks](https://docs.gaphor.org/en/latest/scripting.html)

and interact with models programmatically.

Non-Goals:

- Generating UML diagrams from source code. [pynsource](https://github.com/abulka/pynsource) or [pyreverse](https://github.com/pylint-dev/pylint/tree/main/pylint/pyreverse) might be what you are looking for.

- Generating source code from diagrams or creating other concrete executable artifacts including use of fUML or ALF.

Although it would be possible to incorporate these features, these aren't the

goals of this project. However, if these are important capabilities for you,

you may be able to extend Gaphor by creating a

[plugin](https://docs.gaphor.org/en/latest/service_oriented.html#example-plugin).

## 💾 Install



You can find [the latest version](https://gaphor.org/download) on the

[gaphor.org website](https://gaphor.org/download). Gaphor ships installers for

macOS and Windows. Those can be found there. The Python package is also

[available on PyPI](https://pypi.org/project/gaphor/).

All releases are available on

[GitHub](https://github.com/gaphor/gaphor/releases/).

If you want to start developing on Gaphor, have a look at the [Installation

section of our documentation](https://docs.gaphor.org/en/latest/).

## 🔦 Usage

If using Gaphor for the first time you will be presented with a greeter dialog

at startup in which you can select one of 5 models available to you to work in:

- **Generic:** (or blank) template

- **UML:** *Unified Modeling Language* template

- **SysML:** *Systems Modeling Language* template

- **RAAML:** *Risk Analysis and Assessment Modeling language* template

- **C4 Model:** *a lean graphical notation technique for modelling the architecture of software systems* template

After you select a template, the main Gaphor window will load, and you will be

ready to start modeling. Gaphor will automatically select the correct profile

based on the template that you selected, but you can also select other modeling

profiles if needed by clicking on the button next to the Profile dropdown menu

at the top of your window.

To select an element you want to place, for example a Class, click on the icon

in the Toolbox and then again on the diagram. This will place a new Class item

on the diagram and add a new Class to the model (it shows up in the

[Model Browser](https://docs.gaphor.org/en/latest/getting_started.html#model-browser)).

Portions of the toolbox may also be collapsed depending on the type of diagram

you are modeling with. You can expand the collapsed portions of the toolbox if

needed.

If you want to know more, please read our documentation on https://docs.gaphor.org.

## ♥ Contributing

Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):

  

    

      
_2old4it
🐛

      
_2old4this
🐛

      
_3fla1416
🐛

      
_{Adam Bjurstrom}
🐛

      
_{Adam Boduch}
💻 ⚠️ 🐛

      
_{Alen Šiljak}
🐛

      
_{Alexander Wilms}
🐛

    

    

      
_{Alexis Howells}
📖

      
_{Amor Ali}
🐛

      
_{Amy Y}
🌍

      
_Andrei
🐛

      
_Andrew
🐛

      
_{Antonio Mejia}
🌍

      
_{Arjan Molenaar}
💻 🐛 📖 👀 💬 🐛 🔌 ⚠️

    

    

      
_{Aurélien Joga}
📖

      
_{Bill ZHANG}
🌍

      
_{Björn Strömberg}
🐛

      
_Blippost
🤔

      
_{Brage Fuglseth}
🎨

      
_{Brandan Glendenning}
📖

      
_{Brock Tibert}
🐛

    

    

      
_{Can Lehmann}
💻

      
_{Christian Hoff}
💻

      
_DKX47
🐛

      
_{Dan Yeaw}
💻 ⚠️ 📖 📦 🚇 🐛 💬

      
_{Daniel Bergløv}
🤔

      
_{Daniel Hulse}
📖

      
_{Daniel Nylander}
🌍

    

    

      
_DimShadoWWW
🐛

      
_{Douglas B}
📖

      
_{Encolpe DEGOUTE}
🌍

      
_{Enno Gröper}
💻

      
_{Enno Zickler}
🐛

      
_Ercalvez
🌍

      
_{Erwan Bousse}
🤔 🐛

    

    

      
_{Eryk Michalak}
🌍

      
_{Felipe Nogueira}
🌍

      
_Fell-x27
🐛

      
_{Fran Diéguez}
🌍

      
_{Francisco Gouveia}
💻

      
_{Gabriel Gian}
🌍

      
_{Gleb Smirnov}
🐛

    

    

      
_{Greg Stewart}
🐛

      
_Gytree
🐛

      
_{Günther Wagner}
🐛

      
_{Hamish Mcintyre-Bhatty}
🐛

      
_{HighKingofMelons}
🐛

      
_{Igor Lerinc}
🐛

      
_{Ikko Ashimine}
💻

    

    

      
_JACKADUX
🐛

      
_{Jacob Crabill}
🐛

      
_{Jacobo Aragunde Pérez}
🐛

      
_Jan
🐛

      
_{Jean-Luc Tibaux}
🌍

      
_JensPfeifle
📖

      
_Jonathan
🤔 🐛 🌍 💻

    

    

      
_{Jonathan E. Magen}
🤔

      
_{JonnathanRiquelmo}
🌍

      
_{Jordi Mallach}
🌍

      
_{Jorge DLG}
🐛

      
_{João Correia}
💻

      
_{Juha-Matti Kokkonen}
🐛

      
_{Julius Rüberg}
🐛

    

    

      
_{JuliusBrueggemann}
🐛

      
_{K.B.Dharun Krishna}
🌍

      
_{Kapil Thangavelu}
🐛

      
_KhazAkar
🐛

      
_{Kian-Meng Ang}
📖

      
_{Lazerbeak12345}
🐛

      
_Lordy
🐛

    

    

      
_{Mark Kennedy}
🤔 💻 🐛

      
_{Mark-Daniel Lüthje}
🌍

      
_Mat
💻

      
_{Matthew Maclaine}
🐛

      
_Maxim
🐛

      
_Mek101
🐛

      
_{Michael J. Vinca}
🐛

    

    

      
_{Michael Patrick Tkacik}
🐛

      
_{Mikhail Bessonov}
🐛

      
_{Mikkel Aunsbjerg Jakobsen}
🐛

      
_{Nathan Hadley}
🌍

      
_{Nedko Arnaudov}
🐛

      
_Patrik
🤔

      
_{Paul Menzel}
📖

    

    

      
_{Paweł Pająk}
🐛

      
_Petal
📖 🌍

      
_{Phil_Smurf}
🤔

      
_{Philip Goto}
🌍

      
_{Rafael Fontenelle}
🌍 🤔

      
_{Rafael Muñoz Cárdenas}
🐛

      
_RenStone83
🐛

    

    

      
_{Richard Bamford}
🐛

      
_{Rui Maciel}
🤔

      
_{Sabri Ünal}
🌍 💻

      
_{Sascha Holzhauer}
🐛 📖

      
_SebCanet
🤔

      
_Sebi
🐛

      
_{Seong-ho Cho}
🌍

    

    

      
_{Sergej A.}
🌍

      
_{Sophie Herold}
💻 ️️️️♿️

      
_{Steve Kossouho}
🐛 💻

      
_{Steven Liu}
🐛

      
_{Sycophantic-Witty}
🐛

      
_{Teun Hoevenaars}
📖

      
_Thomas
🐛

    

    

      
_{Thomas Firchau}
📖

      
_{Tiemen Schuijbroek}
🐛 💻

      
_{Tobias Bernard}
🎨 🤔

      
_TomBous
🐛

      
_{Tomasz Drożdż}
🤔

      
_Tony
🚧

      
_Viicos
🐛

    

    

      
_Xander982
🖋 🐛

      
_YantaoZhao
🐛 🤔

      
_{Yauhen Kirylau}
📖 📦 🤔 🐛

      
_{Zsolt Sandor}
🤔 🐛 💻 📖

      
_\s\m
📖

      
_{albanobattistella}
🌍

      
_alkis05
🤔

    

    

      
_bayerl
📖

      
_cloud-erik
🤔

      
_deifemu
🐛

      
_{echo r"0xX4H" | rev}
🌍

      
_freddii
🤔 📖

      
_{freezed-or-frozen}
🐛

      
_fu7mu4
🌍

    

    

      
_{gavr123456789}
🤔

      
_ghillebrand
🤔 🐛

      
_greedyj4ck
🐛

      
_johnvon
🌍

      
_{jposada202020}
🌍

      
_kellenmoura
🐛

      
_lightonflux
🐛

    

    

      
_lukman83
🐛

      
_madiharvey
🤔 🐛

      
_matgaj
🐛 🤔

      
_mcdigregorio
🐛

      
_melisdogan
📖

      
_mikekidner
🐛 💻 📖

      
_milotype
🌍 📖

    

    

      
_mskorkowski
🐛

      
_noblevirk
🤔

      
_nomisge
🐛 🤔

      
_ovari
🤔 🌍 🐛

      
_perovsek
🌍 🐛

      
_peter88213
🐛

      
_qsodev
🐛

    

    

      
_samirodj
🐛

      
_seryafarma
📖

      
_shobeira
🐛 🤔

      
_sib@c
🐛 🤔

      
_tompkins-ct
🐛 🤔

      
_tronta
🐛

      
_vikdevelop
🌍

    

    

      
_wrobell
💻 ⚠️ 🐛 🎨

      
_{zhangxinqiang}
🌍

      
_{Óscar Fernández Díaz}
🌍 💻

      
_{Евгений Лежнин}
🌍

      
_{Пётр Сабанов}
🌍

      
_品雪
🐛

    

  

This project follows the

[all-contributors](https://github.com/kentcdodds/all-contributors)

specification. Contributions of any kind are welcome!

1.  Check for open issues or open a fresh issue to start a discussion

    around a feature idea or a bug. There is a

    [first-timers-only](https://github.com/gaphor/gaphor/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aopen+label%3Afirst-timers-only)

    tag for issues that should be ideal for people who are not very

    familiar with the codebase yet.

2.  Fork [the repository](https://github.com/gaphor/gaphor) on

    GitHub to start making your changes to the **main** branch (or

    branch off of it).

3.  Write a test which shows that the bug was fixed or that the feature

    works as expected.

4.  Send a pull request and bug the maintainers until it gets merged and

    published. :smile:

See [the contributing guide](CONTRIBUTING.md)!

### 🌍 Translations

Translation of Gaphor is mostly done using

[Weblate](https://hosted.weblate.org/projects/gaphor/gaphor/).

For the Linux Flatpak, the desktop entry comment string can be translated at our

[Flatpak

repository](https://github.com/flathub/org.gaphor.Gaphor/blob/master/share/org.gaphor.Gaphor.desktop).

Thank you so much for your effort in helping us keep it available in many

languages!







### ♿️ Code of Conduct

We value your participation and want everyone to have an enjoyable and

fulfilling experience. As a [GNOME Circle](https://circle.gnome.org/) project,

all participants are expected to follow the GNOME [Code of

Conduct](https://conduct.gnome.org) and to show respect,

understanding, and consideration to one another. Thank you for helping make this

a welcoming, friendly community for everyone.

## ©️ License

Copyright © The Gaphor Development Team

Licensed under the [Apache License v2](LICENSES/Apache-2.0.txt).

Summary: You can do what you like with Gaphor, as long as you include the

required notices. This permissive license contains a patent license from the

contributors of the code.