Metadata-Version: 2.5
Name: radiens-core
Version: 0.1.0b1
Summary: Python client for Radiens neuroscience platform
Project-URL: Homepage, https://radiens.ai
Project-URL: Documentation, https://neuronexus.github.io/radiens-core-python/latest/
Author-email: NeuroNexus <akelley@neuronexus.com>
License-File: LICENSE
Keywords: data-analysis,electrophysiology,neuroscience
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.12
Requires-Dist: boto3>=1.34
Requires-Dist: grpc-interceptor>=0.15
Requires-Dist: grpcio>=1.71
Requires-Dist: numpy>=1.26
Requires-Dist: pandas>=2.2
Requires-Dist: protobuf>=5.29
Requires-Dist: pydantic>=2.6
Requires-Dist: tqdm>=4.65
Description-Content-Type: text/markdown

# radiens-core

**A typed Python client for the Radiens electrophysiology platform.**

`radiens-core` is the base package of RadiensPy, the Radiens Python packages. It gives Python scripts and Jupyter notebooks access to the same acquisition, analysis, and curation workflows available in the [Radiens](https://radiens.ai/products) desktop applications (Allego, Videre).

> **Note:** This package is pre-1.0. Releases may change or remove APIs; check the changelog before upgrading. Some features need a recent Radiens release and raise `CapabilityError` on an older one.

## Quick Example

```python
from radiens_core import AllegoClient

with AllegoClient() as client:
    client.healthcheck()
    status = client.get_status()
    print(f"Streaming: {status.streaming.stream_mode}")
    print(f"Recording: {status.recording.record_mode}")
```

All public methods return typed Python objects with strong IDE autocomplete and inline documentation support.

## Installation

```bash
pip install radiens-core
```

Requires **Python 3.12+**.

## Prerequisites

Use with a local [Radiens](https://radiens.ai/resources/downloads) desktop application:

- **Allego** — real-time acquisition (`AllegoClient`)
- **Videre** — offline file analysis, curation, and transformation (`VidereClient`)

See the [Radiens downloads page](https://radiens.ai/resources/downloads) for information on software download and installation.

## Key Capabilities

| Client | Purpose |
| --- | --- |
| `AllegoClient` | Control streaming and recording, retrieve live signals, select channels, configure DSP filters, compute live signal-quality (KPI) metrics, control spike sorting, manage stimulation, read hardware diagnostics |
| `VidereClient` | Link recorded files, retrieve signal segments, select channels, apply filters, compute signal-quality and spectral metrics, run spike sorting and read spikes and units, read dataset provenance; filter, re-reference, downsample, and slice datasets, with bulk operations and reusable transform protocols |

## Documentation

Full API reference, getting-started guide, and examples: <https://neuronexus.github.io/radiens-core-python/latest/>

## Support

- **Web**: [Contact Us](https://radiens.ai/contact)
- **Email**: <support@neuronexus.com>

## License

This project is licensed under the terms described in the LICENSE file included with this distribution.
