Metadata-Version: 2.4
Name: nveil
Version: 0.0.1.dev1
Summary: NVEIL Python SDK — no-code AI data visualization with auditable, deterministic results
Author-email: NVEIL <contact@nveil.com>
License: Proprietary
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.25
Requires-Dist: pydantic>=2.0
Requires-Dist: nveil-dive[builder]
Requires-Dist: nveil-choregraph
Requires-Dist: lxml>=4.9
Requires-Dist: xmlschema>=3.0
Requires-Dist: natsort>=8.0
Requires-Dist: pandas>=2.0
Requires-Dist: numpy>=1.24
Requires-Dist: cryptography>=41.0
Requires-Dist: clingo>=5.6
Requires-Dist: plotly>=5.0
Requires-Dist: kaleido>=0.2
Requires-Dist: vtk>=9.0
Requires-Dist: pydeck>=0.8
Requires-Dist: scipy>=1.10
Requires-Dist: kedro>=0.19.0
Requires-Dist: kedro-datasets[pillow]>=3.0.0
Requires-Dist: pyarrow>=22.0.0
Requires-Dist: python-dotenv
Requires-Dist: geopandas
Requires-Dist: geonamescache
Requires-Dist: langdetect
Requires-Dist: simplemma
Requires-Dist: unidecode
Requires-Dist: rapidfuzz
Requires-Dist: scikit-learn>=1.3.0
Requires-Dist: openpyxl
Requires-Dist: pyexcel
Requires-Dist: pyexcel-xlsx
Requires-Dist: pyexcel-xls
Requires-Dist: pyexcel-ods3
Requires-Dist: statsmodels
Provides-Extra: agent
Requires-Dist: watchdog>=3.0; extra == "agent"
Requires-Dist: pystray>=0.19; extra == "agent"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5; extra == "docs"
Requires-Dist: mkdocs-material>=9.0; extra == "docs"
Requires-Dist: mkdocs-section-index>=0.3; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
Dynamic: license-file
Dynamic: requires-dist

# NVEIL Python SDK

**Turn your data into production-ready visualizations in seconds.**

NVEIL is a no-code AI data visualization platform. Describe what you want in plain language, and the SDK generates auditable, deterministic visualizations — no hallucinations, no manual chart building.

Your data stays on your machine. Only metadata (column names, types, and statistics) is sent to the NVEIL server.

## Installation

```bash
pip install nveil
```

## Quickstart

```python
import nveil
import pandas as pd

nveil.configure(api_key="nveil_...")

df = pd.read_csv("sales.csv")
spec = nveil.generate_spec("Revenue by region, colored by quarter", df)

fig = spec.render(df)
nveil.show(fig)

# Save for later — renders offline, no API call
spec.save("revenue.nveil")
```

## Key Features

- **No-code AI** — describe your visualization in plain language.
- **Auditable results** — deterministic output, no hallucinations.
- **Data stays local** — only column names, types, and aggregate statistics are sent. Raw data never leaves your machine.
- **Offline rendering** — once generated, `render()` runs 100% locally with no API call.
- **Reusable specs** — save to `.nveil` files, load later, render on new data.
- **Multi-backend** — auto-detects the best rendering engine (Plotly, VTK, DeckGL).

## Getting an API Key

1. Create an account at [app.nveil.com](https://app.nveil.com)
2. Go to **Settings** in your account
3. Generate an API key

## Documentation

Full documentation: [https://docs.nveil.com](https://docs.nveil.com)

## License

Proprietary. See [LICENSE](LICENSE) for details.
