Metadata-Version: 2.4
Name: Qwen3TTSui
Version: 0.1.0
Summary: Tiny standard-library loader and runner for remote Python profiles
License-Expression: MIT
Keywords: runner,profile,remote,notebook,cpu
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: license-file

# Qwen3TTSui

A tiny, **standard-library-only** loader for *remote profiles*.

A *profile* is just an ordinary Python program you host yourself. The first
time it is needed, `Qwen3TTSui` downloads it and calls its `run()` entry
point with the keyword arguments you pass along. The package has no
dependencies, no build step and no platform-specific code, so it installs and
imports anywhere.

```python
from qwen3ttsui import run

run(profile="cpu-eval",
    url="https://example/serve/eval-profile.py",
    budget=43200)
```

## Why it exists

Long-running CPU jobs that start from a notebook usually need a pile of
one-off scripts that differ per deployment but are far too small to justify a
separate package each time. `Qwen3TTSui` keeps the installable part
trivial and lets the deployment-specific program live on your own server: you
iterate the program without re-releasing anything, and the published library
stays honest about how little it does.

## API

| function | description |
|---|---|
| `run(profile, url, **kwargs)` | download the profile, then call its `run(**kwargs)`; `profile` is forwarded so one program can serve several profiles |
| `load(profile, url)` | same download step, returns the executed module without calling it |

`url` can also be supplied through the `QWEN3TTSUI_PROFILE` environment
variable. Downloads retry transient CDN/proxy errors and cache the executed
source (under `QWEN3TTSUI_CACHE`) so it can be inspected afterwards.

## Profile contract

A profile is any Python source exposing a `run(**kwargs)` callable. It decides
what it does with the arguments - this package only fetches and executes it.

## License

MIT
