Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/MircoT/AI-Project-PlannerEnvironment
An environment to test a planner agent, created for a college course.
https://github.com/MircoT/AI-Project-PlannerEnvironment
Last synced: 3 days ago
JSON representation
An environment to test a planner agent, created for a college course.
- Host: GitHub
- URL: https://github.com/MircoT/AI-Project-PlannerEnvironment
- Owner: MircoT
- License: mit
- Created: 2014-04-27T20:55:19.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2014-06-12T12:31:19.000Z (over 10 years ago)
- Last Synced: 2024-04-14T18:38:23.524Z (9 months ago)
- Language: Python
- Size: 884 KB
- Stars: 3
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome_ai_agents - Ai-Project-Plannerenvironment - An environment to test a planner agent, created for a college course. (Building / Testing)
README
AI-Project-PlannerEnvironment
=============================
An environment to test a planner agent, created for a college project and based on a problem from "Artificial Intelligence: A Modern Approach" by Stuart Russell and Peter Norvig.
## Dependencies
All you need is python. This module is tested on python 2.7.5 and 3.3.2.
## Run the application
You can create your Agent in the *agents_dir*, like MyAgent example. The name of the file must be the same
of the class that you create. The class must *inherit from LogAgent* and you have to implement the
method *solve*.
You can put your configuration file in *cfg_dir*. These files must be with json extension and they must respect
the sintax of the environment, like in the examples that you can see in this directory.
To run the application simply execute the main.py file:
```bash
python main.py [-c cfg_list] [-a agents_list]
```
**NOTE**:
* cfg_list is a list of configuration files names.
* agents_list is a list of agents names.
*Example*:
```bash
python main.py -c testconfig_simple.json testconfig.json -a MyAgent
```
##Generating random maps
This module comes with a handy random map generator. The sysntax to use it is as follows:
```bash
python cfg_generator.py config_file_name num_airports num_airplanes num_boxes min_num_of_goals
```
This command will create a `config_file_name.json` file under `\cfg_dir`. There is no need to
add .json at the end of the file name.
Please note that `cfg_generator.py` will always overwrite files with the same name you enter.
## Contributing
Contributions are welcome, so please feel free to fix bugs, improve things, provide documentation.
For anything submit a personal message or fork the project to make a pull request and so on... thanks!
## Notes
This library is under heavily development, so there may be substantial changes in the near future.
You can find an example of utilization of the module in this repo. Detailed instruction will be written soon.
## License
The MIT License (MIT)
Copyright (c) 2014 Mirco
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.