{"id":19436530,"url":"https://github.com/researchstudio-sat/bot-skeleton","last_synced_at":"2025-04-24T21:31:20.454Z","repository":{"id":46949342,"uuid":"207567084","full_name":"researchstudio-sat/bot-skeleton","owner":"researchstudio-sat","description":"Bot Skeleton for Hackathon","archived":false,"fork":false,"pushed_at":"2022-12-10T03:28:19.000Z","size":96,"stargazers_count":1,"open_issues_count":6,"forks_count":6,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-22T19:08:20.480Z","etag":null,"topics":["bot","won-bot"],"latest_commit_sha":null,"homepage":"","language":"Java","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/researchstudio-sat.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}},"created_at":"2019-09-10T13:28:23.000Z","updated_at":"2020-02-18T12:49:07.000Z","dependencies_parsed_at":"2023-01-26T01:45:41.094Z","dependency_job_id":null,"html_url":"https://github.com/researchstudio-sat/bot-skeleton","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/researchstudio-sat%2Fbot-skeleton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/researchstudio-sat%2Fbot-skeleton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/researchstudio-sat%2Fbot-skeleton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/researchstudio-sat%2Fbot-skeleton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/researchstudio-sat","download_url":"https://codeload.github.com/researchstudio-sat/bot-skeleton/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250712925,"owners_count":21475104,"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":["bot","won-bot"],"created_at":"2024-11-10T15:11:40.149Z","updated_at":"2025-04-24T21:31:20.219Z","avatar_url":"https://github.com/researchstudio-sat.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Web of Needs Bot Skeleton\n\nThis skeleton contains a bot that creates a Service Atom that one can connect to. \nFor each atom that has been created on the configured node(s), the bot sends a message with the atomUri of the created Atom to everyone that is connected to the Service Atom.\n\nThe Bot Skeleton is a [Spring Boot Application](https://docs.spring.io/spring-boot/docs/current/reference/html/using-boot-running-your-application.html).\n\n## Running the bot\n\n### Prerequisites\n\n- [Openjdk 8](https://adoptopenjdk.net/index.html) - the method described here does **not work** with the Oracle 8 JDK!\n- Maven framework set up\n- Use this repository as a template (green button in github GUI), fork it, or clone it.\n\n### On the command line\n\n```\ncd bot-skeleton\nexport WON_NODE_URI=\"https://hackathonnode.matchat.org/won\"\nmvn clean package\njava -jar target/bot.jar\n```\nNow go to [What's new](https://hackathon.matchat.org/owner/#!/overview) to find your bot, connect and [create an atom](https://hackathon.matchat.org/owner/#!/create) to see the bot in action.\n\n### In Intellij Idea\n1. Create a run configuration for the class `won.bot.skeleton.SkeletonBotApp`\n2. Add the environment variables\n\n  * `WON_NODE_URI` pointing to your node uri (e.g. `https://hackathonnode.matchat.org/won` without quotes)\n  \n  to your run configuration.\n  \n3. Run your configuration\n\nIf you get a message indicating your keysize is restricted on startup (`JCE unlimited strength encryption policy is not enabled, WoN applications will not work. Please consult the setup guide.`), refer to [Enabling Unlimited Strength Jurisdiction Policy](https://github.com/open-eid/cdoc4j/wiki/Enabling-Unlimited-Strength-Jurisdiction-Policy) to increase the allowed key size.\n\n##### Optional Parameters for both Run Configurations:\n- `WON_KEYSTORE_DIR` path to folder where `bot-keys.jks` and `owner-trusted-certs.jks` are stored (needs write access and folder must exist) \n\n## Start coding\n\nOnce the skeleton bot is running, you can use it as a base for implementing your own application. \n- Add/edit config files in `src/main/resources`\n- Follow the [Mini HowTos](https://github.com/researchstudio-sat/webofneeds/tree/master/documentation/howto/README.md). \n\nFor an introduction to the Web of Needs Bot framework, have a look at the [Bot Readme](https://github.com/researchstudio-sat/webofneeds/blob/master/webofneeds/won-bot/README.md).\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresearchstudio-sat%2Fbot-skeleton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fresearchstudio-sat%2Fbot-skeleton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresearchstudio-sat%2Fbot-skeleton/lists"}