{ "info": { "author": "Microsoft", "author_email": "v-andkra@microsoft.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Scientific/Engineering :: Artificial Intelligence" ], "description": "# Pip installable package for Malmo #\n\nMalmo can be built from source ([Instructions for building from source](https://github.com/Microsoft/malmo/tree/master/doc)) \nor easily installed from the pre-build version \n([Install from pre-built version](https://github.com/Microsoft/malmo/releases)). \nHowever, it is often even simpler and sufficient to install Malmo as a python native platform wheel for Windows, MacOS or Linux.\n\n## Prerequisites ##\n\nIn order to `pip3 install malmo` there are some environment and OS dependency requirements that have to be met:\n\n1.\tJava 8 must be installed and the JAVA_HOME environment variable set up for Java8.\n2. [git](https://git-scm.com/) should be installed and on your shell search path.\n3.\tMALMO_XSD_PATH must be set to where the XSD schema files are located (more on this below).\n4.\tThere are a few OS specific dependencies that must be pre-installed. \n\n *\tFor [Ubuntu Linux](https://github.com/Microsoft/malmo/blob/master/doc/install_linux.md) these are follows:\n `python3-pip ffmpeg openjdk-8-jdk git`,\n We'll add more Linux flavours specifics here soon but meanwhile the docker build scripts are a good place to start.\n\n *\tWindows - please use the [manual install](https://github.com/Microsoft/malmo/blob/master/doc/install_windows_manual.md) to install dependencies.\n (The dependencies are python3, ffmpeg, 7zip, Java8 and additionally git.)\n\n *\tMacOSX - please see [MacOSX](https://github.com/Microsoft/malmo/blob/master/doc/install_macosx.md).\n\nIf you are unsure of what to pre-install for your Linux flavour,\nthe Malmo docker build files might be a good place to start\n([Docker build files](https://github.com/Microsoft/malmo/tree/master/scripts/docker)).\n\n## Using the prebuilt Docker image ##\n\nRather than installing these dependencies manually it's simper to use docker to launch a docker container using our prebuilt docker image. \n\nOur docker image already has the Malmo Python package installed, as well as the source code and Minecraft \n(and the dependencies of course), along with a Jupyter server so can start coding right away!\n\nThe docker container will launch the Malmo Minecraft Mod and a Jupyter server on start up,\nand is set up to allow remote access via the \n[VNC remote desktop display protocol](https://en.wikipedia.org/wiki/Virtual_Network_Computing) \nso that you are able to see the Minecraft game running inside the container.\n\n```\ndocker run -it -p 5901:5901 -p 6901:6901 -p8888:8888 -e VNC_PW=vncpassword andkram/malmo\n```\n\nYou can add a `-v drive:/somedir:/somedir` option to the above docker run command to mount a directory \nfor sharing your coding project files. You should also select a different hard to guess password.\n\nTo access the container browse to `http://localhost:6901/?password=vncpassword` (or connect to port 5901 using a VNC client).\n\nOnce Minecraft is completely launched in the container (which can take some minutes the first time the container is run) \nyou should see it in the VNC desktop in your open browser tab.\n\nAfter launching Minecraft, a Jupiter server is also started up and a connection advise hint is written on the docker container's output.\nPlease follow the advice to cut & paste the url into another browser tab but substituting `localhost` for `0.0.0.0` or address URL part\n(as we are bridging port 8888 to the docker container).\n\nThe output looks something like this:\n\n```\nCopy/paste this URL into your browser when you connect for the first time,\n to login with a token:\n http://0.0.0.0:8888/?token=1c6390221431ca75146946c52e253f063431b6488420bbac\n```\n(Here you should have used: `http://localhost:8888/?token=1c6390221431ca75146946c52e253f063431b6488420bbac`for Jupyter.)\n\nTo run a sample mission in Jupyter, create a python3 notebook and enter `from malmo.run_mission import run; run()` and execute the notebook.\n\n## Install using pip locally ##\n\nIf you would rather install Malmo locally without docker you can do that \n(after satisfying the OS & environment variable requirements above) using:\n\n```\npip3 install malmo\n```\n\nCreate or change into a working directory where you would like Malmo to be installed (in a sub directory named MalmoPlatform) and do:\n\n```\npython3 -c 'import malmo.minecraftbootstrap; malmo.minecraftbootstrap.download()'\n```\n\nThis command will create a new directory (called MalmoPlatform) containing the Malmo GitHub project in your (current) working directory. By default, the master branch is downloaded. You can specify a branch using a string keyword argument (named branch) to the download function - which can be necessary if the malmo package was not installed recently and the download is for some reason done again.\n\nPlease remember to set up the MALMO_XSD_PATH environment variable to point to the MalmoPlatform/Schemas directory. \ni.e. full path of working dir and MalmoPlatform/Schema.\n\nAlternatively, you could set it in Python temporarily with a `malmo.minecraftbootstrap.set_malmo_xsd_path();` statement after the \n`import malmo.minecraftbootstrap;` module import in the python command below.\n\nYou can now launch Minecraft from your working directory:\n\n```\npython3 -c 'import malmo.minecraftbootstrap; malmo.minecraftbootstrap.launch_minecraft()'\n```\n\nThis may take some time (minutes if it's the first run as it needs to build Minecraft Forge).\n\nThe malmo package includes a simple test mission which you can run as follows in another shell / terminal session:\n\n```\npython3 -c 'from malmo.run_mission import run; run()'\n```\n\n(In your sessond shell or terminal session, add a `malmo.minecraftbootstrap.set_malmo_xsd_path()` statement if you have not already set up the MALMO_XSD_PATH.)\n\nYou can also run the mission from Jupyter. Simply create a Python3 notebook and \nadd `from malmo.run_mission import run; run()` to the notebook and execute it.\n\nTo start coding you could try `import malmo; help(malmo)`. \nThe MalmoPython sub-module (`import malmo.MalmoPython`) is the native library used by all the Malmo Python examples.\n\n## Running existing examples ## \n\nIf you wish to run old Malmo examples against the pip \"malmo\" module without editing imports \nthen you may want to copy in MalmoPython.py and malmoutil.py from the\n[pip package backwards compatibility directory](https://github.com/Microsoft/malmo/tree/master/scripts/python-wheel/backwards-compatible-imports) or include them on your PYTHONPATH.\n\n## Deinstall ##\n\nTo deinstall delete the (downloaded) MalmoPlatform directory and it's contents and do a `pip3 uninstall malmo`.\n\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Microsoft/malmo", "keywords": "AI Minecraft Reinforcement-Learning", "license": "", "maintainer": "", "maintainer_email": "", "name": "malmo", "package_url": "https://pypi.org/project/malmo/", "platform": "", "project_url": "https://pypi.org/project/malmo/", "project_urls": { "Bug Reports": "https://github.com/Microsoft/malmo/issues", "Funding": "https://donate.pypi.org", "Homepage": "https://github.com/Microsoft/malmo", "Say Thanks!": "http://saythanks.io/to/example", "Source": "https://github.com/Microsoft/malmo/" }, "release_url": "https://pypi.org/project/malmo/0.37.0.0/", "requires_dist": [ "check-manifest ; extra == 'dev'", "coverage ; extra == 'test'" ], "requires_python": "", "summary": "Project Malmo is a platform for Artificial Intelligence experimentation and research built on top of Minecraft", "version": "0.37.0.0" }, "last_serial": 5841498, "releases": { "0.35.6.0": [ { "comment_text": "", "digests": { "md5": "b69d97960906b09d367bcd9b2fb05b91", "sha256": "c802c5bc499bda0e198ac620b416a6ca80261da41270ee46d74e2252a0bf65d4" }, "downloads": -1, "filename": "malmo-0.35.6.0-cp35-cp35m-manylinux1_x86_64.whl", "has_sig": false, "md5_digest": "b69d97960906b09d367bcd9b2fb05b91", "packagetype": "bdist_wheel", "python_version": "cp35", "requires_python": null, "size": 1263331, "upload_time": "2018-06-14T08:28:33", "url": "https://files.pythonhosted.org/packages/84/d0/5822c6f76ac33f2d66a3b611f50a8684457d0f8041efd798cab91ae3b77a/malmo-0.35.6.0-cp35-cp35m-manylinux1_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "5cb943db1395dfc6d7128ca71c30437e", "sha256": "1c0b683472e1d0319742bee5e3ff3ae8c3c3dd0e7a74303481d23606bcc08ecd" }, "downloads": -1, "filename": "malmo-0.35.6.0-cp36-cp36m-macosx_10_13_x86_64.whl", "has_sig": false, "md5_digest": "5cb943db1395dfc6d7128ca71c30437e", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": null, "size": 1766927, "upload_time": "2018-06-14T08:29:00", "url": "https://files.pythonhosted.org/packages/75/24/65a6ac73bcfec41ed559548c026a95a20116d5b649b18db1c8f02eeb3b9e/malmo-0.35.6.0-cp36-cp36m-macosx_10_13_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "da2ab8b8b645e8a00612f25bf9e58101", "sha256": "ac91cab550b5afd320f971882f56416ca9db50bfdd8a637dbb57753301e8b94b" }, "downloads": -1, "filename": "malmo-0.35.6.0-cp36-cp36m-win_amd64.whl", "has_sig": false, "md5_digest": "da2ab8b8b645e8a00612f25bf9e58101", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": null, "size": 722688, "upload_time": "2018-06-14T08:12:33", "url": "https://files.pythonhosted.org/packages/ea/26/419d72a8da955144a2acb4a6f5ce55182006c3d6b07bc7920868cd07fa07/malmo-0.35.6.0-cp36-cp36m-win_amd64.whl" }, { "comment_text": "", "digests": { "md5": "8402f9729ea391be713185c5f8d53c46", "sha256": "770d36eb594f3deeccdb449bbe5144371bb5102d4f0cb8ba55a3396431d45d0f" }, "downloads": -1, "filename": "malmo-0.35.6.0-cp37-cp37m-macosx_10_13_x86_64.whl", "has_sig": false, "md5_digest": "8402f9729ea391be713185c5f8d53c46", "packagetype": "bdist_wheel", "python_version": "cp37", "requires_python": null, "size": 1767193, "upload_time": "2018-07-03T06:26:30", "url": "https://files.pythonhosted.org/packages/3c/3a/503e8741ec0b4e9814f45303f7ff898ebfdb1aca3b6e23bb1b17e6db5f13/malmo-0.35.6.0-cp37-cp37m-macosx_10_13_x86_64.whl" } ], "0.36.0.0": [ { "comment_text": "", "digests": { "md5": "eaa4a0fa1a7a63459e08cc20bc2a890d", "sha256": "3ca94d8181668941e1d846ba4fe13569ae98f9ad36e15be8a523ac7b64bfcc61" }, "downloads": -1, "filename": "malmo-0.36.0.0-cp35-cp35m-manylinux1_x86_64.whl", "has_sig": false, "md5_digest": "eaa4a0fa1a7a63459e08cc20bc2a890d", "packagetype": "bdist_wheel", "python_version": "cp35", "requires_python": null, "size": 1237722, "upload_time": "2018-08-08T10:21:55", "url": "https://files.pythonhosted.org/packages/c6/42/b9407a4fa658e3254ac680c90ef6d677ba80e126162afb1d66fd9a6ae6c0/malmo-0.36.0.0-cp35-cp35m-manylinux1_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "a55fcf35ec594404a7ed2c655f29d078", "sha256": "02e93e7cc8788d625160490537528da95b9a65196acbe063eecd944611c2411a" }, "downloads": -1, "filename": "malmo-0.36.0.0-cp36-cp36m-win_amd64.whl", "has_sig": false, "md5_digest": "a55fcf35ec594404a7ed2c655f29d078", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": null, "size": 724220, "upload_time": "2018-08-08T10:07:10", "url": "https://files.pythonhosted.org/packages/75/b4/58a46d9f4616e9dd883cc9a854c540c624a76b0ab373c0332b8ae5c692f0/malmo-0.36.0.0-cp36-cp36m-win_amd64.whl" }, { "comment_text": "", "digests": { "md5": "9ceae6ec99786c3068c61672b59a0d64", "sha256": "9633626a7621ffda012d64bc54a1d592f8da5925aeb018c55e9e4ec81e2cc505" }, "downloads": -1, "filename": "malmo-0.36.0.0-cp37-cp37m-macosx_10_13_x86_64.whl", "has_sig": false, "md5_digest": "9ceae6ec99786c3068c61672b59a0d64", "packagetype": "bdist_wheel", "python_version": "cp37", "requires_python": null, "size": 1774284, "upload_time": "2018-08-08T10:28:16", "url": "https://files.pythonhosted.org/packages/a5/12/71cfbf665a6b4c98e329691d738884721412072d08006e71367e3963dc4b/malmo-0.36.0.0-cp37-cp37m-macosx_10_13_x86_64.whl" } ], "0.37.0.0": [ { "comment_text": "", "digests": { "md5": "d9ec2451d2b26399e2e4fbd8c1ffaa1a", "sha256": "f9b502f1888f6f9ad4e66e3e19f22b9823c5c84582103a6298559f63701283d5" }, "downloads": -1, "filename": "malmo-0.37.0.0-cp37-cp37m-macosx_10_14_x86_64.whl", "has_sig": false, "md5_digest": "d9ec2451d2b26399e2e4fbd8c1ffaa1a", "packagetype": "bdist_wheel", "python_version": "cp37", "requires_python": null, "size": 2109705, "upload_time": "2019-08-02T09:05:51", "url": "https://files.pythonhosted.org/packages/4f/b0/d96a17e2938a6695bf05f1efdcf8dc7853f092591c7a24ff6e0f23f646c5/malmo-0.37.0.0-cp37-cp37m-macosx_10_14_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "6cdf196f251d06acf2302faf479bb8fb", "sha256": "9fe09e6d6a016c0b14a574efc48c90f519cd9c6cb8be7cd15f79c892da7c53d9" }, "downloads": -1, "filename": "malmo-0.37.0.0-cp37-cp37m-win_amd64.whl", "has_sig": false, "md5_digest": "6cdf196f251d06acf2302faf479bb8fb", "packagetype": "bdist_wheel", "python_version": "cp37", "requires_python": null, "size": 673662, "upload_time": "2019-07-08T14:05:53", "url": "https://files.pythonhosted.org/packages/ac/39/84199642e8b2c0cac81236e3191fc38791ab1b325a814c3bb7dfa5b95976/malmo-0.37.0.0-cp37-cp37m-win_amd64.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d9ec2451d2b26399e2e4fbd8c1ffaa1a", "sha256": "f9b502f1888f6f9ad4e66e3e19f22b9823c5c84582103a6298559f63701283d5" }, "downloads": -1, "filename": "malmo-0.37.0.0-cp37-cp37m-macosx_10_14_x86_64.whl", "has_sig": false, "md5_digest": "d9ec2451d2b26399e2e4fbd8c1ffaa1a", "packagetype": "bdist_wheel", "python_version": "cp37", "requires_python": null, "size": 2109705, "upload_time": "2019-08-02T09:05:51", "url": "https://files.pythonhosted.org/packages/4f/b0/d96a17e2938a6695bf05f1efdcf8dc7853f092591c7a24ff6e0f23f646c5/malmo-0.37.0.0-cp37-cp37m-macosx_10_14_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "6cdf196f251d06acf2302faf479bb8fb", "sha256": "9fe09e6d6a016c0b14a574efc48c90f519cd9c6cb8be7cd15f79c892da7c53d9" }, "downloads": -1, "filename": "malmo-0.37.0.0-cp37-cp37m-win_amd64.whl", "has_sig": false, "md5_digest": "6cdf196f251d06acf2302faf479bb8fb", "packagetype": "bdist_wheel", "python_version": "cp37", "requires_python": null, "size": 673662, "upload_time": "2019-07-08T14:05:53", "url": "https://files.pythonhosted.org/packages/ac/39/84199642e8b2c0cac81236e3191fc38791ab1b325a814c3bb7dfa5b95976/malmo-0.37.0.0-cp37-cp37m-win_amd64.whl" } ] }