Metadata-Version: 2.4
Name: onepin
Version: 0.2.0
Summary: OnePin Python SDK + CLI
Project-URL: Documentation, https://docs.onepin.ai
Project-URL: Source, https://github.com/podonos/onepin-python
Project-URL: Issues, https://github.com/podonos/onepin-python/issues
Project-URL: Changelog, https://github.com/podonos/onepin-python/blob/main/CHANGELOG.md
Author-email: Podonos <kj@podonos.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: httpx<1.0,>=0.27
Requires-Dist: pydantic<3.0,>=2.7
Requires-Dist: rich>=13
Requires-Dist: tomli; python_version < '3.11'
Requires-Dist: typer<1.0,>=0.12
Description-Content-Type: text/markdown

# onepin

Python SDK + CLI for [OnePin](https://onepin.ai) — the AI-powered voice workflow platform.

## Installation

```bash
pip install onepin
```

## Quickstart

Full documentation: [docs.onepin.ai](https://docs.onepin.ai)

### Authentication

Mint an API key at [app.onepin.ai/settings/api-keys](https://app.onepin.ai/settings/api-keys), then:

```bash
onepin login
# Paste your key when prompted — saved to ~/.onepin/credentials (mode 0600)
```

### Common commands

```bash
onepin whoami                          # Show active auth source + workspace
onepin workflows list                  # List workflows
onepin workflows run <id> --watch      # Start a run and stream status
onepin voices list                     # Browse available voices
onepin templates list                  # Browse gallery templates
onepin templates run <id>              # Clone a template and start a run
onepin uploads create --file script.txt --category script
```

Global flags available on every command:

```
--api-key     Override stored credentials
--base-url    Override API base URL (useful for dev/staging)
--workspace   Target workspace UUID
--json        Emit machine-readable JSON instead of rich tables
--no-color    Disable ANSI coloring
-v/--verbose  Log HTTP requests/responses to stderr
--debug       Verbose + full tracebacks on failure
```

## SDK usage

> The SDK surface is generated by Fern from the OpenAPI spec. It will be available after the first Fern regen lands.

```python
from onepin import __version__
print(__version__)
```

## Repository structure

- `src/onepin/` — Fern-generated SDK (do not hand-edit; overwritten on each regen)
- `src/onepin/_cli/` — hand-rolled Typer CLI atop the generated client
- `scripts/post_fern.sh` — restores `py.typed` markers after Fern overwrites `src/onepin/`

## License

MIT — see [LICENSE](LICENSE).

## Status

Pre-launch. First published release: v0.1.0 (pending TestPyPI rehearsal + production publish).
