| Name | anyrun-sdk JSON |
| Version |
1.10.8
JSON |
| download |
| home_page | None |
| Summary | This is the official Python client library for ANY.RUN. Automate management of ANY.RUN REST endpoints |
| upload_time | 2025-07-30 08:53:25 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | Apache v2.0 |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<p align="center">
<a href="#readme">
<img alt="ANY.RUN logo" src="https://raw.githubusercontent.com/anyrun/anyrun-sdk/b3dfde1d3aa018d0a1c3b5d0fa8aaa652e80d883/static/logo.svg">
</a>
</p>
______________________________________________________________________
# ANY.RUN SDK
This is the official Python client library for [ANY.RUN](https://app.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=appanyrun), supporting the cybersecurity solutions like the Interactive Sandbox, TI Lookup, and TI Feeds.
With this library you can interact with the ANY.RUN REST API and automate your workflow quickly and efficiently.
# Available features
* Built-in objects iterator and exception handling
* Synchronous and asynchronous interface
* Python 3.9-3.13 support
### Sandbox API
[ANY.RUN Sandbox](https://app.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=appanyrun) is an online interactive sandbox for malware analysis, a tool for detection, monitoring, and research of cyber threats in real time.
* Submit files and URLs for analysis
* Monitor analysis progress in real-time
* Get detailed reports
* Manage the tasks
### TI Lookup API and YARA Search
TI Lookup is a [searchable database](https://intelligence.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=intelligence-lookup)
of IOCs, IOAs, IOBs, and events for threat hunting and a [service](https://intelligence.any.run/analysis/yara/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=intelligence-yara)
for browsing malicious files by their content.
Perform deep searches, look up threats online, and enrich your security solutions.
* Look up URLs and file hashes
* Search for IOCs using YARA rules
* Get threat intelligence data
* Monitor search progress in real time
* Get detailed analysis results
### TI Feeds API
[Threat Intelligence Feeds](https://intelligence.any.run/feeds/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=intelligence-feeds)
provide data on the known indicators of compromise: malicious IPs, URLs, Domains
Supports the following feed formats:
* MISP
* [TAXII](https://oasis-open.github.io/cti-documentation/taxii/intro.html) STIX
* Network IOCs
### Note:
Please inline ANY.RUN API-Key and Basic authorization token using the prefix:
```commandline
API-KEY format: API-KEY WmNfqnpo...2Sjon7mtvm8e
```
```commandline
Basic token format: Basic c2VtZW5f...GCd0RvUg==
```
# The library public interface overview
```python
import os
from pprint import pprint
from anyrun.connectors import SandboxConnector
def main():
with SandboxConnector.android(api_key) as connector:
# Initialize the url analysis
task_id = connector.run_url_analysis('https://any.run')
print(f'Analysis successfully initialized. Task uuid: {task_id}')
# View analysis status in real time
for status in connector.get_task_status(task_id):
print(status)
# Get report results
report = connector.get_analysis_report(task_id)
pprint(report)
# Remove the task from history
connector.delete_task(task_id)
if __name__ == '__main__':
# Setup ANY.RUN api key
api_key = os.getenv('ANY_RUN_Sandbox_API_KEY')
main()
```
You can find additional usage examples [here](https://github.com/anyrun/anyrun-sdk/tree/main/examples)
# Installation Guide
#### You can install the SDK using pip or any other package manager
```console
$ pip install anyrun-sdk
```
#### Also, you can install the SDK manually using pyproject.toml
```console
$ git clone git@github.com:anyrun/anyrun-sdk.git
$ cd anyrun-sdk
$ python -m pip install .
```
# Contributing
We welcome contributions! Please see our [Contributing Guide](https://github.com/anyrun/anyrun-sdk/blob/main/CONTRIBUTING.md) for details.
# Useful links
[TI Lookup query Guide](https://intelligence.any.run/TI_Lookup_Query_Guide_v4.pdf)
[ANY.RUN API documentation](https://any.run/api-documentation/#api-Request-Request)
# Contact us
Support, sales, and trial inquiries – support@any.run
Public relations and partnerships – pr@any.run
Raw data
{
"_id": null,
"home_page": null,
"name": "anyrun-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Semen Shalnev <anyrun-integrations@any.run>",
"download_url": "https://files.pythonhosted.org/packages/b5/82/af87c1016df6c36d3cb4d3bd5d0be1c67129e0872bb9795cac2e95557bae/anyrun_sdk-1.10.8.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"#readme\">\n <img alt=\"ANY.RUN logo\" src=\"https://raw.githubusercontent.com/anyrun/anyrun-sdk/b3dfde1d3aa018d0a1c3b5d0fa8aaa652e80d883/static/logo.svg\">\n </a>\n</p>\n\n______________________________________________________________________\n\n# ANY.RUN SDK\nThis is the official Python client library for [ANY.RUN](https://app.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=appanyrun), supporting the cybersecurity solutions like the Interactive Sandbox, TI Lookup, and TI Feeds. \nWith this library you can interact with the ANY.RUN REST API and automate your workflow quickly and efficiently. \n\n# Available features\n\n* Built-in objects iterator and exception handling \n* Synchronous and asynchronous interface \n* Python 3.9-3.13 support \n\n### Sandbox API\n[ANY.RUN Sandbox](https://app.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=appanyrun) is an online interactive sandbox for malware analysis, a tool for detection, monitoring, and research of cyber threats in real time. \n\n * Submit files and URLs for analysis\n * Monitor analysis progress in real-time\n * Get detailed reports \n * Manage the tasks \n\n### TI Lookup API and YARA Search \nTI Lookup is a [searchable database](https://intelligence.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=intelligence-lookup) \nof IOCs, IOAs, IOBs, and events for threat hunting and a [service](https://intelligence.any.run/analysis/yara/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=intelligence-yara)\nfor browsing malicious files by their content. \nPerform deep searches, look up threats online, and enrich your security solutions. \n\n * Look up URLs and file hashes \n * Search for IOCs using YARA rules \n * Get threat intelligence data \n * Monitor search progress in real time \n * Get detailed analysis results \n\n### TI Feeds API \n[Threat Intelligence Feeds](https://intelligence.any.run/feeds/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=intelligence-feeds) \nprovide data on the known indicators of compromise: malicious IPs, URLs, Domains\nSupports the following feed formats: \n * MISP \n * [TAXII](https://oasis-open.github.io/cti-documentation/taxii/intro.html) STIX\n * Network IOCs \n\n### Note:\nPlease inline ANY.RUN API-Key and Basic authorization token using the prefix:\n```commandline\nAPI-KEY format: API-KEY WmNfqnpo...2Sjon7mtvm8e \n```\n```commandline\nBasic token format: Basic c2VtZW5f...GCd0RvUg==\n```\n\n# The library public interface overview\n\n```python\nimport os\nfrom pprint import pprint\n\nfrom anyrun.connectors import SandboxConnector\n\n\ndef main():\n with SandboxConnector.android(api_key) as connector:\n # Initialize the url analysis\n task_id = connector.run_url_analysis('https://any.run')\n print(f'Analysis successfully initialized. Task uuid: {task_id}')\n \n # View analysis status in real time\n for status in connector.get_task_status(task_id):\n print(status)\n \n # Get report results\n report = connector.get_analysis_report(task_id)\n pprint(report)\n \n # Remove the task from history\n connector.delete_task(task_id)\n\n\nif __name__ == '__main__':\n # Setup ANY.RUN api key\n api_key = os.getenv('ANY_RUN_Sandbox_API_KEY')\n main()\n\n```\nYou can find additional usage examples [here](https://github.com/anyrun/anyrun-sdk/tree/main/examples)\n\n# Installation Guide\n\n#### You can install the SDK using pip or any other package manager\n```console\n$ pip install anyrun-sdk\n```\n\n#### Also, you can install the SDK manually using pyproject.toml\n```console\n$ git clone git@github.com:anyrun/anyrun-sdk.git\n$ cd anyrun-sdk\n$ python -m pip install .\n```\n\n# Contributing\nWe welcome contributions! Please see our [Contributing Guide](https://github.com/anyrun/anyrun-sdk/blob/main/CONTRIBUTING.md) for details.\n\n# Useful links\n\n[TI Lookup query Guide](https://intelligence.any.run/TI_Lookup_Query_Guide_v4.pdf) \n[ANY.RUN API documentation](https://any.run/api-documentation/#api-Request-Request)\n\n# Contact us \n\nSupport, sales, and trial inquiries \u2013 support@any.run \nPublic relations and partnerships \u2013 pr@any.run \n",
"bugtrack_url": null,
"license": "Apache v2.0",
"summary": "This is the official Python client library for ANY.RUN. Automate management of ANY.RUN REST endpoints",
"version": "1.10.8",
"project_urls": {
"Examples": "https://github.com/anyrun/anyrun-sdk/tree/main/examples",
"Homepage": "https://github.com/anyrun/anyrun-sdk"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3a93abaf5ab1d5e24d4adc0a817013ec6cdf1e01068e3e3bc85271c9fb64c799",
"md5": "4a2c681b8ea3de91b2d2cc65a18c5d86",
"sha256": "55a8e6b2af6d4a78b37e6250bf9d5bcd00130bc2f6158c8800ff2e5dd38e56bb"
},
"downloads": -1,
"filename": "anyrun_sdk-1.10.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4a2c681b8ea3de91b2d2cc65a18c5d86",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 49509,
"upload_time": "2025-07-30T08:53:23",
"upload_time_iso_8601": "2025-07-30T08:53:23.976000Z",
"url": "https://files.pythonhosted.org/packages/3a/93/abaf5ab1d5e24d4adc0a817013ec6cdf1e01068e3e3bc85271c9fb64c799/anyrun_sdk-1.10.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b582af87c1016df6c36d3cb4d3bd5d0be1c67129e0872bb9795cac2e95557bae",
"md5": "c55d1d5f84df6fb1539d86de6eda978c",
"sha256": "6d112668c28bf6ea709f07fd4ca5f00b24c24fd1c4a8e8ec8b2a6dab2e5a76c4"
},
"downloads": -1,
"filename": "anyrun_sdk-1.10.8.tar.gz",
"has_sig": false,
"md5_digest": "c55d1d5f84df6fb1539d86de6eda978c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 31665,
"upload_time": "2025-07-30T08:53:25",
"upload_time_iso_8601": "2025-07-30T08:53:25.084349Z",
"url": "https://files.pythonhosted.org/packages/b5/82/af87c1016df6c36d3cb4d3bd5d0be1c67129e0872bb9795cac2e95557bae/anyrun_sdk-1.10.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 08:53:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "anyrun",
"github_project": "anyrun-sdk",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "anyrun-sdk"
}
