{"id":13613794,"url":"https://github.com/sarl/sarl","last_synced_at":"2026-01-24T21:07:11.120Z","repository":{"id":13652877,"uuid":"16346380","full_name":"sarl/sarl","owner":"sarl","description":"SARL Agent-Oriented Programming Language http://www.sarl.io","archived":false,"fork":false,"pushed_at":"2025-10-22T07:22:09.000Z","size":135476,"stargazers_count":149,"open_issues_count":41,"forks_count":47,"subscribers_count":12,"default_branch":"master","last_synced_at":"2026-01-14T17:10:02.864Z","etag":null,"topics":["agent","agent-based","agent-based-modeling","agent-teamwork","agents","dsl","framework","ide","java","linux","macox","programming-language","windows","xtext"],"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/sarl.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":"CONTRIBUTING.adoc","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-01-29T14:05:01.000Z","updated_at":"2026-01-01T19:32:54.000Z","dependencies_parsed_at":"2025-10-04T05:08:18.677Z","dependency_job_id":null,"html_url":"https://github.com/sarl/sarl","commit_stats":{"total_commits":3085,"total_committers":17,"mean_commits":"181.47058823529412","dds":"0.19319286871961106","last_synced_commit":"9cd4a32780775c8f8106875108a322c89535dc9c"},"previous_names":[],"tags_count":58,"template":false,"template_full_name":null,"purl":"pkg:github/sarl/sarl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarl%2Fsarl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarl%2Fsarl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarl%2Fsarl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarl%2Fsarl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sarl","download_url":"https://codeload.github.com/sarl/sarl/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarl%2Fsarl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28736815,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T19:23:36.361Z","status":"ssl_error","status_checked_at":"2026-01-24T19:23:28.966Z","response_time":89,"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":["agent","agent-based","agent-based-modeling","agent-teamwork","agents","dsl","framework","ide","java","linux","macox","programming-language","windows","xtext"],"created_at":"2024-08-01T20:00:53.691Z","updated_at":"2026-01-24T21:07:11.091Z","avatar_url":"https://github.com/sarl.png","language":"Java","readme":"= SARL Agent Programming Language\n:toc: right\n:toc-placement!:\n:hide-uri-scheme:\n\nimage:http://www.sarl.io/images/SARL-logo.png[width=100]\n\nSARL is a general-purpose agent-oriented language for implementing multi-agent systems, http://www.sarl.io.\n\nSARL aims at providing the fundamental abstractions for dealing with concurrency, distribution, interaction, decentralization, reactivity, autonomy and dynamic reconfiguration. \nThese high-level features are now considered as the major requirements for an easy and practical implementation of modern complex software applications. \nWe are convinced that the agent-oriented paradigm holds the keys to effectively meet this challenge.\n\nConsidering the variety of existing approaches and meta-models in the field of agent-oriented engineering and more generally multi-agent systems, our approach remains as generic as possible and highly extensible to easily integrate new concepts and features. The language is platform- and architecture-independent. \n\nHowever, we provide a first set of tools to support its execution based on the recent version 3.0 of the Janus platform (see http://www.sarl.io/runtime/janus/), but it can be linked with other existing agent platforms and frameworks. \n\nimage:http://www.sarl.io/docs/official/compilation/compilation_process.png[align=\"center\"]\n\n\nimage:https://img.shields.io/badge/documentation-API-ff69b4.svg?style=flat-square[link=http://www.sarl.io/docs/api/index.html]\nimage:https://img.shields.io/badge/documentation-reference-red.svg?style=flat-square[link=http://www.sarl.io/docs/official/index.html]\nimage:https://badges.gitter.im/sarl/Lobby.svg[link=https://gitter.im/sarl/Lobby]\n\n\nimage:https://img.shields.io/badge/requires-Java%2021-yellowgreen.svg?style=flat-square[link=https://www.java.com]\nimage:https://img.shields.io/badge/interoperable%20with-Java-yellowgreen.svg?style=flat-square[link=https://www.java.com]\nimage:https://img.shields.io/maven-central/v/io.sarl.sdk/sdk.svg?label=available%20on%20Maven%20Central[link=http://search.maven.org/#search%7Cga%7C1%7Cio.sarl]\nimage:https://img.shields.io/badge/build%20with-Maven-blue.svg?style=flat-square[link=http://maven.apache.org]\n\n\nimage:https://img.shields.io/badge/based%20on-Xtext-orange.svg?style=flat-square[link=https://eclipse.org/Xtext]\n\n\n\nimage:https://img.shields.io/github/license/sarl/sarl.svg?style=flat-square[link=https://opensource.org/licenses/Apache-2.0]\nimage:https://cla-assistant.io/readme/badge/sarl/sarl?style=flat-square[link=https://cla-assistant.io/sarl/sarl]\n\n\n\ntoc::[]\n\n== 1. Requirements\n\n* Java Development Toolkit (JDK) 21 or higher.\n\n== 2. Using SARL\n\n=== 2.1. Recommendations\n\nFor making your experience with SARL the best, we recommend you:\n\n* *to enable the assertions at development time with the `-ea` command line option that you could pass on the command-line or the Eclipse launch configurations.*\n\n=== 2.2. Use the stable version with Maven\n\nThe lastest stable version of SARL is available on link:http://search.maven.org/[Maven Central].\nConsequently, you could directly include the SARL module into the Maven dependencies of your project:\n\n```xml\n\t...\n\t\u003cdependency\u003e\n\t  \u003cgroupId\u003eio.sarl.sdk\u003c/groupId\u003e\n\t  \u003cartifactId\u003esdk\u003c/artifactId\u003e\n\t  \u003cversion\u003e0.15.1\u003c/version\u003e\n\t\u003c/dependency\u003e\n\t...\n```\n\nPlease, replace Version `0.15.1` in the previous snipset by the number of the version you want to use.\n\n=== 2.3. Use of the development version with Maven\n\nNew features, enhancements and bug fixes are available in the SNAPSHOT (development) version of SARL.\nFor using this version, you must add the Maven Repository Server of SARL in your pom file:\n\n```xml\n\t...\n\t\u003cdependencies\u003e\n\t  \u003cdependency\u003e\n\t    \u003cgroupId\u003eio.sarl.sdk\u003c/groupId\u003e\n\t    \u003cartifactId\u003esdk\u003c/artifactId\u003e\n\t    \u003cversion\u003e1.0.0-SNAPSHOT\u003c/version\u003e\n\t  \u003c/dependency\u003e\n\t\u003cdependencies\u003e\n\t...\n\t\u003crepositories\u003e\n\t  \u003crepository\u003e\n\t    \u003cid\u003eio.sarl-maven\u003c/id\u003e\n\t    \u003cname\u003eSARL Snapshots\u003c/name\u003e\n\t    \u003curl\u003ehttp://maven.sarl.io/\u003c/url\u003e\n\t  \u003c/repository\u003e\n\t\u003c/repositories\u003e\n\t\u003cpluginRepositories\u003e\n    \t  \u003cpluginRepository\u003e\n\t    \u003cid\u003eio.sarl-maven\u003c/id\u003e\n\t    \u003cname\u003eSARL Snapshots\u003c/name\u003e\n\t    \u003curl\u003ehttp://maven.sarl.io/\u003c/url\u003e\n\t    \u003csnapshots\u003e\n\t      \u003cenabled\u003etrue\u003c/enabled\u003e\n\t    \u003c/snapshots\u003e\n\t  \u003c/pluginRepository\u003e\n\t\u003c/pluginRepositories\u003e\n\t...\n```\n\n=== 2.4. Compile SARL code with Maven\n\nFor compiling SARL source files with Maven, you should use the provided plugin: `sarl-maven-plugin`.\nIt invokes the SARL and Java compilers with specific options.\nFor using the `sarl-maven-plugin`, you should add in your pom file:\n\n```xml\n\t...\n\t\u003cbuild\u003e\n\t  \u003cplugins\u003e\n\t    \u003cplugin\u003e\n\t      \u003cgroupId\u003eio.sarl.lang\u003c/groupId\u003e\n\t      \u003cartifactId\u003esarl-maven-plugin\u003c/artifactId\u003e\n\t      \u003cversion\u003e0.15.1\u003c/version\u003e\n\t      \u003cextensions\u003etrue\u003c/extensions\u003e\n\t      \u003cconfiguration\u003e\n\t        \u003csource\u003e21\u003c/source\u003e\n\t        \u003ctarget\u003e21\u003c/target\u003e\n\t        \u003cencoding\u003eUTF-8\u003c/encoding\u003e\n\t      \u003c/configuration\u003e\n\t    \u003c/plugin\u003e\n\t    ...\n\t  \u003c/plugins\u003e\n\t  ...\n\t\u003c/build\u003e\n\t...\n```\n\nPlease, replace Version `0.15.1` in the previous snipset by the number of the version you want to use.\n\nCAUTION: Do not forget to set the `extensions` flag to `true`.\n\n=== 2.5. Syntax highlighting with other tools\n\nSeveral style specifications are provided for syntax highlighting in third party tools.\nStyle specifications are provided for:\n\n* link:./sarl-lang/formatting-styles/textmate/sarl.tmLanguage[Atom] (TextMate language definition)\n* link:./sarl-lang/formatting-styles/source-highlight/sarl.lang[GNU source-highlight]\n* link:./sarl-lang/formatting-styles/prettify/lang-sarl.js[Google Prettify]\n* link:./sarl-lang/formatting-styles/gtk/sarl.lang[Gtk source view] (including gedit)\n* LaTeX:\n** LaTeX listing: link:./sarl-lang/formatting-styles/latex/sarl-listing.sty[monochrom], link:./sarl-lang/formatting-styles/latex/sarl-colorized-listing.sty[color]\n** link:./sarl-lang/formatting-styles/latex/sarl-beamer-listing.sty[LaTeX Beamer]\n* link:./sarl-lang/formatting-styles/pygments/sarlexer/sarl.py[Pygments]\n* link:./sarl-lang/formatting-styles/textmate/sarl.tmLanguage[Sublime Text] (TextMate language definition)\n* link:./sarl-lang/formatting-styles/textmate/sarl.tmLanguage[TextMate] (or link:./sarl-lang/formatting-styles/textmate/sarl.plist[plist definition]) \n* link:./sarl-lang/formatting-styles/vim/sarl.vim[Vim] \n\n== 3. Separated Sub-Projects\n\nThe SARL project is splitted into different sub-projects that may be compiled independently. Each project is dedicated to a specific set of features and tools. These sub-projects are:\n\n* link:./sarl-bom[sarl-bom]: Provide the Build-of-Material, i.e., a shared list of Maven dependency, for all the SARL sub-projects;\n* link:./sarl-baseutils[sarl-baseutils]: Set of Maven artifacts that are independent of SARL but needed to build the SARL artifacts;\n* link:./sarl-lang[sarl-lang]: Provides the language definition, the associated compiler (including the Maven plugin) and code formatting styles for different text editors;\n* link:./sarl-sdk[sarl-sdk]: Set of Maven artifacts that constitute the SDK for all the SARL developers;\n* link:./sarl-apputils[sarl-apputils]: Shared projects for building applications that are using a SARL compiler;\n* link:./sarl-sre[sarl-sre]: SARL runtime environment (or SARL virtual machine);\n* link:./sarl-docs[sarl-docs]: Tools and Doclet for the generation of the documentation, including the API documentation pages;\n* link:./sarl-cli[sarl-cli]: Set of command-line tools (sarlc, sarldoc, janus...);\n* link:./sarl-eclipse[sarl-eclipse]: Eclipse-based editor for SARL;\n* link:./sarl-officialdoc[sarl-officialdoc]: Markdown files of the official documentation of SARL.\n\n\n== 4. Issues\n\nIssues related to SARL are tracked on link:https://github.com/sarl/sarl/issues[GitHub]\nYou must use this issue tracker to report and follow your issues.\n\nAdditionally, you could have a look on the SARL developers' working plan on link:https://huboard.com/sarl/sarl[Huboard].\n\n== 5. Contributions\n\nAny contribution to the SARL is welcome.\nPlease read the link:./CONTRIBUTING.adoc[guidelines for contributors].\n\n== 6. Authors and Contributors\n\n* image:https://avatars.githubusercontent.com/klmp200[width=\"50px\",link=https://github.com/klmp200] Antoine BARTUCCIO, fireworks and Sierpinski fractal examples.\n* image:https://avatars.githubusercontent.com/Lomadriel[width=\"50px\",link=https://github.com/gb96] Gérôme BOULMIER, game of life example.\n* image:https://avatars.githubusercontent.com/gb96[width=\"50px\",link=https://github.com/gb96] Greg BOWERING, fixes for localization support within the fireworks example.\n* image:https://avatars.githubusercontent.com/m-ezzat[width=\"50px\",link=https://github.com/m-ezzat] Mohamed EZZAT, code cleaning and optimization.\n* image:https://avatars.githubusercontent.com/ThomasFarrenkopf[width=\"50px\",link=https://github.com/ThomasFarrenkopf] Thomas FARRENKOPF, documentation contributor.\n* image:https://avatars.githubusercontent.com/jgfoster[width=\"50px\",link=https://github.com/jgfoster] James FOSTER, documentation contributor.\n* image:https://avatars.githubusercontent.com/gallandarakhneorg[width=\"50px\",link=https://github.com/gallandarakhneorg] link:http://www.ciad-lab.fr/stephane_galland/[Stéphane GALLAND], founder, original and active author.\n* image:https://avatars.githubusercontent.com/ngaud[width=\"50px\",link=https://github.com/ngaud] link:http://www.ciad-lab.fr/nicolas_gaud/[Nicolas GAUD], founder, original and active author.\n* image:https://avatars.githubusercontent.com/jjst[width=\"50px\",link=https://github.com/jjst] Jeremie JOST, documentation contributor.\n* image:https://avatars.githubusercontent.com/alexandrelombard[width=\"50px\",link=https://github.com/alexandrelombard] link:http://www.ciad-lab.fr/alexandre_lombard/[Alexandre LOMBARD], active author.\n* image:https://avatars.githubusercontent.com/RyuzakiKK[width=\"50px\",link=https://github.com/RyuzakiKK] Ludovico de NITTIS, documentation contributor.\n* image:https://avatars.githubusercontent.com/pinam45[width=\"50px\",link=https://github.com/pinam45] Maxime PINARD, game of life example.\n* image:https://avatars.githubusercontent.com/tpiotrow[width=\"50px\",link=https://github.com/tpiotrow] Thomas PIOTROWSKI, maven configuration.\n* image:https://avatars.githubusercontent.com/srodriguez[width=\"50px\",link=https://github.com/srodriguez] link:http://www.sebastianrodriguez.com.ar[Sebastian RODRIGUEZ], founder, original and active author.\n* image:https://avatars.githubusercontent.com/ssardina[width=\"50px\",link=https://github.com/ssardina] Sebastian SARDINA, documentation contributor.\n* image:https://avatars.githubusercontent.com/stefanotedeschi[width=\"50px\",link=https://github.com/stefanotedeschi] Stefano TEDESCHI, contribution to the working memory library.\n\n\n== 7. License of SARL\n\nSARL is distributed under the link:./LICENSE[Apache v2 license], and is copyrigthed to the original authors and the other authors, as expressed in the link:./NOTICE[NOTICE].\n\n== 8. Success Stories\n\nSARL was successfully used by multiple projects. They are listed on the link:http://www.sarl.io/community/index.html[official SARL website].\n\n","funding_links":[],"categories":["Frameworks and libraries","SARL Frameworks","JVM语言"],"sub_categories":[":coffee: Java"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsarl%2Fsarl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsarl%2Fsarl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsarl%2Fsarl/lists"}