Before you start
It is recommended that users are familiar with the AgentSpeak programming language or the Jason interpreter. If you are not familiar with either of these, please read the article Getting Started with Jason to have a basic understanding of the programming language syntax and how agents operate.
Clone the repository
Download the source code or clone the git repository:
git clone https://github.com/embedded-bdi/embedded-bdi
Install the requirements
- OpenJDK (or Java SDK).
- C++11 compiler. g++ 4.9 or later is recommended, but other compilers are also supported.
- (Recommended) Doxygen for documentation generation.
- (Recommended) Graphviz for UML/chart support in documentation.
Build and run the example agent
The repository contains all the necessary files to run a “Hello world” agent. To compile and run the agent, execute the following:
make agent
./build/agent.out
The output should be:
Hello world!
I am an agent and I will keep running until I am terminated
Note that the agent is not terminated after executing the +!hello plan from the data/agentspeak.asl file. Instead, the agent keeps running its main reasoning cycle until it is terminated.
For more details on how agents can be programmed, see How It Works.
For Developers:
Install Development Tools
- Checking for memory leaks: Valgrind
- Generating documentation: Doxygen
- Generating graphs in documentation: Graphviz
(Optional) Install Eclipse CDT
Eclipse CDT can be used for development. To import the project into Eclipse, click on “File” -> “Import” -> “Existing Projects into Workspace.” Make sure to select the root embedded-bdi directory, so all projects are imported.
- Note: Launchers for the compiling and running the Agent and Unit Tests are already available in the project