<h1 align="center"><img src="https://github.com/gaphor/gaphor/blob/main/data/logos/gaphor-logo-full.svg?raw=true" alt="Gaphor - SysML/UML Modeling" height="96"/></h1>
[](https://github.com/gaphor/gaphor/actions/workflows/full-build.yml?query=branch%3Amain)
[](https://docs.gaphor.org)
[](https://pypi.org/project/gaphor)
[](https://pypistats.org/packages/gaphor)
[](https://github.com/gaphor/gaphor/blob/main/CONTRIBUTORS.md)
[](https://app.element.io/#/room/#gaphor_Lobby:gitter.im)
[](https://codeclimate.com/github/gaphor/gaphor/maintainability)
[](https://codeclimate.com/github/gaphor/gaphor/test_coverage)
[](https://hosted.weblate.org/engage/gaphor)
[](https://www.bestpractices.dev/projects/9512)
[](https://github.com/RichardLitt/standard-readme)
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.
<img alt="Gaphor Demo" src="https://raw.githubusercontent.com/gaphor/gaphor/main/docs/images/gaphor-demo.gif" style="display: block; margin: 2em auto">
## đ 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
<a href='https://flathub.org/apps/org.gaphor.Gaphor'><img alt='Download on Flathub' title='Download on Flathub' src='https://flathub.org/api/badge?svg&locale=en'/></a>
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
Over 150 people that helped out building Gaphor. Too many to show in this readme.
You can find them in [CONTRIBUTORS file](CONTRIBUTORS.md).
Would you like to contribute to the development of Gaphor?
There are many ways in which you can help out:
* Review and update documentation.
* Open discussions on a feature/bug/idea
* Fix an [open issue](https://github.com/gaphor/gaphor/issues)
* Tell other people about Gaphor.
We appreciate contributions of any kind.
This project follows the
[all-contributors](https://github.com/kentcdodds/all-contributors)
specification. Contributions of any kind are welcome!
More info on how you can contribute can be found in [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!
<a href="https://hosted.weblate.org/engage/gaphor/">
<img src="https://hosted.weblate.org/widgets/gaphor/-/glossary/multi-auto.svg" alt="Translation status" />
</a>
### âŋī¸ 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.
Raw data
{
"_id": null,
"home_page": "https://gaphor.org/",
"name": "gaphor",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.11",
"maintainer_email": null,
"keywords": "GTK, diagram, UML, MBSE, modeling",
"author": "Arjan Molenaar",
"author_email": "gaphor@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/34/42/1924e15468f5152f16eaf19d4eb39a672b4e9f160666bef4c71ae740846c/gaphor-2.27.0.tar.gz",
"platform": null,
"description": "<h1 align=\"center\"><img src=\"https://github.com/gaphor/gaphor/blob/main/data/logos/gaphor-logo-full.svg?raw=true\" alt=\"Gaphor - SysML/UML Modeling\" height=\"96\"/></h1>\n\n[](https://github.com/gaphor/gaphor/actions/workflows/full-build.yml?query=branch%3Amain)\n[](https://docs.gaphor.org)\n[](https://pypi.org/project/gaphor)\n[](https://pypistats.org/packages/gaphor)\n[](https://github.com/gaphor/gaphor/blob/main/CONTRIBUTORS.md)\n[](https://app.element.io/#/room/#gaphor_Lobby:gitter.im)\n\n[](https://codeclimate.com/github/gaphor/gaphor/maintainability)\n[](https://codeclimate.com/github/gaphor/gaphor/test_coverage)\n[](https://hosted.weblate.org/engage/gaphor)\n[](https://www.bestpractices.dev/projects/9512)\n[](https://github.com/RichardLitt/standard-readme)\n\n\nGaphor is a UML and SysML modeling application written in Python.\nIt 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.\n\n<img alt=\"Gaphor Demo\" src=\"https://raw.githubusercontent.com/gaphor/gaphor/main/docs/images/gaphor-demo.gif\" style=\"display: block; margin: 2em auto\">\n\n## \ud83d\udcd1 Table of Contents\n\n- [\ud83d\udcd1 Table of Contents](#-table-of-contents)\n- [\ud83d\udcdc Background](#-background)\n- [\ud83d\udcbe Install](#-install)\n- [\ud83d\udd26 Usage](#-usage)\n- [\u2665 Contributing](#-contributing)\n - [\ud83c\udf0d Translations](#-translations)\n - [\u267f\ufe0f Code of Conduct](#\ufe0f-code-of-conduct)\n- [\u00a9\ufe0f License](#\ufe0f-license)\n\n## \ud83d\udcdc Background\n\nGaphor is a UML and SysML modeling application written in Python. We designed\nit to be easy to use, while still being powerful. Gaphor implements a\nfully-compliant UML 2 data model, so it is much more than a picture drawing\ntool. You can use Gaphor to quickly visualize different aspects of a system as\nwell as create complete, highly complex models.\n\nGaphor is designed around the following principles:\n\n- Simplicity: The application should be easy to use. Only some basic knowledge of UML or SysML is required.\n- Consistency: UML is a graphical modeling language, so all modeling is done in a diagram.\n- Workability: The application should not bother the user every time they do something non-UML-ish.\n\nGaphor is a GUI application. It has a modern [GTK](https://gtk.org)-based interface and uses\n[Cairo](https://www.cairographics.org/) for consistent rendering.\n\nGaphor is a library.\nYou can use it from [scripts and Jupyter notebooks](https://docs.gaphor.org/en/latest/scripting.html)\nand interact with models programmatically.\n\nNon-Goals:\n\n- 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.\n- Generating source code from diagrams or creating other concrete executable artifacts including use of fUML or ALF.\n\nAlthough it would be possible to incorporate these features, these aren't the\ngoals of this project. However, if these are important capabilities for you,\nyou may be able to extend Gaphor by creating a\n[plugin](https://docs.gaphor.org/en/latest/service_oriented.html#example-plugin).\n\n## \ud83d\udcbe Install\n\n<a href='https://flathub.org/apps/org.gaphor.Gaphor'><img alt='Download on Flathub' title='Download on Flathub' src='https://flathub.org/api/badge?svg&locale=en'/></a>\n\nYou can find [the latest version](https://gaphor.org/download) on the\n[gaphor.org website](https://gaphor.org/download). Gaphor ships installers for\nmacOS and Windows. Those can be found there. The Python package is also\n[available on PyPI](https://pypi.org/project/gaphor/).\n\nAll releases are available on\n[GitHub](https://github.com/gaphor/gaphor/releases/).\n\nIf you want to start developing on Gaphor, have a look at the [Installation\nsection of our documentation](https://docs.gaphor.org/en/latest/).\n\n## \ud83d\udd26 Usage\n\nIf using Gaphor for the first time you will be presented with a greeter dialog\nat startup in which you can select one of 5 models available to you to work in:\n- **Generic:** (or blank) template\n- **UML:** *Unified Modeling Language* template\n- **SysML:** *Systems Modeling Language* template\n- **RAAML:** *Risk Analysis and Assessment Modeling language* template\n- **C4 Model:** *a lean graphical notation technique for modelling the architecture of software systems* template\n\nAfter you select a template, the main Gaphor window will load, and you will be\nready to start modeling. Gaphor will automatically select the correct profile\nbased on the template that you selected, but you can also select other modeling\nprofiles if needed by clicking on the button next to the Profile dropdown menu\nat the top of your window.\n\nTo select an element you want to place, for example a Class, click on the icon\nin the Toolbox and then again on the diagram. This will place a new Class item\non the diagram and add a new Class to the model (it shows up in the\n[Model Browser](https://docs.gaphor.org/en/latest/getting_started.html#model-browser)).\n\nPortions of the toolbox may also be collapsed depending on the type of diagram\nyou are modeling with. You can expand the collapsed portions of the toolbox if\nneeded.\n\nIf you want to know more, please read our documentation on https://docs.gaphor.org.\n\n## \u2665 Contributing\n\nOver 150 people that helped out building Gaphor. Too many to show in this readme.\nYou can find them in [CONTRIBUTORS file](CONTRIBUTORS.md).\n\nWould you like to contribute to the development of Gaphor?\nThere are many ways in which you can help out:\n\n* Review and update documentation.\n* Open discussions on a feature/bug/idea\n* Fix an [open issue](https://github.com/gaphor/gaphor/issues)\n* Tell other people about Gaphor.\n\nWe appreciate contributions of any kind.\nThis project follows the\n[all-contributors](https://github.com/kentcdodds/all-contributors)\nspecification. Contributions of any kind are welcome!\n\nMore info on how you can contribute can be found in [the contributing guide](CONTRIBUTING.md)!\n\n### \ud83c\udf0d Translations\n\nTranslation of Gaphor is mostly done using\n[Weblate](https://hosted.weblate.org/projects/gaphor/gaphor/).\n\nFor the Linux Flatpak, the desktop entry comment string can be translated at our\n[Flatpak\nrepository](https://github.com/flathub/org.gaphor.Gaphor/blob/master/share/org.gaphor.Gaphor.desktop).\n\nThank you so much for your effort in helping us keep it available in many\nlanguages!\n\n<a href=\"https://hosted.weblate.org/engage/gaphor/\">\n<img src=\"https://hosted.weblate.org/widgets/gaphor/-/glossary/multi-auto.svg\" alt=\"Translation status\" />\n</a>\n\n### \u267f\ufe0f Code of Conduct\n\nWe value your participation and want everyone to have an enjoyable and\nfulfilling experience. As a [GNOME Circle](https://circle.gnome.org/) project,\nall participants are expected to follow the GNOME [Code of\nConduct](https://conduct.gnome.org) and to show respect,\nunderstanding, and consideration to one another. Thank you for helping make this\na welcoming, friendly community for everyone.\n\n## \u00a9\ufe0f License\n\nCopyright \u00a9 The Gaphor Development Team\n\nLicensed under the [Apache License v2](LICENSES/Apache-2.0.txt).\n\nSummary: You can do what you like with Gaphor, as long as you include the\nrequired notices. This permissive license contains a patent license from the\ncontributors of the code.\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Gaphor is the simple modeling tool written in Python.",
"version": "2.27.0",
"project_urls": {
"Documentation": "https://docs.gaphor.org/",
"Homepage": "https://gaphor.org/",
"Repository": "https://github.com/gaphor/gaphor"
},
"split_keywords": [
"gtk",
" diagram",
" uml",
" mbse",
" modeling"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "320fd80970d9aa319826562a05f05ca991054ff91c3682d205aff24f671a77c3",
"md5": "4a0b232be6824ed95a9c28eda3ea4106",
"sha256": "54c825327c6f2b019f88b16bf2537ba849366ea4dce9ee56848b562973bdc77a"
},
"downloads": -1,
"filename": "gaphor-2.27.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4a0b232be6824ed95a9c28eda3ea4106",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.11",
"size": 888830,
"upload_time": "2024-10-09T00:28:12",
"upload_time_iso_8601": "2024-10-09T00:28:12.730834Z",
"url": "https://files.pythonhosted.org/packages/32/0f/d80970d9aa319826562a05f05ca991054ff91c3682d205aff24f671a77c3/gaphor-2.27.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "34421924e15468f5152f16eaf19d4eb39a672b4e9f160666bef4c71ae740846c",
"md5": "3f175452bae03fee4618bec5684d1f6a",
"sha256": "32c6c478ea29e8eb2ad879fa0a4a2bb17b7cfdb4d8fff4075bfb8297414450de"
},
"downloads": -1,
"filename": "gaphor-2.27.0.tar.gz",
"has_sig": false,
"md5_digest": "3f175452bae03fee4618bec5684d1f6a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.11",
"size": 640367,
"upload_time": "2024-10-09T00:28:14",
"upload_time_iso_8601": "2024-10-09T00:28:14.672539Z",
"url": "https://files.pythonhosted.org/packages/34/42/1924e15468f5152f16eaf19d4eb39a672b4e9f160666bef4c71ae740846c/gaphor-2.27.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-09 00:28:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gaphor",
"github_project": "gaphor",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "gaphor"
}
JSON
