Metadata-Version: 2.4
Name: instavizlib
Version: 1.0.0
Summary: Intelligent Data Visualization - See truth, not just charts. Auto-selects best charts, provides insights, and creates beautiful visualizations.
Author-email: "Md. Ujayer Hasnat" <dev.ujayerhasnat@gmail.com>
Maintainer-email: "Md. Ujayer Hasnat" <dev.ujayerhasnat@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/CodexUjayer/instavizlib
Project-URL: Documentation, https://github.com/CodexUjayer/instavizlib#readme
Project-URL: Repository, https://github.com/CodexUjayer/instavizlib
Project-URL: Bug Tracker, https://github.com/CodexUjayer/instavizlib/issues
Project-URL: LinkedIn, https://linkedin.com/in/ujayerhasnat
Keywords: visualization,matplotlib,pandas,data-visualization,eda,exploratory-data-analysis,plotting,charts,dataviz,auto-visualization,smart-charts,data-science
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: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: matplotlib>=3.5.0
Requires-Dist: scipy>=1.7.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: isort>=5.0.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Requires-Dist: build>=0.7.0; extra == "dev"
Dynamic: license-file

# 📊 InstaViz - Intelligent Data Visualization

[![PyPI version](https://badge.fury.io/py/instaviz.svg)](https://badge.fury.io/py/instaviz)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**See truth, not just charts.**

InstaViz is a next-generation Python visualization library built on top of Matplotlib that **automatically chooses the best chart type** for your data and provides **natural language insights**.

## ✨ Features

- 🎯 **Smart Auto-Selection** - Automatically picks the best chart for your data
- 📈 **Built-in Insights** - Get natural language explanations of your data
- 🎨 **Beautiful Themes** - Professional themes out of the box (light, dark, minimal, vibrant, corporate)
- 🔍 **One-Line EDA** - Complete exploratory data analysis with `viz.show(df)`
- 📊 **Statistical Annotations** - Automatic outlier detection, trend lines, and statistics
- 🚀 **Zero Configuration** - Works great with sensible defaults

## 📦 Installation

```bash
pip install instaviz

##🚀 Quick Start

```bash

import instaviz as viz
import pandas as pd
import numpy as np

# Create sample data
df = pd.DataFrame({
    'category': ['A', 'B', 'C', 'D'] * 25,
    'value': np.random.randn(100),
    'score': np.random.exponential(50, 100)
})

# 🔍 Automatic EDA - One line to explore your data!
viz.show(df)

# 📊 Smart Plotting - Automatically chooses the best chart
viz.plot(df, x='category', y='value')

# 📈 Distribution Analysis
viz.distribution(df, 'score')

# 🆚 Category Comparison
viz.compare(df, x='category', y='value')

# 🔗 Correlation Heatmap
viz.correlate(df)

## 📖 API Reference

Core Functions
Function	Description
viz.show(df)	Automatic EDA dashboard
viz.plot(df, x, y)	Smart auto-plot
viz.distribution(df, column)	Distribution analysis
viz.compare(df, x, y)	Category comparison
viz.trend(df, date_col, value_col)	Time series trends
viz.correlate(df)	Correlation heatmap
viz.relationship(df, x, y)	Scatter/relationship plots
viz.target(df, target)	Feature vs target analysis
Themes
Python

# Available themes: 'instaviz', 'dark', 'minimal', 'vibrant', 'corporate'
viz.set_theme('dark')
Configuration
Python

viz.set_config(
    figsize=(12, 8),
    show_insights=True,
    auto_annotate=True,
    max_categories=20
)

## 🎨 Example Gallery

Distribution Analysis
Python

viz.distribution(df, 'price', kind='raincloud')
Time Series
Python

viz.trend(df, 'date', 'revenue', smooth=3)
Relationship with Grouping
Python

viz.relationship(df, 'age', 'income', hue='education')

## 📋 Requirements

Python >= 3.8
NumPy >= 1.20.0
Pandas >= 1.3.0
Matplotlib >= 3.5.0
SciPy >= 1.7.0

## 👨‍💻 Author

Md. Ujayer Hasnat

📧 Email: dev.ujayerhasnat@gmail.com
💼 LinkedIn: linkedin.com/in/ujayerhasnat
🐙 GitHub: github.com/CodexUjayer

## 📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## ⭐ Star History

If you find this project useful, please consider giving it a star on GitHub!

