SUN is an AI-powered audio learning app that transforms any topic, question, or feed into a dialogue podcast ready to play in Spotify or your favorite podcast app. It belongs to the emerging category of AI-driven audio content generators, designed for learners, professionals, and podcast enthusiasts who want to consume information hands-free. The core value lies in instant personalization: users specify exactly what they want to hear and for how long, and SUN handles everything from research to multi-speaker dialogue production. Whether you need a 10-minute industry update or a 20-minute book summary, SUN delivers a polished, engaging audio experience without any manual production work. The app is accessible via a command-line interface (CLI) and integrates tightly with Spotify for seamless listening across devices.
Traditional knowledge consumption often requires staring at a screen, scrolling through articles, or sitting through lengthy videos. SUN solves the pain point of information overload by converting any textual content into an audio format that respects your time and attention. Instead of skimming dense documents or watching hour-long lectures, users can listen to a concise, dynamically scripted podcast while commuting, exercising, or doing chores. The ability to set exact durations—from five-minute briefs to two-hour deep dives—means you never waste time on content longer than needed. For busy professionals and lifelong learners, this transforms wasted pockets of time into productive learning moments, making education and research accessible anywhere.
The first major feature group is the audio generation engine accessible via `sun audio create`. Users provide a prompt (1–4000 characters) describing what they want, optionally set a duration from 5 to 120 minutes, and even choose a specific narrator voice using a UUID. The system also supports a `--callback-url` flag, which triggers a POST request to your HTTPS endpoint as each episode finishes—enabling real-time workflow automation. This feature works by submitting the prompt to SUN's AI backend, which performs research, writes a dynamic script, and generates multi-speaker dialogue with audio mixing. The result is a complete podcast segment ready for download. The usefulness lies in its flexibility: you can generate anything from a morning news summary to a deep technical explanation, fully customized.
The second major feature group is the audio retrieval system via `sun audio get`. After a job is created, users can poll its status with `sun audio status <id>`, which returns states like `PENDING`, `PROCESSING`, `SUCCESS`, or `ERROR`. Once ready, `sun audio get` downloads the full result as a structured folder: an `overview.json` with metadata, a cover image, and individual MP3 files named `episodes/NNN-<slug>.mp3`. The standout capability is the `--partial` flag, which allows downloading episodes mid-generation—meaning you can start listening before the entire job finishes, exactly as streaming works. This incremental fetch is powered by polling every ~10 seconds and fills in episodes as they arrive, making the experience feel fast and responsive.
admin
A third capability is the personal API token system for secure, non-interactive use. Users can create tokens with `sun tokens create <name>`, list them, and revoke them as needed. Tokens have a specific format (e.g., `sk_live_<22-char-base32>_<32-char-base32>`) and are printed only once. For CI/CD or headless environments, the `SUN_TOKEN` environment variable overrides local credentials, enabling automated pipelines to generate audio without manual login. Additionally, the CLI includes comprehensive error handling with distinct error codes (e.g., `unauthorized`, `not_found`, `rate_limit_exceeded`) and a `--json` flag for machine-readable output—making it suitable for integrating with other tools and scripting workflows.
The overall workflow is straightforward and developer-friendly. First, install the SUN CLI via a curl installer or Python package manager (uv, pipx, or pip). Then authenticate with `sun login` (browser-based OAuth) or set the `SUN_TOKEN` environment variable. Next, create an audio job by running `sun audio create` with your prompt and desired duration—optionally providing a voice ID or callback URL. The CLI immediately returns a job ID, which you can poll with `sun audio status` until it reaches `SUCCESS`. Finally, download the finished audio with `sun audio get`, optionally using `--partial` to stream episodes as they complete. The entire process—research, script writing, multi-speaker dialogue, audio mixing, and publishing—is handled automatically by SUN's AI backend.
Concrete use cases abound from the examples provided in the documentation. A business executive can ask for "What's happening in the stock market this morning? Make it a 5-minute brief" and receive a concise audio summary before the trading day begins. A student can summarize a challenging book like "The Hard Thing About Hard Things" as a 20-minute dialogue podcast, making key insights easy to absorb during a commute. A technology enthusiast can request "What's the latest in voice and audio AI? Give me a 10-minute roundup" to stay current without reading multiple articles. A startup founder can ask "How should I think about marketing my B2B startup? Give me a 15-minute deep dive" and get actionable advice in an engaging format. Each use case ends with polished audio ready to play immediately.
SUN is built for developers, researchers, product managers, and anyone who consumes information while on the move. The CLI requires Python 3.10+ and is distributed as a PyPI package (`sun-cli`), integrating naturally with CI/CD pipelines and automation scripts. The skill (`sun-to-spotify`) is designed for use with Claude Code, allowing AI agents to generate and publish podcasts autonomously. After generation, users can publish their podcasts to Spotify using the `save-to-spotify` skill, which adds cover art and in-player timeline support. While pricing specifics are not detailed, the documentation mentions creating a free account. Overall, SUN transforms any written content into an engaging, on-demand audio experience, making it the ultimate tool for audio-first learning and productivity.
SUN is designed for developers and engineers who want to integrate AI-generated audio into their workflows via the CLI and API tokens. It serves busy professionals—executives, managers, and entrepreneurs—who need concise, on-the-go briefs and updates from their specific domains. Researchers and students benefit from personalized book summaries and topic deep dives. Content creators and podcasters can leverage SUN as a rapid prototyping tool for audio content. Additionally, the Claude Code skill targets AI agent users and automation enthusiasts who want to programmatically generate and publish podcasts. Whether you are a software developer automating daily news digests, a product manager staying current on industry trends, or a lifelong learner maximizing commute time, SUN provides a powerful, hands-free way to consume information.