{"id":23107962,"url":"https://github.com/bigraph-toolkit-suite/bigraphs.ide.bigellor","last_synced_at":"2026-04-30T00:02:24.808Z","repository":{"id":267702224,"uuid":"711926054","full_name":"bigraph-toolkit-suite/bigraphs.ide.bigellor","owner":"bigraph-toolkit-suite","description":"Bigellor is a web-based editor for the visual modeling of bigraphs.","archived":false,"fork":false,"pushed_at":"2024-12-12T09:20:34.000Z","size":1196,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-09T10:41:56.275Z","etag":null,"topics":["bigraphs","modeling","spring","visualisation"],"latest_commit_sha":null,"homepage":"https://www.bigraphs.org/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bigraph-toolkit-suite.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-30T13:03:32.000Z","updated_at":"2024-12-12T09:19:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"bb3c8a16-3c8f-4c30-ac7c-1915b37a57bf","html_url":"https://github.com/bigraph-toolkit-suite/bigraphs.ide.bigellor","commit_stats":null,"previous_names":["bigraph-toolkit-suite/bigraphs.ide.bigellor"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigraph-toolkit-suite%2Fbigraphs.ide.bigellor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigraph-toolkit-suite%2Fbigraphs.ide.bigellor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigraph-toolkit-suite%2Fbigraphs.ide.bigellor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigraph-toolkit-suite%2Fbigraphs.ide.bigellor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigraph-toolkit-suite","download_url":"https://codeload.github.com/bigraph-toolkit-suite/bigraphs.ide.bigellor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247092373,"owners_count":20882217,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bigraphs","modeling","spring","visualisation"],"created_at":"2024-12-17T01:16:39.760Z","updated_at":"2026-04-30T00:02:24.803Z","avatar_url":"https://github.com/bigraph-toolkit-suite.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"etc/icon.png\" style=\"zoom:90%;\" /\u003e\n\n\u003e Latest Version: **2.2.0**\n\n- ✅ For Users: See [Docker](#docker-container) for how to install and run the application as a container.\n- 🧑‍💻 For Developers: See [Building from Source](#building-from-source) if you want to build and run Bigellor locally.\n\n---- \n\n# Bigellor\n\n**Bigellor** is a web-based modelling tool to graphically create and visualize bigraphs.\n\nThe underlying web development framework of **Bigellor** is a combination of [Spring framework](https://spring.io) and [Thymeleaf](https://www.thymeleaf.org/),  \nand [Cytoscape.js](https://js.cytoscape.org/) for the visualization of bigraphs in the browser.\n\n## Screenshots\n\n![Bigraph Diagram Editor](etc/bigraph-editor.png \"Bigraph Diagram Editor\")\n\n![Bigraph Diagram Editor](etc/manage-signatures.png \"Bigraph Diagram Editor\")\n\n## Getting Started\n\n\n\n### Docker Container\n\nBuild the image:\n\n```shell\n$ docker build -t bigellor-app .\n```\n\nRun the container:\n\n```shell\n$ docker run -p 8080:8080 bigellor-app\n```\n\nThen, just open the web browser and navigate to \n- [`http://localhost:8080`](http://localhost:8080).\n\n**Optional: Change App Port**\n\nIf you want the app to run on a different port (e.g. 9090), you need execute:\n\n```shell\n$ docker run -p 9090:9090 \\\n-e \"SPRING_APPLICATION_JSON={\\\"server.port\\\":9090}\" \\\nbigellor-app\n```\n\n### Building from Source\n\n**Requirements**\n\n- Java == 17\n- Maven \u003e= 3.8.3\n\n**Building the App**\n\nThe following command must be executed from the root directory of this project:\n```shell\n$ mvn clean package -DskipTests\n```\n\nAfter the command successfully finishes, the executable application can be found in the directory `dist/`\nfrom the root of this project.\n\n### Starting Bigellor\n\n\u003e **Note:** Ensure that there is read/write permission on the directory, where **Bigellor** is started.\n\nAfter the build process is successfully finished, you can start **Bigellor**.\n\nTherefore, execute the following commands:\n```shell\n$ cd ./dist/\n$ java -jar bigellor-starter-*-exec.jar\n\n```\n\nThen, just open the web browser and navigate to [`http://localhost:8080`](http://localhost:8080).\n\nThe correct server name and port will be displayed in the console if defaults were changed.\n\n#### Arguments to Configure\n\nProperties can be configured when starting **Bigellor** in the following way:\n```shell\n$ java -jar bigellor-starter-VERSION-exec.jar --PROPERTY=VALUE --PROPERTY2=VALUE2 ...\n```\n\n| Property                          | Description                                                                                                                                               |\n|-----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `bigellor.gen-test-data`          | (Optional) `true` or `false`. If `true` then a demo signature will be provided in `data/signatures/` and available in the IDE.                            |\n| `bigellor.model.storage.location` | (Optional) A relative folder path. It denotes the storage directory for all user-uploaded model files in Bigellor.                                        |\n| `server.port`                     | (Optional) A port number. This determines the server port of Bigellor. Default is `8080`.                                                                 |\n| `bigellor.cdo.config`             | (Optional) A relative folder path to the Eclipse CDO database configuration file (usually located at `config/cdo-server.xml`). A default one is provided. |\n\n### Database Configuration\n\n[Eclipse CDO](https://projects.eclipse.org/projects/modeling.emf.cdo) is used as database for all bigraphical model files.\n(Note that the model files are currently also persisted on the filesystem.)\nThe server boots in the background when Bigellor is started; the database uses the folder `data/` relative to the application for persistence.\nTo access Eclipse CDO in Bigellor conveniently the Spring-way (via repositories), the framework [Spring Data CDO](https://github.com/bigraph-toolkit-suite/spring-data-cdo) is used.\n\nAn example of the default database configuration properties can be found here: `src/main/resources/config/cdo-server.xml`.\nWhen Bigellor is build from source, the application can be found in the `dist/` folder from the root of this project.\nIncluded is also the `config/cdo-server.xml`, which can be configured afterward.\n\nUse Eclipse CDO Explorer to view and modify the bigraphs directly in the database.\nYou can download the CDO Explorer via the [Eclipse Installer](https://www.eclipse.org/downloads/packages/installer).\nUse Eclipse Version 2022-12 (4.26.0), which supports CDO protocol version **48**.\n\n## Build Problems and Solutions\n\nIn case you are getting an error while building the project similar to\n```\nFatal error compiling: error: invalid target release: 17\n```\ncheck the JDK for Maven with `mvn --version`:\n```shell\n$ mvn --version\nApache Maven 3.9.5\nMaven home: /opt/maven\nJava version: 11.0.20.1\n```\n\nIn this example, Maven version 3.9.5 uses the JDK 11.\nHowever, JDK 17 is required for this project (see [Requirements](#Getting-Started)).\nIt helps to correct the `JAVA_HOME` environment variable.\n\n## Acknowledgement\n\nThanks to Simon Tobies for his contributions to the visualization and modeling backend of Bigellor.\n\n## License\n\n**Bigellor** is Open Source software released under the Apache 2.0 license.\n\n```text\n   Copyright 2023-present Bigraph Toolkit Developers\n\n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n https://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigraph-toolkit-suite%2Fbigraphs.ide.bigellor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigraph-toolkit-suite%2Fbigraphs.ide.bigellor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigraph-toolkit-suite%2Fbigraphs.ide.bigellor/lists"}