← Back to Skills Marketplace
merend

openai-tts-python

by merend · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
2145
Downloads
1
Stars
8
Active Installs
2
Versions
Install in OpenClaw
/install openai-tts-python
Description
Text-to-speech conversion using OpenAI's TTS API for generating high-quality, natural-sounding audio. Supports 6 voices (alloy, echo, fable, onyx, nova, shimmer), speed control (0.25x-4.0x), HD quality model, multiple output formats (mp3, opus, aac, flac), and automatic text chunking for long content (4096 char limit per request). Use when: (1) User requests audio/voice output with triggers like "read this to me", "convert to audio", "generate speech", "text to speech", "tts", "narrate", "speak", or when keywords "openai tts", "voice", "podcast" appear. (2) Content needs to be spoken rather than read (multitasking, accessibility). (3) User wants specific voice preferences like "alloy", "echo", "fable", "onyx", "nova", "shimmer" or speed adjustments.
Usage Guidance
This package implements a normal OpenAI text-to-speech client and legitimately requires your OPENAI_API_KEY. Before installing or enabling it: (1) confirm the publisher/source (the package lists no homepage and 'Source: unknown'); (2) correct or ask the publisher to correct the registry metadata so the required OPENAI_API_KEY is declared; (3) ensure you are comfortable granting network access to OpenAI and that the key has appropriate billing/usage controls; (4) review the included openai/pydub/ffmpeg install instructions and run in a sandbox if you have doubts; (5) if you plan to deploy broadly, prefer an official or well-audited mirror/repository and verify package versions. The inconsistencies are likely sloppy metadata, not malicious code, but verify source trustworthiness before providing your API key.
Capability Analysis
Type: OpenClaw Skill Name: openai-tts-python Version: 1.0.1 The skill bundle is designed for text-to-speech conversion using OpenAI's API. All files (code and documentation) consistently align with this stated purpose. The `openai_tts.py` script securely retrieves the `OPENAI_API_KEY` from environment variables, which is standard practice for API authentication, and handles file operations (reading input, writing output, temporary files for audio chunking) appropriately. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts in `SKILL.md` or `README.md` that would lead to unauthorized actions or compromise the agent.
Capability Assessment
Purpose & Capability
The code, SKILL.md, README, and manifest all implement a TTS client that calls OpenAI's audio.speech.create API, supports chunking, multiple voices, formats and pydub for combining — this matches the stated purpose. However the top-level registry summary in the evaluation header incorrectly claimed 'Required env vars: none' while SKILL.md, manifest.json, and the script explicitly require OPENAI_API_KEY.
Instruction Scope
Runtime instructions and the script only read user-provided text (args, files, or stdin), call the OpenAI API, and optionally use pydub/ffmpeg to combine audio. There are no instructions to read unrelated system files or exfiltrate other data. Network access to OpenAI is required (expected for this purpose).
Install Mechanism
No custom install spec is provided (instruction-only install), and required dependencies (openai, pydub, ffmpeg) are standard packages/tools available via pip and system package managers. No downloads from untrusted URLs or archives are present in the manifest or README.
Credentials
The manifest, SKILL.md, README, and code all require OPENAI_API_KEY (reasonable for this TTS skill), but the top-level registry metadata reported 'Required env vars: none' and 'Primary credential: none' — an explicit mismatch. This metadata omission reduces transparency about credential needs. No other unrelated secrets are requested, so the single required credential is proportionate, but the metadata inconsistency is a concern.
Persistence & Privilege
The skill does not request persistent/always-on installation and does not modify other skills or system-wide agent settings. Default autonomous invocation is allowed by platform policy (normal) and the skill does not escalate privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openai-tts-python
  3. After installation, invoke the skill by name or use /openai-tts-python
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added a structured YAML front matter for improved metadata and description. - Expanded the skill description to clearly detail features, supported voices, and activation triggers. - No changes made to usage, features, or code examples. - This update improves discoverability and clarity for all users.
v1.0.0
- Initial release of OpenAI TTS skill. - Supports 6 high-quality voices and 2 model options (standard, HD). - Automatic chunking for long texts (4096 character limit). - Multiple audio output formats: mp3, opus, aac, flac. - Example usages provided for Python and command-line. - Includes error handling, batch processing, and content-to-podcast conversion examples.
Metadata
Slug openai-tts-python
Version 1.0.1
License
All-time Installs 8
Active Installs 8
Total Versions 2
Frequently Asked Questions

What is openai-tts-python?

Text-to-speech conversion using OpenAI's TTS API for generating high-quality, natural-sounding audio. Supports 6 voices (alloy, echo, fable, onyx, nova, shimmer), speed control (0.25x-4.0x), HD quality model, multiple output formats (mp3, opus, aac, flac), and automatic text chunking for long content (4096 char limit per request). Use when: (1) User requests audio/voice output with triggers like "read this to me", "convert to audio", "generate speech", "text to speech", "tts", "narrate", "speak", or when keywords "openai tts", "voice", "podcast" appear. (2) Content needs to be spoken rather than read (multitasking, accessibility). (3) User wants specific voice preferences like "alloy", "echo", "fable", "onyx", "nova", "shimmer" or speed adjustments. It is an AI Agent Skill for Claude Code / OpenClaw, with 2145 downloads so far.

How do I install openai-tts-python?

Run "/install openai-tts-python" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is openai-tts-python free?

Yes, openai-tts-python is completely free (open-source). You can download, install and use it at no cost.

Which platforms does openai-tts-python support?

openai-tts-python is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created openai-tts-python?

It is built and maintained by merend (@merend); the current version is v1.0.1.

💬 Comments