{"id":43803352,"url":"https://github.com/woped/p2t","last_synced_at":"2026-02-05T22:10:23.953Z","repository":{"id":38007729,"uuid":"264865714","full_name":"woped/p2t","owner":"woped","description":"Process to text transformation web service","archived":false,"fork":false,"pushed_at":"2026-01-26T07:01:21.000Z","size":255704,"stargazers_count":4,"open_issues_count":7,"forks_count":12,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-02-02T12:50:04.275Z","etag":null,"topics":["docker","java"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/woped.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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,"zenodo":null}},"created_at":"2020-05-18T07:45:04.000Z","updated_at":"2025-10-11T15:50:49.000Z","dependencies_parsed_at":"2025-06-27T09:32:19.779Z","dependency_job_id":null,"html_url":"https://github.com/woped/p2t","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/woped/p2t","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woped%2Fp2t","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woped%2Fp2t/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woped%2Fp2t/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woped%2Fp2t/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/woped","download_url":"https://codeload.github.com/woped/p2t/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woped%2Fp2t/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29136149,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T21:59:57.939Z","status":"ssl_error","status_checked_at":"2026-02-05T21:59:57.628Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["docker","java"],"created_at":"2026-02-05T22:10:23.303Z","updated_at":"2026-02-05T22:10:23.936Z","avatar_url":"https://github.com/woped.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Process to Text (P2T)\n\nThis webservice is used to translate a petrinet into plain text.\n\n# Live demo\n\n| URL                                             | Description | \n|-------------------------------------------------|:-----------:|\n| https://woped.dhbw-karlsruhe.de/p2t/            | Embedded UI |\n| https://woped.dhbw-karlsruhe.de/p2t/swagger-ui/ | Swagger UI  |\n\n# Related repositories\n\n| URL                               |       Description       |\n|-----------------------------------|:-----------------------:|\n| https://github.com/tfreytag/T2P   | Text2Process Webservice |\n| https://github.com/tfreytag/WoPeD |      WoPeD-Client       |\n\n# Resources\n\n| URL                                         | Description |\n|---------------------------------------------|:-----------:|\n| https://hub.docker.com/r/woped/process2text | Docker Hub  |\n\n# Requirements for development\n\n* IDE of your choice\n* Java 11\n\n# Configuration guide\n\n_It is recommended to use IntelliJ IDE._\n\n1. Git clone this project onto your machine.\n2. Start IntelliJ and open the project.\n3. Wait until all files have been loaded.\n4. Run Application with the Start-Button or with `mvn spring-boot:run`\n\nAfter cloning this repository, it's essential to [set up git hooks](https://github.com/woped/woped-git-hooks/blob/main/README.md#activating-git-hooks-after-cloning-a-repository) to ensure project standards.\n\n# Testing\n\n### Testing via Swagger UI\n\n1. Start the application.\n2. Navigate to `http://localhost:8080/p2t/swagger-ui.`\n3. Paste your petrinet (the content of the xml file) in the body of the `POST /p2t/generateText` endpoint.\n\n### Testing via the embedded GUI\n\n1. Start the application.\n2. Navigate to `http://localhost:8080/p2t/`.\n3. Paste your petrinet (the content of the xml file) in the first text area and submit the form.\n\n### Testing with Postman\n\n1. Add a new collection in Postman.\n2. Add a new request in your created collection.\n3. For your request change `Get` to `Post`.\n4. Enter URL `http://localhost:8080/p2t/generateText`\n5. Open the body configuration and choose `raw`.\n6. Copy the content of a `.pnml` file (must be a sound petrinet) in the body of the request.\n7. Click send button\n\n### Testing via the WoPeD-Client\n\n1. Start the application.\n2. Follow the installation instructions of the WoPeD-Client (`https://github.com/tfreytag/WoPeD`).\n3. Start WoPeD-Client and.\n4. Open the configuration and navigate to `NLP Tools`. Adapt the `Process2Text` configuration:\n    - `Server host`: `localhost`\n    - `Port`: `8080`\n    - `URI`: `/p2t`\n5. Test your configuration.\n6. Close the configuration and import or create a new petrinet.\n7. Navigate to `Analyse` -\u003e `Translate to text` and execute. The petrinet will now be transformed by your locally\n   started P2T webservice.\n\n# Hosting the webservice yourself\n\n### Option 1: Use our pre-build docker image\n\n1. Pull our pre-build docker image from docker hub (see above).\n2. Run this image on your server.\n\n### Option 2: Build the docker image yourself\n\n1. Build your own docker image with the Dockerfile.\n2. Run this image on your server.\n\n# Dependencies\nThis repository uses jars that are unavailable on Maven central. Hence, these jar files are stored in this repository in\nthe folder `lib`. The chosen procedure was described in this [SO answer](https://stackoverflow.com/a/51647143/11711692).\n\n# Formatting\nTo check the formatting of all Java files, run `mvn spotless:check`. \u003cbr\u003e\nIf formatting are identified, run `mvn spotless:apply` to automatically reformat that affected files.\n\n# Recommended High-Resource-Models\nWorking with BPMN or PNML files often involves handling unexpectedly large file sizes. Due to the limited context length of many language models, we recommend choosing a model with sufficient context length to ensure reliable and complete processing.\n\n## OpenAI\n  - GPT-4 Turbo (128k context)\n  - GPT-4 (8k or 32k context)\n  - GPT-3.5 Turbo (16k context)\n\n## Gemini\n  - Gemini 1.5 Pro (1M+ context)\n\n# LM Studio Integration\n\n## LM Studio Setup\n\n1. **Download LM Studio**:\n   - Visit the official [LM Studio website](https://lmstudio.ai/) and download the latest version for your operating system.\n   - Alternatively, you can download LM Studio from [GitHub](https://github.com/lmstudio-ai).\n\n2. **Install and launch LM Studio**:\n   - Run the downloaded installation file and follow the instructions.\n   - Launch LM Studio after installation.\n\n3. **Download and load a model**:\n   - In LM Studio, navigate to the \"Models\" section.\n   - Choose a model to download or import an already downloaded model.\n      \u003cbr\u003e\n      \u003cimg src=\"docs/images/Bildschirmfoto%202025-06-27%20um%2011.26.43.png\" alt=\"LM Studio Model Selection\" width=\"400\"/\u003e\n   - WoPeD should work with most models from LM Studio. The following 4 models have been extensively tested and can be recommended: `llama-3.2-1b-instruct`, `mistral-7b-instruct`, `meta-llama-3.1-8b-instruct`, and `gemma-2-9b-it`. For a detailed comparison of these models, please see the [Model Comparison](docs/pdf/Vergleich%20Modelle%20LM%20Studio.pdf).\n\n   - Ensure the context length is set correctly, 10 000 tokens suits most cases, then load the model.\n      \u003cbr\u003e\n      \u003cimg src=\"docs/images/Bildschirmfoto%202025-06-27%20um%2011.21.19.png\" alt=\"LM Studio Model Download\" width=\"400\"/\u003e\n   - Start the local server with the loaded model by clicking \"Start Server\".\n\n4. **Verify the server is running**:\n   - The LM Studio server should be running on `http://localhost:1234` by default.\n      \u003cbr\u003e\n      \u003cimg src=\"docs/images/Bildschirmfoto%202025-06-27%20um%2011.28.55.png\" alt=\"LM Studio Model Download\" width=\"400\"/\u003e\n   - You can test the API availability by accessing `http://localhost:1234/v1/models` in your browser.\n\n\n## Using with WoPeD\n\n1. **Configure the web client**:\n   - Start this P2T service and for example the web client.\n   - Navigate to \"P2T (Process2Text)\".\n   - Select \"lmStudio\" as the provider.\n   - No API key is needed for LM Studio since it runs locally.\n\n2. **Use Process2Text with LM Studio**:\n   - Select \"lmStudio\" as the provider.\n   - Choose the desired model from the dropdown list.\n   - Execute the translation.\n\n3. **Troubleshooting**:\n   - Ensure the LM Studio server is running before starting a translation.\n   - If no models are displayed, verify that LM Studio was started correctly and a model is loaded.\n   - For connection issues, check if the default URL `http://localhost:1234` is accessible.\nIf formatting are identified, run `mvn spotless:apply` to automatically reformat that affected files. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoped%2Fp2t","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwoped%2Fp2t","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoped%2Fp2t/lists"}