{"id":31766124,"url":"https://github.com/ibmdecisionoptimization/docplex","last_synced_at":"2026-04-01T18:37:07.673Z","repository":{"id":113738680,"uuid":"570472068","full_name":"IBMDecisionOptimization/docplex","owner":"IBMDecisionOptimization","description":"IBM Decision Optimization Modeling for Python","archived":false,"fork":false,"pushed_at":"2025-08-14T11:39:37.000Z","size":10079,"stargazers_count":10,"open_issues_count":10,"forks_count":6,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-09-23T14:50:25.800Z","etag":null,"topics":["cplex","cplex-optimization-solver","optimization","python"],"latest_commit_sha":null,"homepage":"https://ibmdecisionoptimization.github.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IBMDecisionOptimization.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"docs/support.html","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-11-25T09:19:54.000Z","updated_at":"2025-07-21T05:44:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"3887f3ba-0fd2-4c1d-8941-18618712ccd8","html_url":"https://github.com/IBMDecisionOptimization/docplex","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/IBMDecisionOptimization/docplex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IBMDecisionOptimization%2Fdocplex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IBMDecisionOptimization%2Fdocplex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IBMDecisionOptimization%2Fdocplex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IBMDecisionOptimization%2Fdocplex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IBMDecisionOptimization","download_url":"https://codeload.github.com/IBMDecisionOptimization/docplex/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IBMDecisionOptimization%2Fdocplex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002359,"owners_count":26083356,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cplex","cplex-optimization-solver","optimization","python"],"created_at":"2025-10-10T00:29:05.754Z","updated_at":"2026-04-01T18:37:07.661Z","avatar_url":"https://github.com/IBMDecisionOptimization.png","language":"Python","readme":"# IBM\u0026reg; Decision Optimization Modeling for Python (DOcplex)\r\n\r\nWelcome to the IBM\u0026reg; Decision Optimization Modeling for Python.\r\nLicensed under the Apache License v2.0.\r\n\r\nWith this library, you can quickly and easily add the power of optimization to\r\nyour application. You need IBM ILOG CPLEX Optimization Studio to solve the models.\r\n\r\nThis library is composed of 2 modules:\r\n\r\n* IBM\u0026reg; Decision Optimization CPLEX Optimizer Modeling for Python - with namespace docplex.mp\r\n* IBM\u0026reg; Decision Optimization CP Optimizer Modeling for Python - with namespace docplex.cp\r\n\r\nThis library is numpy friendly.\r\n\r\n## Prerequisites\r\n\r\n- **Python**: 3.10 or (higher)\r\n\r\n## Installation\r\n\r\n- [DOcplex](https://pypi.org/project/docplex/) (Decision Optimization CPLEX Modeling for Python):\r\n\r\n```bash\r\npip install docplex\r\n```\r\n\r\n- [Cplex](https://pypi.org/project/cplex/)\r\n\r\n```bash\r\npip install cplex\r\n```\r\n\r\nThe Community Edition is free and suitable for learning and small-to-medium problems. However, it has limitations on problem size (1000 variables, 1000 constraints).\r\n\r\n**Note**: For larger problems or commercial use, you'll need the full version of CPLEX Optimization Studio or an academic license.\r\n\r\n### Full Version Installation\r\n\r\nIf you have IBM ILOG CPLEX Optimization Studio installed, you can install the Python API from the installation directory:\r\n\r\n```bash\r\n# Navigate to your CPLEX installation directory\r\ncd \u003cCPLEX_INSTALL_DIR\u003e/python\r\n\r\n# Install the package\r\npython setup.py install\r\n```\r\n\r\nIf CPLEX is installed separately, configure DOcplex:\r\n\r\n```\r\ndocplex config --upgrade \u003cCOS_INSTALL_DIR\u003e\r\n```\r\n\r\nThis ensures DOcplex correctly detects your CPLEX installation.\r\n\r\n\r\nDOcplex provides a higher-level API and works with both CPLEX and IBM Decision Optimization on Cloud. See the [DOcplex examples repository](https://github.com/IBMDecisionOptimization/docplex/tree/master/examples) for more information.\r\n\r\n## Building a Combined docplex + cplex Wheel\r\n\r\nThis section explains how to create a single Python wheel (.whl) that bundles both docplex and cplex packages, enabling simplified distribution and configuration.\r\nThis approach is intended for advanced users who need to package an existing Python environment (for example, a virtual environment containing cplex) into a single wheel.\r\n\r\nBy configuring [setup.cfg](https://github.com/IBMDecisionOptimization/docplex/blob/master/setup.cfg ), you can generate a single wheel that contains both packages.\r\n\r\n```\r\n [options]\r\n-       packages = find:\r\n-       install_requires = six\r\n+package_dir =\r\n+       = \u003cmyPythonEnvironmentPath\u003e/lib/python\u003cmyPythonEnvironmentVersion\u003e/site-packages\r\n+packages = find:\r\n+python_requires = \u003e=3.7\r\n+install_requires = \r\n+       six\r\n+\r\n+[options.packages.find]\r\n+where = \u003cmyPythonEnvironmentPath\u003e/lib/python\u003cmyPythonEnvironmentVersion\u003e/site-packages\r\n+include = cplex*, docplex*\r\n \r\n [options.entry_points]\r\n console_scripts = \r\n        docplex = docplex.util.cli:main\r\n```\r\n### Building the Wheel\r\n\r\nFrom the directory containing setup.cfg, run:\r\n```\r\npip wheel .\r\n```\r\n\r\nThe resulting wheel is fully compatible with:\r\n```\r\ndocplex --config\r\n```\r\nwhich correctly detects and configures the bundled cplex.\r\n\r\n## Get the documentation and examples\r\n\r\n* [Latest documentation](http://ibmdecisionoptimization.github.io/docplex-doc/)\r\n* Documentation archives:\r\n   * [2.23.222](http://ibmdecisionoptimization.github.io/docplex-doc/2.23.222)\r\n   * [2.22.213](http://ibmdecisionoptimization.github.io/docplex-doc/2.22.213)\r\n   * [2.21.207](http://ibmdecisionoptimization.github.io/docplex-doc/2.21.207)\r\n   * [2.20.204](http://ibmdecisionoptimization.github.io/docplex-doc/2.20.204)\r\n   * [2.19.202](http://ibmdecisionoptimization.github.io/docplex-doc/2.19.202)\r\n   * [2.18.200](http://ibmdecisionoptimization.github.io/docplex-doc/2.18.200)\r\n   * [2.16.195](http://ibmdecisionoptimization.github.io/docplex-doc/2.16.195)\r\n* [Examples](https://github.com/IBMDecisionOptimization/docplex-examples)\r\n\r\n## Get your IBM\u0026reg; ILOG CPLEX Optimization Studio edition\r\n\r\n- You can get a free [Community Edition](https://www.ibm.com/account/reg/us-en/signup?formid=urx-20028)\r\n of CPLEX Optimization Studio, with limited solving capabilities in term of problem size.\r\n\r\n- Faculty members, research professionals at accredited institutions can get access to an unlimited version of CPLEX through the\r\n [IBM\u0026reg; Academic Initiative](http://ibm.biz/cplex-free-for-students).\r\n\r\n## Dependencies\r\n\r\nThese third-party dependencies are automatically installed with ``pip``\r\n\r\n- [futures](https://pypi.python.org/pypi/futures)\r\n- [requests](https://pypi.python.org/pypi/requests)\r\n- [six](https://pypi.python.org/pypi/six)\r\n- [certifi](https://pypi.python.org/pypi/certifi)\r\n\r\n\r\n\r\n## License\r\n\r\nThis library is delivered under the  Apache License Version 2.0, January 2004 (see LICENSE.txt).\r\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibmdecisionoptimization%2Fdocplex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibmdecisionoptimization%2Fdocplex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibmdecisionoptimization%2Fdocplex/lists"}