Metadata-Version: 2.1
Name: perspective-bi
Version: 0.1.0
Summary: A declarative business intelligence library designed for natural language interactions
Home-page: https://github.com/perspective-bi/perspective-bi
Author: Robert Ritz
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas>=2.0.0
Requires-Dist: plotly>=5.13.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: python-dateutil>=2.8.2

# Perspective BI

A declarative business intelligence library designed for natural language interactions. Perspective BI provides a clean, intuitive API for data transformation and visualization, making it easy to create beautiful dashboards from natural language queries.

## Installation

```bash
pip install perspective-bi
```

## Quick Start

```python
import perspective_bi as px

# Load and transform data
sales_data = (
    px.DataSet('sales.csv')
    .filter(date='last_month')
    .aggregate(group_by=['category'])
    .sort_values('sales', ascending=False)
)

# Create visualization
chart = px.bar(
    data=sales_data,
    x='category', 
    y='sales',
    title='Sales by Category'
)

# Display in notebook or save
chart.show()
```

## Features

- **Declarative API**: Simple, intuitive interface for data manipulation and visualization
- **Natural Language Ready**: Designed to work seamlessly with LLM-generated instructions
- **Powerful Data Transformations**: Built on pandas with an intuitive API
- **Beautiful Visualizations**: Leverages Plotly for interactive charts
- **Flexible Data Sources**: Support for CSV, Excel, and more

## Documentation

### DataSet Operations

- `filter()`: Filter data based on conditions
- `aggregate()`: Group and aggregate data
- `sort_values()`: Sort data by columns
- `save()`: Save transformed data

### Visualizations

- `bar()`: Create bar charts
- `line()`: Create line charts
- `scatter()`: Create scatter plots
- `pie()`: Create pie charts

## License

MIT License
