{ "info": { "author": "Ayush Chopra, Shashank Kumar, Jayakumar Subramanian, Balaji Krishnamurthy, Ramesh Raskar", "author_email": null, "bugtrack_url": null, "classifiers": [], "description": "

\n \n Large Population Models\n \n

\n\n

\n making complexity simple
\n differentiable learning over millions of autonomous agents\n

\n\n

\n \n \"Released\n \n\n \n \"Documentation\"\n \n \n \"Get\n \n \n \"Join\n \n

\n\nLarge Population Models (LPMs) help simulate million-size populations by\ndesigning realistic environments and capturing expressive indvidual behavior.\nOur goal is to \"re-invent the census\": built entirely in simulation, captured\npassively and used to protect country-scale populations. Our research is early\nbut actively making an impact - winning awards at AI conferences and being\ndeployed across the world. Learn more about LPMs\n[here](lpm.media.mit.edu/research.pdf).\n\nAgentTorch LPMs have four design principles:\n\n- **Scalability**: AgentTorch models can simulate country-size populations in\n seconds on commodity hardware.\n- **Differentiability**: AgentTorch models can differentiate through simulations\n with stochastic dynamics and conditional interventions, enabling\n gradient-based learning.\n- **Composition**: AgentTorch models can compose with deep neural networks (eg:\n LLMs), mechanistic simulators (eg: mitsuba) or other LPMs. This helps describe\n agent behavior using LLMs, calibrate simulation parameters and specify\n expressive interaction rules.\n- **Generalization**: AgentTorch helps simulate diverse ecosystems - humans in\n geospatial worlds, cells in anatomical worlds, autonomous avatars in digital\n worlds.\n\nAgentTorch is building the future of decision engines - inside the body, around\nus and beyond!\n\nhttps://github.com/AgentTorch/AgentTorch/assets/13482350/4c3f9fa9-8bce-4ddb-907c-3ee4d62e7148\n\n## Installation\n\n> AgentTorch is meant to be used in a Python 3.9 environment. If you have not\n> installed Python 3.9, please do so first from\n> [python.org/downloads](https://www.python.org/downloads/).\n\nInstall the framework using `pip`, like so:\n\n```sh\n> pip install git+https://github.com/agenttorch/agenttorch\n```\n\n> Some models require extra dependencies that have to be installed separately.\n> For more information regarding this, as well as the hardware the project has\n> been run on, please see [`docs/install.md`](docs/install.md).\n\n## Getting Started\n\nThe following section depicts the usage of existing models and population data\nto run simulations on your machine. It also acts as a showcase of the Agent\nTorch API.\n\nA Jupyter Notebook containing the below examples can be found\n[here](docs/tutorials/using-models/walkthrough.ipynb).\n\n### Executing a Simulation with Gradient Based Learning\n\n```py\n# re-use existing models and population data easily\nfrom agent_torch.models import covid\nfrom agent_torch.populations import astoria\n\n# use the executor to plug-n-play\nfrom agent_torch.core.executor import Executor\nfrom agent_torch.core.dataloader import LoadPopulation\n\n# agent_\"torch\" works seamlessly with the pytorch API\nfrom torch.optim import SGD\n\nloader = LoadPopulation(astoria)\nsimulation = Executor(model=covid, pop_loader=loader)\n\nsimulation.init(SGD)\nsimulation.execute()\n```\n\n## Guides and Tutorials\n\n### Understanding the Framework\n\nA detailed explanation of the architecture of the Agent Torch framework can be\nfound [here](docs/architecture.md).\n\n### Creating a Model\n\nA tutorial on how to create a simple predator-prey model can be found in the\n[`tutorials/`](docs/tutorials/) folder.\n\n### Contributing to Agent Torch\n\nThank you for your interest in contributing! You can contribute by reporting and\nfixing bugs in the framework or models, working on new features for the\nframework, creating new models, or by writing documentation for the project.\n\nTake a look at the [contributing guide](docs/contributing.md) for instructions\non how to setup your environment, make changes to the codebase, and contribute\nthem back to the project.\n\n## Impact\n\n> **AgentTorch models are being deployed across the globe.**\n\n![Impact](docs/media/impact.png)\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": null, "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "dynamic": null, "home_page": null, "keywords": null, "license": "MIT", "maintainer": "Vedant Kulkarni", "maintainer_email": null, "name": "agent-torch", "package_url": "https://pypi.org/project/agent-torch/", "platform": null, "project_url": "https://pypi.org/project/agent-torch/", "project_urls": { "Homepage": "https://lpm.media.mit.edu/docs", "Issues": "https://github.com/AgentTorch/AgentTorch/issues" }, "provides_extra": null, "release_url": "https://pypi.org/project/agent-torch/0.4.0/", "requires_dist": [ "numpy", "pandas", "torch", "torch_geometric", "omegaconf", "asyncio", "langchain", "langchain-openai", "networkx", "wandb" ], "requires_python": ">=3.8", "summary": "large population models", "version": "0.4.0", "yanked": false, "yanked_reason": null }, "last_serial": 24021718, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "blake2b_256": "91112dbdc43b9250dcc3365f10d3d5fde16aa90cb6bf7f9b0457e29bdc78418f", "md5": "bb6f60ffc3a76345838e34766eac649a", "sha256": "8728a467b61c8fdb2deda92811ab75c699be31a41bdea85fe8cfabd032e0610d" }, "downloads": -1, "filename": "agent_torch-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "bb6f60ffc3a76345838e34766eac649a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 21392, "upload_time": "2023-08-24T21:29:00", "upload_time_iso_8601": "2023-08-24T21:29:00.911462Z", "url": "https://files.pythonhosted.org/packages/91/11/2dbdc43b9250dcc3365f10d3d5fde16aa90cb6bf7f9b0457e29bdc78418f/agent_torch-0.1.0-py3-none-any.whl", "yanked": true, "yanked_reason": "Not required anymore" }, { "comment_text": "", "digests": { "blake2b_256": "52303f0c06e96c1972032cbad96a17abcc05c3aa3c7c029a4ffb3a417da30810", "md5": "6b787ceeb196019d335cbe5a26e860b0", "sha256": "0ebdf01e8c4b366790581581ce384d9c4e2a1e88f2bcc086b310ba8ab3e8b030" }, "downloads": -1, "filename": "agent_torch-0.1.0.tar.gz", "has_sig": false, "md5_digest": "6b787ceeb196019d335cbe5a26e860b0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18329, "upload_time": "2023-08-24T21:29:04", "upload_time_iso_8601": "2023-08-24T21:29:04.137190Z", "url": "https://files.pythonhosted.org/packages/52/30/3f0c06e96c1972032cbad96a17abcc05c3aa3c7c029a4ffb3a417da30810/agent_torch-0.1.0.tar.gz", "yanked": true, "yanked_reason": "Not required anymore" } ], "0.2.0": [ { "comment_text": "", "digests": { "blake2b_256": "c1f539dca111a873449e4a30c6dd00bcf1d9dea7b38630eed83e32ff85ba3abd", "md5": "ccd64850b8b81fcb0342520205beeb22", "sha256": "413a132b3ba29b210a58e2ac82179553695e731f509c0d13c630f4bdb0640394" }, "downloads": -1, "filename": "agent_torch-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "ccd64850b8b81fcb0342520205beeb22", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22354, "upload_time": "2024-02-19T22:04:42", "upload_time_iso_8601": "2024-02-19T22:04:42.516753Z", "url": "https://files.pythonhosted.org/packages/c1/f5/39dca111a873449e4a30c6dd00bcf1d9dea7b38630eed83e32ff85ba3abd/agent_torch-0.2.0-py3-none-any.whl", "yanked": true, "yanked_reason": "Not required anymore" }, { "comment_text": "", "digests": { "blake2b_256": "fe180591dd05b5502cb3c9351d5eb9ffa65898f074afad832c0e1f431f1ac3a9", "md5": "795a7f6b0d7dee3b7e3600c8e18dd856", "sha256": "d3d2260278524f5b54cfce8330a9f4e2e6425aa62b1deb0f6885652e9e602539" }, "downloads": -1, "filename": "agent_torch-0.2.0.tar.gz", "has_sig": false, "md5_digest": "795a7f6b0d7dee3b7e3600c8e18dd856", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18931, "upload_time": "2024-02-19T22:04:43", "upload_time_iso_8601": "2024-02-19T22:04:43.984671Z", "url": "https://files.pythonhosted.org/packages/fe/18/0591dd05b5502cb3c9351d5eb9ffa65898f074afad832c0e1f431f1ac3a9/agent_torch-0.2.0.tar.gz", "yanked": true, "yanked_reason": "Not required anymore" } ], "0.2.1": [ { "comment_text": "", "digests": { "blake2b_256": "7ad77db728c154be90a59db5d04f291592481fa5ac7af67f44f396ef9857cc73", "md5": "d38d60ab55a309a391fd5a2683daf21c", "sha256": "66478f72f48cf177905f5ccee919545810ed970c07c2537ccd4885b6559fafe8" }, "downloads": -1, "filename": "agent_torch-0.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "d38d60ab55a309a391fd5a2683daf21c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22514, "upload_time": "2024-02-20T19:57:54", "upload_time_iso_8601": "2024-02-20T19:57:54.007663Z", "url": "https://files.pythonhosted.org/packages/7a/d7/7db728c154be90a59db5d04f291592481fa5ac7af67f44f396ef9857cc73/agent_torch-0.2.1-py3-none-any.whl", "yanked": true, "yanked_reason": "Not required anymore" }, { "comment_text": "", "digests": { "blake2b_256": "1e173535ee59be7575653cdb2d6091c88a1f01d99f61f5108ed1efd81c17e5d4", "md5": "49440a64077c8c3a3e4429b13763f09c", "sha256": "7daf2794ccd1ad24597ea441b700e593f6785b70da2fd3c4e609b89de36aa916" }, "downloads": -1, "filename": "agent_torch-0.2.1.tar.gz", "has_sig": false, "md5_digest": "49440a64077c8c3a3e4429b13763f09c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19108, "upload_time": "2024-02-20T19:57:56", "upload_time_iso_8601": "2024-02-20T19:57:56.025431Z", "url": "https://files.pythonhosted.org/packages/1e/17/3535ee59be7575653cdb2d6091c88a1f01d99f61f5108ed1efd81c17e5d4/agent_torch-0.2.1.tar.gz", "yanked": true, "yanked_reason": "Not required anymore" } ], "0.2.2": [ { "comment_text": "", "digests": { "blake2b_256": "abb1393f6062c04903f7aa52c539b1b0496051046b8fe15a16b80f4d66420467", "md5": "d5066cb25b6db2765671b59b99c505cd", "sha256": "16f8e0a0af1f2a1656521d90358d9541635734d4b55f7698214bce2372ac8b6a" }, "downloads": -1, "filename": "agent_torch-0.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "d5066cb25b6db2765671b59b99c505cd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22563, "upload_time": "2024-02-28T15:57:20", "upload_time_iso_8601": "2024-02-28T15:57:20.302287Z", "url": "https://files.pythonhosted.org/packages/ab/b1/393f6062c04903f7aa52c539b1b0496051046b8fe15a16b80f4d66420467/agent_torch-0.2.2-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "4b3af967aa398e15b1d3da42faa89b0ba158694f26bc0b10a8dc84ebf51e161f", "md5": "b73709b643ab56c547c902d93252e397", "sha256": "ea62b04f6c3a167440f3805fdb4f8f7ac8b991809944a149506390dca69c9533" }, "downloads": -1, "filename": "agent_torch-0.2.2.tar.gz", "has_sig": false, "md5_digest": "b73709b643ab56c547c902d93252e397", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19170, "upload_time": "2024-02-28T15:57:22", "upload_time_iso_8601": "2024-02-28T15:57:22.138567Z", "url": "https://files.pythonhosted.org/packages/4b/3a/f967aa398e15b1d3da42faa89b0ba158694f26bc0b10a8dc84ebf51e161f/agent_torch-0.2.2.tar.gz", "yanked": false, "yanked_reason": null } ], "0.2.3": [ { "comment_text": "", "digests": { "blake2b_256": "b865b64ae1e646667643bec79eb3bc3747cb2771da09efaad1e74a29f389f16a", "md5": "59d6793bd39d46a5da401b4567d82026", "sha256": "80efca662363b62800dc8fe20df50b8c7dbcaf5330e6a526ad67c1c4a72cbe37" }, "downloads": -1, "filename": "agent_torch-0.2.3-py3-none-any.whl", "has_sig": false, "md5_digest": "59d6793bd39d46a5da401b4567d82026", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22397, "upload_time": "2024-02-28T17:06:41", "upload_time_iso_8601": "2024-02-28T17:06:41.706019Z", "url": "https://files.pythonhosted.org/packages/b8/65/b64ae1e646667643bec79eb3bc3747cb2771da09efaad1e74a29f389f16a/agent_torch-0.2.3-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "feb0bc0dc1c2376702a2d72dc72797d6dcac04001463164b2aa844089122277b", "md5": "7850431e8e274980c6587f52b887f3d8", "sha256": "6a12578eb07ee4a1f96d866dd4342258686db307a018656aaea8f628e00cccda" }, "downloads": -1, "filename": "agent_torch-0.2.3.tar.gz", "has_sig": false, "md5_digest": "7850431e8e274980c6587f52b887f3d8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18850, "upload_time": "2024-02-28T17:06:50", "upload_time_iso_8601": "2024-02-28T17:06:50.256256Z", "url": "https://files.pythonhosted.org/packages/fe/b0/bc0dc1c2376702a2d72dc72797d6dcac04001463164b2aa844089122277b/agent_torch-0.2.3.tar.gz", "yanked": false, "yanked_reason": null } ], "0.2.4": [ { "comment_text": "", "digests": { "blake2b_256": "d018988b1015878d89e638b7b6b32d31b36b639f7040282b944d0185a4723096", "md5": "e4a76f124eea0e39ae65793622e93b10", "sha256": "8c2aecc78bee02f2a29b38f925e75ee8617808ff0b5ef3d1faa0c6241d0cebc5" }, "downloads": -1, "filename": "agent_torch-0.2.4-py3-none-any.whl", "has_sig": false, "md5_digest": "e4a76f124eea0e39ae65793622e93b10", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22357, "upload_time": "2024-02-28T20:20:28", "upload_time_iso_8601": "2024-02-28T20:20:28.970866Z", "url": "https://files.pythonhosted.org/packages/d0/18/988b1015878d89e638b7b6b32d31b36b639f7040282b944d0185a4723096/agent_torch-0.2.4-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "ee16278d3c43316249d7fc4864d0b3f9dac42b84e13285e2d0ea55a194a3242e", "md5": "47905640d5f441a25cc4115e76cc7f6e", "sha256": "e7f9a5dff22a9f02caf5f4b392596f01bbe3bad27b59a574149ee79a0244ba4a" }, "downloads": -1, "filename": "agent_torch-0.2.4.tar.gz", "has_sig": false, "md5_digest": "47905640d5f441a25cc4115e76cc7f6e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18785, "upload_time": "2024-02-28T20:20:30", "upload_time_iso_8601": "2024-02-28T20:20:30.919988Z", "url": "https://files.pythonhosted.org/packages/ee/16/278d3c43316249d7fc4864d0b3f9dac42b84e13285e2d0ea55a194a3242e/agent_torch-0.2.4.tar.gz", "yanked": false, "yanked_reason": null } ], "0.3.1": [ { "comment_text": "", "digests": { "blake2b_256": "d5ccd1cdf17c21de0d927da6b76f9edb75c3f798f4d57eab7d6aa90d8655ea15", "md5": "8200841f6851a4dee73bd00b40409d4d", "sha256": "c4f2d4209bb8c537ae2f5b3353b71e58bd17b3516e9ced9a04fb8fc8968eaa37" }, "downloads": -1, "filename": "agent_torch-0.3.1-py3-none-any.whl", "has_sig": false, "md5_digest": "8200841f6851a4dee73bd00b40409d4d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.8", "size": 25177, "upload_time": "2024-06-25T16:41:40", "upload_time_iso_8601": "2024-06-25T16:41:40.744818Z", "url": "https://files.pythonhosted.org/packages/d5/cc/d1cdf17c21de0d927da6b76f9edb75c3f798f4d57eab7d6aa90d8655ea15/agent_torch-0.3.1-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "cf19922dbabf9b329ebde11b4abd8ea7f2973bac90313e061ed5fe7f76d12660", "md5": "4137a476aa9869ee22ddf30bcd00e0b5", "sha256": "f8f68d967331cf35bc3725846b9263fbb0395ed787df5aa99c86e1deeddaf11a" }, "downloads": -1, "filename": "agent_torch-0.3.1.tar.gz", "has_sig": false, "md5_digest": "4137a476aa9869ee22ddf30bcd00e0b5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.8", "size": 19492, "upload_time": "2024-06-25T16:41:42", "upload_time_iso_8601": "2024-06-25T16:41:42.811448Z", "url": "https://files.pythonhosted.org/packages/cf/19/922dbabf9b329ebde11b4abd8ea7f2973bac90313e061ed5fe7f76d12660/agent_torch-0.3.1.tar.gz", "yanked": false, "yanked_reason": null } ], "0.4.0": [ { "comment_text": "", "digests": { "blake2b_256": "b55a0b4e0bcaf82b6c306f3491993d33b56502e93d93f99c5b1d13c1063251d6", "md5": "348ce0fa7e1e968dc79b3ef6e06b7383", "sha256": "255c1a4b8e839a63b0780fa033f51f81b393537be6af395599efd8e651ba2b29" }, "downloads": -1, "filename": "agent_torch-0.4.0-py3-none-any.whl", "has_sig": false, "md5_digest": "348ce0fa7e1e968dc79b3ef6e06b7383", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.8", "size": 17742642, "upload_time": "2024-07-07T15:22:04", "upload_time_iso_8601": "2024-07-07T15:22:04.584781Z", "url": "https://files.pythonhosted.org/packages/b5/5a/0b4e0bcaf82b6c306f3491993d33b56502e93d93f99c5b1d13c1063251d6/agent_torch-0.4.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "fe8dede47455b41f25c8f7427ab82ed850da7780522d26906968cc00207d09b1", "md5": "35924de8f385081d1df88596ff435a38", "sha256": "188a6cb01bc6d02b43be97c7b1f063a744b3892f8e8d66487a4115d7d4c8ab95" }, "downloads": -1, "filename": "agent_torch-0.4.0.tar.gz", "has_sig": false, "md5_digest": "35924de8f385081d1df88596ff435a38", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.8", "size": 17296184, "upload_time": "2024-07-07T15:22:07", "upload_time_iso_8601": "2024-07-07T15:22:07.316403Z", "url": "https://files.pythonhosted.org/packages/fe/8d/ede47455b41f25c8f7427ab82ed850da7780522d26906968cc00207d09b1/agent_torch-0.4.0.tar.gz", "yanked": false, "yanked_reason": null } ] }, "urls": [ { "comment_text": "", "digests": { "blake2b_256": "b55a0b4e0bcaf82b6c306f3491993d33b56502e93d93f99c5b1d13c1063251d6", "md5": "348ce0fa7e1e968dc79b3ef6e06b7383", "sha256": "255c1a4b8e839a63b0780fa033f51f81b393537be6af395599efd8e651ba2b29" }, "downloads": -1, "filename": "agent_torch-0.4.0-py3-none-any.whl", "has_sig": false, "md5_digest": "348ce0fa7e1e968dc79b3ef6e06b7383", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.8", "size": 17742642, "upload_time": "2024-07-07T15:22:04", "upload_time_iso_8601": "2024-07-07T15:22:04.584781Z", "url": "https://files.pythonhosted.org/packages/b5/5a/0b4e0bcaf82b6c306f3491993d33b56502e93d93f99c5b1d13c1063251d6/agent_torch-0.4.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "fe8dede47455b41f25c8f7427ab82ed850da7780522d26906968cc00207d09b1", "md5": "35924de8f385081d1df88596ff435a38", "sha256": "188a6cb01bc6d02b43be97c7b1f063a744b3892f8e8d66487a4115d7d4c8ab95" }, "downloads": -1, "filename": "agent_torch-0.4.0.tar.gz", "has_sig": false, "md5_digest": "35924de8f385081d1df88596ff435a38", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.8", "size": 17296184, "upload_time": "2024-07-07T15:22:07", "upload_time_iso_8601": "2024-07-07T15:22:07.316403Z", "url": "https://files.pythonhosted.org/packages/fe/8d/ede47455b41f25c8f7427ab82ed850da7780522d26906968cc00207d09b1/agent_torch-0.4.0.tar.gz", "yanked": false, "yanked_reason": null } ], "vulnerabilities": [] }