Metadata-Version: 2.4
Name: tawala-gov
Version: 0.1.1
Summary: Python SDK for Tawala.ai
Project-URL: Homepage, https://github.com/tawalai/tawala
Author-email: Tawala dev team <info@tawala.ai>
License: Tawala Custom Source-Available License v1.0
        
        Copyright (c) 2025 Tawala.ai
        All rights reserved.
        
        -------------------------------------------------------------------------------
        
        1. Definitions
        
        "Software" means the source code, object code, documentation, and any other
        materials contained in this repository, known as the "Tawala Platform Connector".
        
        "Licensor" means Tawala.ai.
        
        "You" means any individual or legal entity exercising permissions granted
        by this License.
        
        "Platform" means the Tawala AI Governance Platform operated by the Licensor.
        
        "Competing Service" means any product or service that offers AI governance,
        AI risk management, AI compliance, or AI management system capabilities
        substantially similar to the Platform.
        
        -------------------------------------------------------------------------------
        
        2. Grant of Rights
        
        Subject to the terms and conditions of this License, the Licensor grants You
        a non-exclusive, non-transferable, non-sublicensable, royalty-free right to:
        
        a) View, download, and modify the Software for internal use;
        
        b) Use the Software to connect systems, applications, or services to the
           Tawala Platform;
           
        c) Deploy the Software internally within your organization.
        
        -------------------------------------------------------------------------------
        
        3. Limitations
        
        You may NOT:
        
        a) Use the Software to provide a Competing Service;
        
        b) Offer the Software as part of a hosted or managed service that competes
           with the Platform;
           
        c) Sell, license, sublicense, or distribute the Software to third parties,
           whether in source or binary form;
           
        d) Remove, alter, or obscure any licensing, copyright, or branding notices;
        
        e) Represent the Software or any derivative work as an official Tawala product.
        
        -------------------------------------------------------------------------------
        
        4. Derivative Works
        
        You may create derivative works of the Software solely for internal use,
        provided that such derivative works remain subject to this License.
        
        No rights are granted to distribute derivative works.
        
        -------------------------------------------------------------------------------
        
        5. Contributions
        
        Unless otherwise agreed in writing, any contribution intentionally submitted
        to the Licensor shall be licensed to the Licensor under the terms of this License,
        with the right for the Licensor to relicense such contributions at its discretion.
        
        -------------------------------------------------------------------------------
        
        6. Intellectual Property
        
        This License does not grant any rights to the Licensor’s trademarks, service
        marks, or branding, including the name "Tawala" or "Tawala.ai".
        
        -------------------------------------------------------------------------------
        
        7. Disclaimer of Warranty
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
        
        -------------------------------------------------------------------------------
        
        8. Limitation of Liability
        
        IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY DAMAGES ARISING OUT OF OR
        IN CONNECTION WITH THE SOFTWARE, INCLUDING BUT NOT LIMITED TO DIRECT,
        INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES.
        
        -------------------------------------------------------------------------------
        
        9. Termination
        
        This License is automatically terminated if You breach any of its terms.
        Upon termination, You must cease all use of the Software and destroy all copies.
        
        -------------------------------------------------------------------------------
        
        10. Governing Law
        
        This License shall be governed by and construed in accordance with the laws
        of the European Union and, where applicable, the laws of Italy.
        
        -------------------------------------------------------------------------------
        
        11. Contact
        
        For licensing inquiries, contact: info@tawala.ai
License-File: LICENSE.md
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: hatch>=1.16.5
Requires-Dist: pydantic
Requires-Dist: requests
Description-Content-Type: text/markdown

![Tawala Logo](./tawala_logo.svg)

# Tawala AI SDK

Official Tawala SDK and platform connector. Provides secure APIs, data models, and governance-aware mechanisms to exchange AI-related data with the Tawala Platform.

## Description

Tawala https://www.tawala.ai/ is a comprehensive platform for AI governance and risk management. This Python SDK serves as the official client library, enabling developers to programmatically interact with the Tawala platform. It offers secure APIs for managing AI models, systems, risk instances, treatments, and more, ensuring compliance and governance in AI deployments.

Key features include:
- Authentication and secure API access
- Data models for AI-related entities
- Repository classes for CRUD operations on platform resources
- Utility functions for HTTP communication

## Installation

The "pip install tawala" will be soon available, in the meanwhile you can clone and copy this repo.

## Usage

After installation, you can import and use the client:

```python
from tawala import Client

# Initialize the client with your credentials
client = Client(api_key="your-api-key")

# Example: List AI models
models = client.models.list()
```

## Examples

The `examples/` folder contains sample scripts to help you get started with common operations:

- `add_risk_instance.py`: Demonstrates how to create and add a new risk instance to the platform.
- `list_models.py`: Shows how to retrieve and display a list of available AI models.

Run these examples after installing the package to see the SDK in action.

## Next Steps

- **Get Started**: Follow the installation steps above and run the example scripts.
- **API Documentation**: Refer to the docstrings in the source code or visit the official Tawala documentation for detailed API references.
- **Authentication**: Obtain your API key from the Tawala platform dashboard.
- **Contributing**: Report bugs or feature requests on the project's issue tracker.
- **Updates**: Check the CHANGELOG.md for the latest changes and version history.

## License

This project is licensed under the Tawala Custom Source-Available License. See the LICENSE.md file for details.

## Contacts

For any information please contact the Tawala.ai team at info@tawala.ai
