dmjimenezbravo / MASChat

A simple multi-agent chat implementation. This is an example for the Intelligent Systems subject of the Computer Engineering degree at the Polytechnic University of Madrid (Spain).

MAS Chat

A simple multi-agent chat implementation.
Explore the docs »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. About the MAS
4. Usage
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

A simple multi-agent chat implementation. This is an example for the "Sistemas Inteligentes" ("Intelligent Systems") subject of the "Grado en Ingeniería Informática" ("Degree in Computer Engineering") degree at the Universidad Politécnica de Madrid (UPM) (Spain).

(back to top)

Built With

• Java.
• JADE.

(back to top)

Getting Started

This project has been developed with the Eclipse IDE and Java. Therefore, for the execution of the project we are going to assume that both softwares are installed on the machine.

(back to top)

Prerequisites

• Java.
• Eclipse IDE.

Although the use of the Eclipse IDE is recommended, any other Java development environment can be used.

(back to top)

Installation

To install and test the project, follow these steps:

1. You need to download this repository and import the project into your IDE.
2. Download and import the JADE librarie for Java into your project.
3. Configure the execution of the project, for this in our ide we must specify that the main class of the project is jade.Boot. In addition to configure each one of the agents of our MAS it is necessary to include the following arguments to our execution, -gui UserAgent1:es.upm.si.masChat.UserAgent;UserAgent2:es.upm.si.masChat.UserAgent. Note that more UserAgent can be included.

(back to top)

About the MAS

Here we present the Multi-Agent System (MAS) proposed for this platform. The system is composed of one agent:

• User agent: it is in charge of interacting with the user and sending the messages to the rest of user agents.

The interactions and exchange of messages in the defined platform are shown below.

(back to top)

Usage

When the project is executed, the following screen is displayed (one per every configured user agent):

This screen allows you to write, send and display the sended and recieved messages.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the GNU General Public License v3.0. See LICENSE for more information.

(back to top)

Contact

Diego M. Jiménez Bravo - @dmjimenezbravo - [e-mail]

Project Link: https://github.com/dmjimenezbravo/MASChat

(back to top)

Acknowledgments

• JADE, Java Agent DEvelopment Framework.

(back to top)