# Kwork API

Unofficial Python client for Kwork.ru API.

## Features

- Complete async API client (45+ endpoints)
- Pydantic models for all responses
- Two-step authentication (cookies + web_auth_token)
- Comprehensive error handling
- HTTP/2 support

## Installation

```bash
uv add kwork-api
# or
pip install kwork-api
```

## Quick Start

```python
from kwork_api import KworkClient

# Login with credentials
async with await KworkClient.login("username", "password") as client:
    # Get catalog
    catalog = await client.catalog.get_list(page=1)
    
    # Get projects
    projects = await client.projects.get_list()
    
    # Get user info
    user = await client.user.get_info()
```

## Documentation

- [Usage Guide](usage.md) — Examples and best practices
- [API Reference](api-reference.md) — Complete API documentation

## Links

- [Source Code](https://git.much-data.ru/much-data/kwork-api)
- [Issues](https://git.much-data.ru/much-data/kwork-api/issues)
- [Gitea Packages](https://git.much-data.ru/much-data/kwork-api/packages)