AlonixAPI 1.0
Python API hub | AlonixAPI
Requires Python: >=3.7

# AlonixAPI 🚀  

Welcome to **AlonixAPI**, your gateway to simple and fun AI-powered tools! AlonixAPI provides various utilities, from AI-powered chatbots to password generation and Morse code encoding/decoding.  

---

## Installation  

To get started, you can install AlonixAPI using **pip**:  
```
pip install AlonixAPI
```
Or, clone the repository directly:  
```
git clone https://github.com/BirBeyfendi/AlonixAPI
```

Make sure to upgrade the package if needed:  
```
pip install --upgrade AlonixAPI
```

---

## ⚠️ Note on AI Capabilities  

### 🧠 **Know What to Expect**  
AlonixAPI provides basic AI functionalities such as `chatgpt`, `gemini`, and `datagpt`.  

> **Key Points to Consider:**  
> - These AIs are designed for **basic speech tasks** and can be considered an average model like **GPT-2**.
> - **It may not be suitable for advanced reasoning** or **complex problem-solving tasks**.
> - Perfect for **lightweight interactions**, **simple text creation** and **fun tools**.

### ✅ Recommended Use Cases  
✔️ Casual conversations  
✔️ Simple text outputs  
✔️ Fun features like mode-based chats or random password generation  

**Note:** If you’re looking for advanced AI capabilities, you might need a different solution.

---

## Features & Examples  

### 1. **ChatGPT AI** 🤖
```
from AlonixAPI import api

# Generate text using ChatGPT
response = api.chatgpt("Write a simple basic HTML website")
print(response)

# Use modes for a customized chat experience
# Available modes: "girlfriend", "anime", "animev2", "flirt", "santa", "elonmusk"
response = api.chatgpt("Hi babe", "girlfriend")
print(response)
```

### 2. **Gemini AI** 🤖  
```
from AlonixAPI import api

# Generate code using Gemini AI
response = api.gemini("Write a Flask app")
print(response)
```

### 3. **Chatbot AI** 🤖  
```
from AlonixAPI import api

# Basic chatbot response
print(api.chatbot("Hi there!"))
```

### 4. **Datagpt AI** 📊  
```
from AlonixAPI import api

# Ask data-related questions
response = api.datagpt("What is data science?")
print(response)
```

### 5. **Morse Code Encode/Decode**  
```
from AlonixAPI import api

# Encode text into Morse code
encoded = api.morse_encode("Hello World")
print(encoded)

# Decode Morse code into text
decoded = api.morse_decode(".... . .-.. .-.. --- / .-- --- .-. .-.. -..")
print(decoded)
```

### 6. **Password Generator** 🔑  
```
from AlonixAPI import api

# Generate a random password
print(api.password())

# Generate a password of a specific length
print(api.password(12))
```

### 7. **Time Function** 🕒  
```
from AlonixAPI import api

# Get the current time for a city
time = api.gettime("Istanbul")
print(time)
```

---

## Full List of Functions  

1. **chatgpt(args)** - Execute ChatGPT AI functionality.  
2. **gemini(args)** - Execute Gemini AI functionality.  
3. **chatbot(args)** - A basic chatbot.  
4. **datagpt(args)** - Answer data-related queries.
5. **morse_encode(args)** - Encode text into Morse code.
6. **morse_decode(args)** - Decode Morse code into text.  
7. **password(length)** - Generate a random password (default length: 8).
8. **gettime(city)** - Return the current time for a given city.  
9. **truth()** - Generate a random truth question.  
10. **dare()** - Generate a random dare challenge.  

---

## Support  

If you have any questions or need assistance, feel free to join our support group:  

[![Support](https://img.shields.io/badge/Support-Group-red.svg?style=for-the-badge&logo=Telegram)](https://telegram.me/HerTeldenBotlarSupport)  

---

## Author  

**AlonixAPI** is developed and maintained by **BirBeyfendi**.  
© 2024-25  

---

**Enjoy coding with AlonixAPI! 🚀**