Metadata-Version: 2.4
Name: darwin-connect
Version: 0.1.0
Summary: Official Python entry package for Darwin Connect
Author: Darwin
License-Expression: MIT
Project-URL: Documentation, https://docs.darwin.so/connect/overview
Project-URL: Issues, https://github.com/darwin-studios/darwin-connect-python/issues
Project-URL: Repository, https://github.com/darwin-studios/darwin-connect-python
Keywords: darwin,connect,sdk,api
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: darwin-sdk<1.0.0,>=0.1.1
Dynamic: license-file

# Darwin Connect for Python

The official Python entry package for Darwin Connect. It provides explicit
constructors for application credentials and linked-user OAuth grants while
using the complete Fern-generated [`darwin-sdk`](https://pypi.org/project/darwin-sdk/)
contract.

Connect is not a second API. Applications, linked AIs, ephemeral goals,
application wallets, webhooks, and Product resources all share one public
contract and base URL.

## Install

```bash
pip install darwin-connect
```

## Application operations

```python
from darwin_connect import create_application_client

connect = create_application_client(token="YOUR_APPLICATION_TOKEN")
wallet = connect.applications.get_application_wallet(application_id="app_123")
```

## Linked AI operations

```python
from darwin_connect import create_linked_ai_client

darwin = create_linked_ai_client(token=user_access_token)
goals = darwin.goals.list_goals(ai_id="ai_123")
```

Async constructors are available as `create_async_application_client` and
`create_async_linked_ai_client`.

Keep application credentials and refresh tokens on your trusted backend. See
the [Connect documentation](https://docs.darwin.so/connect/overview) for the
authorization and funding model.
