zohencel-ai 0.4.49
World's first 'Text to ML model' support library. Also comes with an analysis chart bot that plots graphs from your data through queries and a completely customizable AI voice assistant.
Requires Python: >=3.9

<div style="text-align: center;">
  <img src="https://raw.githubusercontent.com/Vishnuk4906/zohencel-ai-utils/main/zailogo.PNG" alt="Zohencel-AI Logo" style="max-width:150px; max-height:80px;">
</div>

# Zohencel-AI

[![PyPI version](https://img.shields.io/pypi/v/zohencel-ai)](https://pypi.org/project/zohencel-ai/)
[![Total Downloads](https://static.pepy.tech/badge/zohencel-ai)](https://pepy.tech/project/zohencel-ai)
[![Downloads](https://img.shields.io/pypi/dm/zohencel-ai?cacheSeconds=3600)](https://pepy.tech/project/zohencel-ai)
[![Python Versions](https://img.shields.io/pypi/pyversions/zohencel-ai)](https://pypi.org/project/zohencel-ai/)
[![License](https://img.shields.io/pypi/l/zohencel-ai)](https://pypi.org/project/zohencel-ai/)

**World's First 'Text to ML Model' Chat Application**

*Zohencel-AI* World's first 'Text to ML model' support library. Also comes with an analysis chart bot that plots graphs from your data through queries and a completely customizable AI voice assistant.

---

## This is where the search ends!

## HOME PAGE & DOCUMENTATION
- https://zohencelai.github.io/

### What is new?
- **ML Bot**:Zohencel AI ML Bot is a revolutionary tool designed to make building machine learning models as simple as having a conversation. With the ML Bot, even beginners can easily create, train, and deploy machine learning models. The bot not only guides you through the process but also automates all necessary steps to ensure a seamless experience.No worries! ML Bot will interact with you to understand exactly what model you want to build, even if you're a complete beginner. That's not all. Every next step is a surprise!! The bot performs all the necessary statistical analysis, creates a machine learning pipeline, and executes it seamlessly. If this is not revolutionary, then what is? I wish you will wonder, if these features are available in the community edition, what awaits you in the prime edition!
- Get your key now : https://console.groq.com/keys

### Key Feature
- **ML Bot** : A chat bot simplify the ML model development and usage.
- **Voice Assistant Tools**: Voice assistant in single import.
- **Data Analysis**: Data analytics tool to visualize and query data in natural language.

---

## Installation

To install `zohencel-ai`, use the following pip command:

```bash
pip install zohencel-ai
```
---
# 1) Zohencel AI - ML Bot (Community Edition)

```python

from zohencel_ai.mlbot.bot import ZohencelmlBot
bot = ZohencelmlBot()
bot.run()

```
## Features
1. **Interactive Model Creation**:
   - ML Bot interacts with you to understand your requirements.
   - Provides guidance even if you're new to machine learning.
![Sample 1](https://raw.githubusercontent.com/Vishnuk4906/zohencel-ai-utils/main/mlbot_1.png)
2. **Automated Statistical Analysis**:
   - Performs statistical and descriptive analysis of your data.
   - Suggests the best practices for model training.
![Sample 1](https://raw.githubusercontent.com/Vishnuk4906/zohencel-ai-utils/main/mlbot_2.png)
3. **ML Training Pipeline**:
   - Automatically creates and executes a machine learning pipeline.
   - Handles all necessary data transformations for model training.
4. **Model and Script Generation**:
   - Saves the trained model as a `.pkl` file.
   - Generates training and testing scripts, along with descriptive analysis.
   - Provides accuracy metrics and an overview of the trained model.
5. **Downloadable Files**:
   - Models and associated files can be downloaded anytime from the Models tab.
   - Statistical analysis and script content are easily accessible and copiable.
![Sample 1](https://raw.githubusercontent.com/Vishnuk4906/zohencel-ai-utils/main/mlbot_3.png)
6. **Portability**:
   - The generated training data and scripts can be used in other environments.
   - The pickle file is ready for API development with the included test script.

## Limitations
- **Community Edition**:
  - Supports only regression and classification problems.
  - Works exclusively with scikit-learn algorithms.
  - Operates as a local API accessed via the [ML Bot Portal](https://zohencelai.github.io/MLBot).
  - Limited by data size and training time.

- **Prime Edition**:
  - Offers advanced features, including custom training logic and access to a wider range of algorithms.
  - Provides enhanced integration capabilities and overcomes limitations of the community edition.
## 2) AI Voice Assistant

The `VoiceAssistant` in `Zohencel-AI` provides a customizable, voice-enabled assistant that listens to user input, processes it, and responds with spoken text. Designed to be adaptable, the assistants attributesâ€”such as name, tone, purpose, and voice typeâ€”can be tailored to fit a wide range of use cases, making it suitable for personalized or business-focused applications.

### Key Customizations
- **Assistant Name**: Set a unique name for the assistant, making interactions feel more personalized and relatable.
- **User Name**: Personalize responses by specifying the userâ€™s name, enhancing engagement.
- **Tone and Duty**: Define the assistantâ€™s tone and duty with an optional description. For example, set it as a "helpful and friendly guide" or an "informative support assistant" to adjust the assistant's personality.
- **Voice Type**: Choose between a â€˜maleâ€™ or â€˜femaleâ€™ voice to best suit the assistant's character and user preferences.

### Usage Example

Here's how to configure these options when creating and running your assistant:

```python
from zohencel_ai import VoiceAssistant

# Initialize the VoiceAssistant
assistant = VoiceAssistant()

# Run the assistant with custom settings
assistant.run(
    voice='female',                # Voice type: 'female' or 'male'
    assistant_name='Zohencel',     # Assistant's name
    user_name='Alex',              # User's name for personalized responses
    description='I am here as your friendly and reliable AI guide.'  # Assistant's tone and purpose
)
```
- all the parameters are optional and you can just run it by calling assistant.run() 


# 3) Chart Bot 

**Chart Bot** is your ultimate data companion! Whether you're a beginner or a seasoned professional, this intelligent tool simplifies the process of understanding, querying, and visualizing your data. Designed with accessibility and functionality in mind, Chart Bot empowers users to harness the full potential of their data without the steep learning curve of advanced libraries like Matplotlib and Seaborn.  

---
Start using **Chart Bot** with just a few lines of code:  

```python
from zohencel_ai.analysis import Analysischartbot

bot = Analysischartbot()
bot.run()
```
## Key Features

- **Effortless Data Exploration**: Understand your dataset with simple queriesâ€”no coding expertise required!
- **Intelligent Visualizations**: Generate beautiful, insightful charts and graphs for machine learning processes like Exploratory Data Analysis (EDA).
- **Beginner-Friendly**: Ideal for users unfamiliar with visualization tools like Matplotlib or Seaborn.
- **Preprocessing Made Easy**: Simplify common ML preprocessing tasks, such as:
  - Feature engineering
  - Missing value treatment
  - Distribution analysis
- **Seamless Workflow**: Save time and effort by streamlining the data understanding process before diving into modeling.

---

## ðŸ”§ How It Works

1. **Upload Your Data**: Provide your dataset in a compatible format (CSV, Excel, etc.).
2. **Query the Data**: Use intuitive commands to filter, analyze, and understand your data.
3. **Visualize**: Create stunning charts and graphs to uncover trends and distributions.
4. **Preprocess**: Execute essential ML preprocessing tasks with built-in tools.
5. **Limitations**: Memory context is not available in the current version, it will be in the upcoming version.So provide the query in full contetxt.
## ðŸ“¸ Sample Images

Here are some demo images showcasing the functionality of **Chart Bot** using Titanic dataset:

1. **Sample 1**:  
![Sample 1](https://raw.githubusercontent.com/Vishnuk4906/zohencel-ai-utils/main/demo_1.png)

2. **Sample 2**:  
![Sample 2](https://raw.githubusercontent.com/Vishnuk4906/zohencel-ai-utils/main/demo_2.png)

## Author

### Vishnu K

A passionate AI/ML developer with a strong zeal for innovation and learning. I believe in exploring new technologies and enhancing my knowledge every day. My journey revolves around creating impactful solutions through the power of AI and Machine Learning.

Feel free to connect with me!

[LinkedIn](https://www.linkedin.com/in/vishnu-k-8a058425b/) | [Gmail](mailto:vishnuknandanam@gmail.com) | [GitHub](https://github.com/Vishnuk4906)