# Get Started with the Shade Python SDK

Shade offers a full-featured python SDK that enables you to access any part of your workspace including files, metadata, members, searches, and more. 

### Installing the Shade Python SDK

Our SDK supports Python 3.8+.  Once you have successfully installed Python on your machine, you can install below:

```
pip install shade-python-sdk
```

### Authenticating with the Python SDK

You can obtain an API key for the Shade Python SDK from your workspace and generating a new key.

{% hint style="warning" %}
Please keep in mind that this is a secret key and should not be shared publically or stored in a public repository. 
{% endhint %}

<figure><img src="/files/tlENe0aZxr5brYveeoER" alt=""><figcaption><p>You can access your API Keys by going to Settings > API Keys</p></figcaption></figure>

### Initializing Shade

You can easily initialize the Shade SDK by initializing a Shade object. This will authenticate and authorize as your user - whatever you have access to, the object will have access to.&#x20;

```
API_KEY = 'sk....'
REMOTE_URL = 'https://api.shade.inc'
shade = Shade(remote_url=REMOTE_URL, api_key=API_KEY)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.shade.inc/developers/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.