Metadata-Version: 2.4
Name: claire-speech-engine
Version: 1.0.0b1
Summary: A backend-agnostic framework for advanced speech synthesis.
Author: CSE Team
License: MIT
Project-URL: Homepage, https://github.com/Yukariii04/Claire-Speech-Engine
Project-URL: Repository, https://github.com/Yukariii04/Claire-Speech-Engine
Project-URL: Changelog, https://github.com/Yukariii04/Claire-Speech-Engine/blob/main/CHANGELOG.md
Keywords: speech,synthesis,tts,text-to-speech
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: torch
Requires-Dist: numpy
Requires-Dist: onnxruntime
Requires-Dist: sounddevice
Requires-Dist: soundfile
Requires-Dist: pyyaml
Requires-Dist: rich
Requires-Dist: loguru
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-benchmark; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: build; extra == "dev"
Dynamic: license-file

# The Claire Speech Engine (CSE)

**The Claire Speech Engine** is a production-grade, backend-agnostic speech synthesis library built in Python. 

## Installation

```bash
pip install claire-speech-engine
```

To install from source for development:

```bash
git clone https://github.com/Yukariii04/Claire-Speech-Engine.git
cd Claire-Speech-Engine
pip install -e ".[dev]"
```

## Quick Start

The quickest way to see CSE in action is using the CLI or the Python API.

### CLI

```bash
# List available voices
cse voices

# Generate speech
cse speak --voice claire --text "Hello from The Claire Speech Engine."
```

### Python API

```python
from cse import SpeechEngine

engine = SpeechEngine()
engine.load_voice("claire")

speech = engine.speak("Synthesis is now extremely simple.")
if speech.success:
    print(f"Audio saved to: {speech.audio_path}")
```

## Examples

We believe every feature should be easily discoverable. Check the `examples/` directory for runnable scripts:

- `examples/basic.py` — Simple end-to-end synthesis.
- `examples/configuration.py` — How to pass custom overrides and load configurations.
- `examples/list_voices.py` — Querying the local voice registry.
- `examples/generate_speech.py` — Handling output files and moving them dynamically.

## Architecture & Vision

Read these documents to understand the core philosophy and design of the engine:
- [Project Vision Document (PVD-001)](docs/PVDs/PVD-001.md)
- [Architecture Overview](docs/Architecture/ARCHITECTURE.md)

## Roadmap

The Claire Speech Engine (CSE) has officially reached **v1.0.0-beta**. The core framework is now **feature-frozen** to ensure a stable foundation. 

Future development will transition to:
1. **CPE (Claire Performance Engine)**: Prosody, emotion, and dialogue planning.
2. **CSM (Claire Speech Model)**: Core acoustic ML model training.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

---

## Development

### Running Tests
```bash
pytest
```

### Running Benchmarks
```bash
pytest benchmarks/ --benchmark-only
```
*See [docs/Benchmarks/README.md](docs/Benchmarks/README.md) for full performance targets and reports.*
