Skip to content
Python API Client for Cortex
Branch: master
Clone or download
Latest commit 96a9fa3 Mar 4, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
cortex4py Fix to include the missing packages Jun 19, 2018
.gitignore WIP: started new cortex4py version May 23, 2018
AUTHORS Update for v2 Jun 18, 2018
LICENSE Initial commit Mar 20, 2017 Use pip3 Jun 18, 2018 fix delete job Feb 18, 2019 Add Authors and Code of conduct files Sep 4, 2017
requirements.txt Add typing requirement Jun 18, 2018 Fix to include the missing packages Jun 19, 2018

Join the chat at


Cortex4py is a Python API client for Cortex, 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.

Cortex4py 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.


Cortex4py 2 is compatible with Cortex 2 and does not work with Cortex 1. It can:

  • Manage organizations
  • Manage users
  • Configure analyzers within an organization
  • List and launch analyzers

For more details, please refer to the full documentation.

Note: Cortex4py 2 requires Python 3. It does not support Python 2.

Use It

On macOS and Linux, type:

sudo -H pip3 install cortex4py

or, if you already have it, update it:

sudo -H pip3 install -U cortex4py

If you are using Python on a Windows operating system, please forgo the sudo command.


Cortex4py is an open source and free software released under the AGPL (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.


Information, news and updates are regularly posted on TheHive Project Twitter account and on the blog.


We welcome your contributions. Please feel free to fork the code, play with it, make some patches and send us pull requests using issues.

We do have a Code of conduct. Make sure to check it out before contributing.


Please open an issue on GitHub if you'd like to report a bug or request a feature. We are also available on Gitter to help you out.

If you need to contact the project team, send an email to

Community Discussions

We have set up a Google forum at To request access, you need a Google account. You may create one using a Gmail address or without one.


You can’t perform that action at this time.