Metadata-Version: 2.1
Name: flowspeech-cli
Version: 0.1.0
Summary: Command-line client for FlowSpeech text to speech.
Home-page: https://flowspeech.io/
Author: FlowSpeech
Author-email: waeckerlinfederowicz66@gmail.com
License: MIT
Project-URL: Homepage, https://flowspeech.io/
Project-URL: Documentation, https://flowspeech.io/
Project-URL: Issues, https://flowspeech.io/
Keywords: flowspeech,text-to-speech,tts,ai-voice,voiceover
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# flowspeech-cli

`flowspeech-cli` is a small command-line client for [FlowSpeech](https://flowspeech.io/), a context-aware text to speech tool for generating human-like audio with voice, emotion, and pause control.

The CLI calls FlowSpeech's public text-to-speech endpoint and writes the returned audio to a local file. It does not contain provider API keys and does not ask for Gemini, FAL, Azure, or ElevenLabs credentials.

## Install

```bash
pip install flowspeech-cli
```

For local development from this repository:

```bash
python -m pip install -e packages/flowspeech-cli
```

## Usage

Generate speech from inline text:

```bash
flowspeech synthesize "FlowSpeech turns scripts into natural audio." --voice Kore --out speech.wav
```

Generate speech from a text file:

```bash
flowspeech synthesize --file script.txt --out narration.wav
```

Check CLI configuration:

```bash
flowspeech doctor
```

Use a different FlowSpeech-compatible endpoint:

```bash
flowspeech synthesize "Hello" --api-url https://flowspeech.io/api/ai/text-to-speech --out hello.wav
```

## Privacy And Credentials

- No third-party provider API keys are bundled or requested.
- No local authentication token is saved by default.
- Input text is sent to the configured FlowSpeech API endpoint for speech generation.
- Output audio is written only to the path you pass with `--out`.

## Status

This is an early CLI for FlowSpeech. The default command supports single-speaker generation. Multi-speaker helpers and authenticated account workflows can be added later without changing the no-provider-key boundary.

## Releasing

See [RELEASE.md](./RELEASE.md) for TestPyPI and PyPI preparation. Publishing requires a PyPI API token handled outside the repository; do not commit credentials or generated distributions.


