Skip to main content

Oracle Cloud Infrastructure Python SDK

Project description


This is the Python SDK for Oracle Cloud Infrastructure. Supported Python versions are mentioned here.

>>> import oci
# Set up config
>>> config = oci.config.from_file(
...     "~/.oci/config",
...     "DEFAULT")
# Create a service client
>>> identity = oci.identity.IdentityClient(config)
# Get the current user
>>> user = identity.get_user(config["user"]).data
>>> print(user)
  "compartment_id": "ocid1.tenancy.oc1...",
  "description": "Test user",
  "id": "ocid1.user.oc1...",
  "inactive_status": null,
  "lifecycle_state": "ACTIVE",
  "name": "",
  "time_created": "2016-08-30T23:46:44.680000+00:00"

The project is open source and maintained by Oracle Corp. The home page for the project is here.


It is highly recommended that a Python virtual environment be used when installing oci.

Please consult the Installing packages using pip and virtualenv guide from the Python Software Foundation for more information about virtual environments.

See the installation guide for installation troubleshooting and alternative install methods.

Once your virtual environment is active, oci can be installed using pip.

pip install oci


See the development readme for information on how to make changes, run tests and build the documentation and wheel for the Python SDK.


Examples can be found here.


Full documentation, including prerequisites and installation and configuration instructions, can be found here.

API reference can be found here.

A downloadable version of the documentation is include with in the release zip, which can be found here.


See the “Questions or Feedback” section here.




oci-python-sdk is an open source project. See CONTRIBUTING for details.

Oracle gratefully acknowledges the contributions to oci-python-sdk that have been made by the community.

Known Issues

You can find information on any known issues with the SDK here and under the “Issues” tab of this project’s GitHub repository.


Are you a Developer using the OCI SDK? If so, please fill out our survey to help us make the OCI SDK better for you. Click here for the survey page.


Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at or Apache License 2.0 as shown at You may choose either license.

See LICENSE for more details.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oci-2.129.4.tar.gz (13.1 MB view hashes)

Uploaded Source

Built Distribution

oci-2.129.4-py3-none-any.whl (26.9 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page