Metadata-Version: 2.1
Name: neptyne-kernel
Version: 0.1.8a3
Summary: The Neptyne kernel
Project-URL: Homepage, https://neptyne.com
Project-URL: Documentation, https://docs.neptyne.com
Project-URL: Repository, https://github.com/neptyneco/neptyne-kernel.git
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: google-api-python-client
Requires-Dist: google-auth-httplib2
Requires-Dist: httpx
Requires-Dist: ipykernel
Requires-Dist: ipython
Requires-Dist: jupyter-client
Requires-Dist: libcst
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: Pillow
Requires-Dist: plotly
Requires-Dist: pydeck
Requires-Dist: pygments
Requires-Dist: pyflakes ~=2.5.0
Requires-Dist: pyjwt
Requires-Dist: stack-data
Requires-Dist: tokenize-rt
Requires-Dist: untokenize
Provides-Extra: extras
Requires-Dist: altair ; extra == 'extras'
Requires-Dist: anthropic ; extra == 'extras'
Requires-Dist: black ; extra == 'extras'
Requires-Dist: bokeh ; extra == 'extras'
Requires-Dist: bs4 ; extra == 'extras'
Requires-Dist: croniter ; extra == 'extras'
Requires-Dist: db-dtypes ; extra == 'extras'
Requires-Dist: descartes ; extra == 'extras'
Requires-Dist: fastavro ; extra == 'extras'
Requires-Dist: geopy ; extra == 'extras'
Requires-Dist: google-generativeai ; extra == 'extras'
Requires-Dist: graphlib ; extra == 'extras'
Requires-Dist: html5lib ; extra == 'extras'
Requires-Dist: json-fix ; extra == 'extras'
Requires-Dist: mapboxgl ; extra == 'extras'
Requires-Dist: mapclassify ; extra == 'extras'
Requires-Dist: markdown ; extra == 'extras'
Requires-Dist: matplotlib ; extra == 'extras'
Requires-Dist: networkx ; extra == 'extras'
Requires-Dist: openai ; extra == 'extras'
Requires-Dist: openpyxl ; extra == 'extras'
Requires-Dist: orjson ; extra == 'extras'
Requires-Dist: qrcode ; extra == 'extras'
Requires-Dist: reflex ; extra == 'extras'
Requires-Dist: scikit-learn ; extra == 'extras'
Requires-Dist: scipy ; extra == 'extras'
Requires-Dist: seaborn ; extra == 'extras'
Requires-Dist: tweepy ; extra == 'extras'
Requires-Dist: streamlit ~=1.36.0 ; extra == 'extras'
Requires-Dist: folium ; extra == 'extras'
Requires-Dist: feedparser ; extra == 'extras'
Requires-Dist: geodatasets ; extra == 'extras'
Requires-Dist: geopandas ; extra == 'extras'
Requires-Dist: geoplot ; extra == 'extras'
Requires-Dist: google-cloud-bigquery ; extra == 'extras'
Requires-Dist: google-cloud-bigquery-storage ; extra == 'extras'
Requires-Dist: iexfinance ; extra == 'extras'
Requires-Dist: lxml ; extra == 'extras'
Provides-Extra: formulas
Requires-Dist: bahttext ; extra == 'formulas'
Requires-Dist: calweek ; extra == 'formulas'
Requires-Dist: isoweek ; extra == 'formulas'
Requires-Dist: jaconv ; extra == 'formulas'
Requires-Dist: pyxirr ; extra == 'formulas'
Requires-Dist: roman ; extra == 'formulas'
Requires-Dist: statsmodels ; extra == 'formulas'

# The Neptyne Kernel

This package contains everything shipped in a [Neptyne](https://neptyne.com) kernel container. Running outside of a Neptyne context isnt fully supported yet, but this may prove useful for some advanced use cases.

## Installing

Neptyne kernels use Python 3.11, so this is the only version currently supported.

```python
python3.11 -m venv venv
. venv/bin/activate
pip install -r neptyne_kernel/requirements.txt # or pip install uv && uv pip install -r neptyne_kernel/requirements.txt
```

## Usage

In Neptyne containers, you'd typically import the API using

```
import neptyne as nt
```

Outside of this context, you'll need to do something like

```
import neptyne_kernel.neptyne_api as nt
```

### Local Kernels + Google Sheets

You can configure the Neptyne kernel to run in a Jupyter notebook, and connect it to a Google sheet. To do so, first install the Neptyne kernel spec:

```shell
neptyne_kernel_spec=$(python -c 'import neptyne_kernel, pathlib; print(pathlib.Path(neptyne_kernel.__file__).parent / "kernel_spec" / "neptyne")')
jupyter kernelspec install $neptyne_kernel_spec
```

Then, in a Jupyter notebook, select "Neptyne" as your kernel type. After obtaining an API key from a Google Sheet using the Neptyne extension, you can connect your notebook to your sheet using:

```python
import neptyne as nt

nt.connect_kernel("<api key>")
```

in your notebook.
