{ "info": { "author": "Andre Kramer", "author_email": "v-andkra@microsoft.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# MalmoEnv #\n\nMalmoEnv is an OpenAI \"gym\" Python Environment for Malmo/Minecraft, directly implemented Python to Java Minecraft.\n\nA Python \"gym env\" can be created and used to run an agent in a Malmo mission. Each such env has a remote Minecraft instance\nassociated to it (by DNS name or IP and Port). For multi-agent missions, the first agent's (role 0) Minecraft \nclient instance is used as a coordinator to allow all agents to rendezvous on mission starts (i.e. on env resets).\n\nAs it's pure Python, you just need this one package, its direct dependencies and (Java) Minecraft! Example missions, including some from the 2018 MarLo competition can be found in the \"missions\" directory.\n\n## Examples of use: ##\n\nInstall dependencies:\n\nJava8 JDK ([AdoptOpenJDK](https://adoptopenjdk.net/)), python3, git\n\n`pip3 install gym lxml numpy pillow`\n\nTo prepare Minecraft (after cloning this repository with \n`git clone https://github.com/Microsoft/malmo.git`):\n\n`cd malmo/Minecraft`\n\n`(echo -n \"malmomod.version=\" && cat ../VERSION) > ./src/main/resources/version.properties` \n\nRunning a single agent example mission (run each command in different cmd prompt/shells - use launchClient.bat on Windows):\n\n`./launchClient.sh -port 9000 -env` or (On Windows) `launchClient.bat -port 9000 -env`\n\n(In another shell) `cd malmo/MalmoEnv` optionally run `python3 setup.py install`\n\n`python3 run.py --mission missions/mobchase_single_agent.xml --port 9000 --episodes 10`\n\nA two agent example mission (run each command in different cmd prompt/shells):\n\n`./launchClient.sh -port 9000 -env`\n\n`./launchClient.sh -port 9001 -env`\n\nIn the two agent case, running each agent in it's own shell, the run script (for agents other than the first) is given two ports \n- the first for the mission coordinator and a second (port2) for the other agent's Minecraft:\n\n`python3 run.py --mission missions/mobchase_two_agents.xml --port 9000 --role 0 --experimentUniqueId \"test1\"`\n\n`python3 run.py --mission missions/mobchase_two_agents.xml --port 9000 --port2 9001 --role 1 --experimentUniqueId \"test1\"`\n\n## Running multi-agent examples using multiple Python threads: ##\n\n`python3 runmultiagent.py --mission missions/mobchase_two_agents.xml`\n\n## Installing with pip ##\n\nMalmoEnv is available as a pip wheel.\n\nIf you install with `pip3 install malmoenv` then you can download the Minecraft mod \n(assuming you have git available from the command line) with: \n\n`python3 -c \"import malmoenv.bootstrap; malmoenv.bootstrap.download()\"`\n\nThe sample missions will be downloaded to ./MalmoPlatform/MalmoEnv/missions.\n\n`python3 -c \"import malmoenv.bootstrap; malmoenv.bootstrap.launch_minecraft(9000)\"` can be used to start up the Malmo Minecraft Mod \nlistening for MalmoEnv connections on port 9000 after downloading Malmo.\n\nTo test: `cd MalmoPlatform/MalmoEnv; python3 runmultiagent.py --mission missions/mobchase_single_agent.xml`\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Microsoft/malmo", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "malmoenv", "package_url": "https://pypi.org/project/malmoenv/", "platform": "", "project_url": "https://pypi.org/project/malmoenv/", "project_urls": { "Homepage": "https://github.com/Microsoft/malmo" }, "release_url": "https://pypi.org/project/malmoenv/0.0.8/", "requires_dist": [ "gym", "lxml", "numpy", "pillow" ], "requires_python": "", "summary": "A gym environemnt for Malmo", "version": "0.0.8" }, "last_serial": 5841493, "releases": { "0.0.6": [ { "comment_text": "", "digests": { "md5": "c3aa9905cfd9e4daf6fa176117833de4", "sha256": "ecb3b990b0cdd49ea7452117d42db4ff18f37e5a01c6b734bdceb1c3e00e9172" }, "downloads": -1, "filename": "malmoenv-0.0.6-py3-none-any.whl", "has_sig": false, "md5_digest": "c3aa9905cfd9e4daf6fa176117833de4", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 15083, "upload_time": "2019-08-01T12:17:11", "url": "https://files.pythonhosted.org/packages/0e/f8/12dd2937f3939f98bbe5aa6526b30f90ddabb2e6dba90ecb0e8454296be4/malmoenv-0.0.6-py3-none-any.whl" } ], "0.0.8": [ { "comment_text": "", "digests": { "md5": "5e622a1f3fa33449159af309b047b5dd", "sha256": "4c65b8052274b480773b0d87e089a3d16945f67073d6987541fb65655e17cc2b" }, "downloads": -1, "filename": "malmoenv-0.0.8-py3-none-any.whl", "has_sig": false, "md5_digest": "5e622a1f3fa33449159af309b047b5dd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 30696, "upload_time": "2019-09-03T16:08:46", "url": "https://files.pythonhosted.org/packages/ca/cc/78423b811083ae56dd8d3a46f3a3bcacdf8b8f5c1ff36650ea9413092722/malmoenv-0.0.8-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2742598ff927f86f560187e0fa7382f3", "sha256": "69fa0d4e6ce3a13a390c0c4d5b3e2257c1af46288d466971f1c64944ffd0d4a1" }, "downloads": -1, "filename": "malmoenv-0.0.8.tar.gz", "has_sig": false, "md5_digest": "2742598ff927f86f560187e0fa7382f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17143, "upload_time": "2019-09-03T16:08:47", "url": "https://files.pythonhosted.org/packages/e0/7f/f86d196b485ecb29befe1c39457fc1ebf572bf4cbea4254b12af175b52bb/malmoenv-0.0.8.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5e622a1f3fa33449159af309b047b5dd", "sha256": "4c65b8052274b480773b0d87e089a3d16945f67073d6987541fb65655e17cc2b" }, "downloads": -1, "filename": "malmoenv-0.0.8-py3-none-any.whl", "has_sig": false, "md5_digest": "5e622a1f3fa33449159af309b047b5dd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 30696, "upload_time": "2019-09-03T16:08:46", "url": "https://files.pythonhosted.org/packages/ca/cc/78423b811083ae56dd8d3a46f3a3bcacdf8b8f5c1ff36650ea9413092722/malmoenv-0.0.8-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2742598ff927f86f560187e0fa7382f3", "sha256": "69fa0d4e6ce3a13a390c0c4d5b3e2257c1af46288d466971f1c64944ffd0d4a1" }, "downloads": -1, "filename": "malmoenv-0.0.8.tar.gz", "has_sig": false, "md5_digest": "2742598ff927f86f560187e0fa7382f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17143, "upload_time": "2019-09-03T16:08:47", "url": "https://files.pythonhosted.org/packages/e0/7f/f86d196b485ecb29befe1c39457fc1ebf572bf4cbea4254b12af175b52bb/malmoenv-0.0.8.tar.gz" } ] }