Metadata-Version: 2.2
Name: transmorphai
Version: 0.1.0
Summary: A Python library for AI-powered API data transformation.
Home-page: https://github.com/gimenomarc/TransmorphAI
Author: Marc Gimeno
Author-email: your-email@example.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai
Requires-Dist: python-dotenv
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🚀 TransmorphAI - AI-Powered Data Transformation for APIs  

## 📌 Introduction  

**TransmorphAI** is a Python library designed to **simplify communication between APIs**. Normally, when integrating with an API, developers must strictly follow the API’s documentation, ensuring that their requests match the required data types and structure.  

With **TransmorphAI**, this is no longer necessary. API consumers can **send data in any format** (JSON, XML, plain text) without worrying about how the final API expects it.  

### **🔹 Why Use TransmorphAI?**  
✅ API consumers **don’t need to adapt** to the API provider’s documentation.  
✅ You only need to know **the parameter names**, not their types or format.  
✅ The API receiving the request, which has **TransmorphAI integrated**, will **automatically format and validate** the data before storing it.  
✅ API consumers **don’t need to know the final format**—they just send the data, and **TransmorphAI handles the transformation**.  

---

## 🛠 Features  
✅ **Supports multiple input formats** (JSON, XML, plain text).  
✅ **Automatically formats data** according to the API’s required structure.  
✅ **Detects missing required fields** and alerts if any are missing.  
✅ **Maintains correct data types** (e.g., converts numbers, strings, and lists correctly).  
✅ **Detects input language** and preserves the intended output format.  
✅ **Secure and flexible**, allowing easy integration into any Python-based API.  

---

## 🎯 Use Case Example  

### **Traditional API Integration (Without TransmorphAI)**  
Normally, when consuming an API, developers need to **strictly follow the API documentation** and format their requests **exactly as required**.  

For example, if an API requires:  
```json
{
  "full_name": "John Doe",
  "age": 30,
  "email": "john.doe@example.com"
}
```
The consumer **must** send this exact format, with correct data types and field names.  

If they send:  
```json
{
  "name": "John Doe",
  "years": "30",
  "mail": "john.doe@example.com"
}
```
🚨 **The API will reject it!** 🚨  

---

### **API Integration with TransmorphAI**  
With **TransmorphAI**, the API consumer **doesn’t need to worry about formatting**. They can send:  

✅ **As JSON:**  
```json
{
  "name": "John Doe",
  "years": "30",
  "mail": "john.doe@example.com"
}
```
✅ **As XML:**  
```xml
<user>
  <name>John Doe</name>
  <years>30</years>
  <mail>john.doe@example.com</mail>
</user>
```
✅ **As Plain Text:**  
```
name: John Doe
years: 30
mail: john.doe@example.com
```
👉 **TransmorphAI automatically** converts the input to the correct format required by the API provider:  
```json
{
  "full_name": "John Doe",
  "age": 30,
  "email": "john.doe@example.com"
}
```
✅ **No need to follow API documentation** strictly!  
✅ **Faster integration without error-handling headaches!**  

---

## 📌 Installation  

TransmorphAI will soon be available on PyPI. In the meantime, you can install it manually:  
```bash
pip install TransmorphAI
```
Or clone the repository and install locally:  
```bash
git clone https://github.com/gimenomarc/TransmorphAI.git
cd TransmorphAI
pip install -e .
```

---

## 📜 License  
**MIT License**  

---

## 📞 Contact  
For questions or suggestions, feel free to reach out on [GitHub](https://github.com/gimenomarc)! 🚀  

