{"id":21346378,"url":"https://github.com/thehive-project/cortex4py","last_synced_at":"2025-07-12T17:30:40.189Z","repository":{"id":25290903,"uuid":"85590349","full_name":"TheHive-Project/Cortex4py","owner":"TheHive-Project","description":"Python API Client for Cortex","archived":false,"fork":false,"pushed_at":"2022-02-24T10:02:54.000Z","size":90,"stargazers_count":32,"open_issues_count":9,"forks_count":30,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-08T04:09:06.360Z","etag":null,"topics":["api","api-client","cortex","dfir","free-software","incident-response","open-source","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheHive-Project.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-20T14:59:48.000Z","updated_at":"2024-09-05T00:10:57.000Z","dependencies_parsed_at":"2022-07-15T18:30:30.460Z","dependency_job_id":null,"html_url":"https://github.com/TheHive-Project/Cortex4py","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHive-Project%2FCortex4py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHive-Project%2FCortex4py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHive-Project%2FCortex4py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHive-Project%2FCortex4py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheHive-Project","download_url":"https://codeload.github.com/TheHive-Project/Cortex4py/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225829082,"owners_count":17530666,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-client","cortex","dfir","free-software","incident-response","open-source","python"],"created_at":"2024-11-22T02:08:25.497Z","updated_at":"2024-11-22T02:08:26.029Z","avatar_url":"https://github.com/TheHive-Project.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://travis-ci.org/github/TheHive-Project/Cortex4py\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://travis-ci.org/TheHive-Project/Cortex4py.svg?branch=1.x\" alt=\"Build status\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://chat.thehive-project.org\" target\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/discord/779945042039144498\" alt=\"Discord\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"./LICENSE\" target\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/license/TheHive-Project/Cortex4py\" alt=\"License\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/cortex4py\" target\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/pypi/dm/cortex4py\" alt=\"Pypi page\"\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n# Cortex4py\nCortex4py is a Python API client for [Cortex](https://thehive-project.org/), a powerful observable analysis engine where observables such as IP and email addresses, URLs, domain names, files or hashes can be analyzed one by one using a Web interface.\n\nCortex4py allows analysts to automate these operations and submit observables in bulk mode through the Cortex REST API from alternative SIRP platforms, custom scripts or MISP.\n\n\n# Features\nCortex4py 2 is compatible with Cortex 2 and does not work with Cortex 1. It can:\n- Manage organizations\n- Manage users\n- Configure analyzers within an organization\n- List and launch analyzers\n\nFor more details, please refer to the [full documentation](Usage.md).\n\n**Note**: Cortex4py 2 requires Python 3. It does not support Python 2.\n\n# Use It\nOn macOS and Linux, type:\n```\nsudo -H pip3 install cortex4py\n```\n\nor, if you already have it, update it:\n\n```\nsudo -H pip3 install -U cortex4py\n```\n\nIf you are using Python on a Windows operating system, please forgo the `sudo` command.\n\n# License\nCortex4py is an open source and free software released under the [AGPL](https://github.com/CERT-BDF/Cortex4py/blob/master/LICENSE) (Affero General Public License). We, TheHive Project, are committed to ensure that Cortex4py will remain a free and open source project on the long-run.\n\n# Updates\nInformation, news and updates are regularly posted on [TheHive Project Twitter account](https://twitter.com/thehive_project) and on [the blog](https://blog.thehive-project.org/).\n\n# Contributing\nWe welcome your contributions. Please feel free to fork the code, play with it, make some patches and send us pull requests using [issues](https://github.com/CERT-BDF/Cortex4py/issues).\n\nWe do have a [Code of conduct](code_of_conduct.md). Make sure to check it out before contributing.\n\n# Support\nPlease [open an issue on GitHub](https://github.com/TheHive-Project/Cortex4py/issues/new) if you'd like to report a bug or request a feature. We are also available on [Discord](https://chat.thehive-project.org) to help you out.\n\nIf you need to contact the project team, send an email to \u003csupport@thehive-project.org\u003e.\n\n# Community Discussions\nWe have set up a Google forum at \u003chttps://groups.google.com/a/thehive-project.org/d/forum/users\u003e. To request access, you need a Google account. You may create one [using a Gmail address](https://accounts.google.com/SignUp?hl=en) or [without one](https://accounts.google.com/SignUpWithoutGmail?hl=en).\n\n# Website\n\u003chttps://thehive-project.org/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthehive-project%2Fcortex4py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthehive-project%2Fcortex4py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthehive-project%2Fcortex4py/lists"}