Metadata-Version: 2.4
Name: zohencel-ai
Version: 0.5.1
Summary: World's First 'Text to ML Model' Chat Application
Home-page: https://zohencelai.github.io/
Author: Vishnu K
Author-email: Vishnu K <vishnuknandanam@gmail.com>
License: MIT License
        
        Copyright (c) 2024 Vishnu K
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        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 NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://zohencelai.github.io/
Project-URL: Documentation, https://zohencelai.github.io/
Project-URL: Source, https://github.com/Vishnuk4906/zohencel-ai
Project-URL: Bug Tracker, https://github.com/Vishnuk4906/zohencel-ai/issues
Project-URL: PyPI, https://pypi.org/project/zohencel-ai/
Keywords: machine learning,ML bot,text to ML,voice assistant,chart bot,data analysis,groq,llm,ai,zohencel,automl
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: groq>=0.9.0
Requires-Dist: requests>=2.31.0
Requires-Dist: fastapi>=0.104.0
Requires-Dist: uvicorn[standard]>=0.24.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: scikit-learn>=1.3.0
Requires-Dist: streamlit>=1.28.0
Requires-Dist: SpeechRecognition>=3.10.0
Requires-Dist: pyttsx3>=2.90
Requires-Dist: assemblyai>=0.20.0
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: seaborn>=0.12.0
Requires-Dist: Pillow>=10.0.0
Requires-Dist: black>=23.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

<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)



