Metadata-Version: 2.4
Name: friendify-sdk
Version: 0.1.0
Summary: Python SDK for Friendify API
Project-URL: Homepage, https://friendify.app
Author-email: Friendify <contact@friendify.app>
Requires-Python: >=3.8
Requires-Dist: requests>=2.25.0
Description-Content-Type: text/markdown

# Friendify Python SDK

The official Python SDK for the Friendify API. Build rich integrations and bots for the Friendify ecosystem.

## Installation

```bash
pip install friendify-sdk
```
*(Or clone the repository and install locally via `pip install .`)*

## Quick Start

Initialize the client with your access token (or bot token):

```python
from friendify.client import FriendifyClient

client = FriendifyClient(token="YOUR_TOKEN_HERE")

# Get current user profile
me = client.users.get_me()
print(me)

# Search users
search_results = client.users.search(query="john", limit=5)
print(search_results)

# Execute a bot action in a group
action_result = client.groups.send_message(group_id="GROUP_ID_HERE", content="Hello from Python!")
print(action_result)

# Award XP to the user
xp_result = client.xp.award(action="DAILY_LOGIN", multiplier=1.5)
print(xp_result)
```

## Resources

- **`client.users`**: Manage users, fetch profiles, search, and check limits.
- **`client.groups`**: Manage group bots, roles, and execute bot actions.
- **`client.xp`**: Award XP for users completing specific actions.
- **`client.notify`**: Dispatch push notifications.

All methods are documented thoroughly with Docstrings, providing autocomplete and tooltips in your IDE.
