{"id":30385311,"url":"https://github.com/funkatron/poppop","last_synced_at":"2025-08-21T02:13:47.891Z","repository":{"id":306688935,"uuid":"1024489854","full_name":"funkatron/poppop","owner":"funkatron","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-22T19:28:30.000Z","size":89,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"feature/singleton-console","last_synced_at":"2025-08-16T12:34:16.557Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/funkatron.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-22T19:28:29.000Z","updated_at":"2025-07-22T19:28:35.000Z","dependencies_parsed_at":"2025-07-27T04:08:28.934Z","dependency_job_id":"7e051822-6e6b-4439-b1e7-a37cd2356c2c","html_url":"https://github.com/funkatron/poppop","commit_stats":null,"previous_names":["funkatron/poppop"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/funkatron/poppop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fpoppop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fpoppop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fpoppop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fpoppop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/funkatron","download_url":"https://codeload.github.com/funkatron/poppop/tar.gz/refs/heads/feature/singleton-console","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fpoppop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271415496,"owners_count":24755639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-21T02:13:47.217Z","updated_at":"2025-08-21T02:13:47.879Z","avatar_url":"https://github.com/funkatron.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🦴 Poppop\n\n[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/FM.svg?style=social\u0026label=@suno_ai_)](https://twitter.com/suno_ai_)\n\n\u003e 🔗 [Examples](#examples) • [Updates](#-updates) • [How to Use](#usage) • [Installation](#installation) • [FAQ](#faq)\n\n[//]: \u003cbr\u003e (vertical spaces around image)\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/5068315/235310676-a4b3b511-90ec-4edf-8153-7ccf14905d73.png\" width=\"500\"\u003e\u003c/img\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\nPoppop is a command-line interface (CLI) tool for sound generation tasks. It provides access to Suno's text-to-audio model for generating speech, music, and sound effects. Poppop is designed as a drop-in replacement for Bark's CLI, maintaining full argument compatibility while adding new features.\n\nFeatures:\n- Command-line interface for audio generation\n- Multi-language support with automatic language detection\n- Music and sound effect generation\n- Support for emotional expressions and special tokens\n- Resource management options for different hardware configurations\n- Full compatibility with Bark's CLI arguments\n\nPoppop uses Suno's text-to-audio model to generate speech and audio content. The model can produce speech in multiple languages, music, background noise, and sound effects. It also handles nonverbal sounds like laughter, sighs, and crying.\n\n## ⚠ Disclaimer\n\n## 📖 Quick Index\n* [🚀 Updates](#-updates)\n* [💻 Installation](#-installation)\n* [🐍 Usage](#-usage-in-python)\n* [❓ FAQ](#-faq)\n\n## 🎧 Demos\n\n\n## 🚀 Updates\n\n\n**20250530**\n- 🦴 Poppop release!\n\n## 🐍 Usage in Python\n\n\u003cdetails open\u003e\n  \u003csummary\u003e\u003ch3\u003e🪑 Basics\u003c/h3\u003e\u003c/summary\u003e\n\n```python\nfrom poppop import SAMPLE_RATE, generate_audio, preload_models\nfrom scipy.io.wavfile import write as write_wav\nfrom IPython.display import Audio\n\n# download and load all models\npreload_models()\n\n# generate audio from text\ntext_prompt = \"\"\"\n     Hello, my name is Suno. And, uh — and I like pizza. [laughs]\n     But I also have other interests such as playing tic tac toe.\n\"\"\"\naudio_array = generate_audio(text_prompt)\n\n# save audio to disk\nwrite_wav(\"poppop_generation.wav\", SAMPLE_RATE, audio_array)\n\n# play text in notebook\nAudio(audio_array, rate=SAMPLE_RATE)\n```\n\n[pizza1.webm](https://user-images.githubusercontent.com/34592747/cfa98e54-721c-4b9c-b962-688e09db684f.webm)\n\n\u003c/details\u003e\n\n\u003cdetails open\u003e\n  \u003csummary\u003e\u003ch3\u003e🌎 Foreign Language\u003c/h3\u003e\u003c/summary\u003e\n\u003cbr\u003e\nPoppop supports various languages out-of-the-box and automatically determines language from input text. When prompted with code-switched text, Poppop will attempt to employ the native accent for the respective languages. English quality is best for the time being, and we expect other languages to further improve with scaling.\n\u003cbr\u003e\n\u003cbr\u003e\n\n```python\n\ntext_prompt = \"\"\"\n    추석은 내가 가장 좋아하는 명절이다. 나는 며칠 동안 휴식을 취하고 친구 및 가족과 시간을 보낼 수 있습니다.\n\"\"\"\naudio_array = generate_audio(text_prompt)\n```\n[suno_korean.webm](https://user-images.githubusercontent.com/32879321/235313033-dc4477b9-2da0-4b94-9c8b-a8c2d8f5bb5e.webm)\n\n*Note: since Poppop recognizes languages automatically from input text, it is possible to use, for example, a german history prompt with english text. This usually leads to english audio with a german accent.*\n```python\ntext_prompt = \"\"\"\n    Der Dreißigjährige Krieg (1618-1648) war ein verheerender Konflikt, der Europa stark geprägt hat.\n    This is a beginning of the history. If you want to hear more, please continue.\n\"\"\"\naudio_array = generate_audio(text_prompt)\n```\n[suno_german_accent.webm](https://user-images.githubusercontent.com/34592747/3f96ab3e-02ec-49cb-97a6-cf5af0b3524a.webm)\n\n\n\n\n\u003c/details\u003e\n\n\u003cdetails open\u003e\n  \u003csummary\u003e\u003ch3\u003e🎶 Music\u003c/h3\u003e\u003c/summary\u003e\nPoppop can generate all types of audio, and, in principle, doesn't see a difference between speech and music. Sometimes Poppop chooses to generate text as music, but you can help it out by adding music notes around your lyrics.\n\u003cbr\u003e\n\u003cbr\u003e\n\n```python\ntext_prompt = \"\"\"\n    ♪ In the jungle, the mighty jungle, the lion barks tonight ♪\n\"\"\"\naudio_array = generate_audio(text_prompt)\n```\n[lion.webm](https://user-images.githubusercontent.com/5068315/230684766-97f5ea23-ad99-473c-924b-66b6fab24289.webm)\n\u003c/details\u003e\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003ch3\u003e🎤 Voice Presets\u003c/h3\u003e\u003c/summary\u003e\n\nPoppop supports 100+ speaker presets across [supported languages](#supported-languages). You can browse the library of supported voice presets [HERE](https://suno-ai.notion.site/8b8e8749ed514b0cbf3f699013548683?v=bc67cff786b04b50b3ceb756fd05f68c), or in the [code](poppop/assets/prompts). The community also often shares presets in [Discord](https://discord.gg/J2B2vsjKuE).\n\n\u003e Poppop tries to match the tone, pitch, emotion and prosody of a given preset, but does not currently support custom voice cloning. The model also attempts to preserve music, ambient noise, etc.\n\n```python\ntext_prompt = \"\"\"\n    I have a silky smooth voice, and today I will tell you about\n    the exercise regimen of the common sloth.\n\"\"\"\naudio_array = generate_audio(text_prompt, history_prompt=\"v2/en_speaker_1\")\n```\n\n[sloth.webm](https://user-images.githubusercontent.com/5068315/230684883-a344c619-a560-4ff5-8b99-b4463a34487b.webm)\n\u003c/details\u003e\n\n### 📃 Generating Longer Audio\n\nBy default, `generate_audio` works well with around 13 seconds of spoken text. For an example of how to do long-form generation, see 👉 **[Notebook](notebooks/long_form_generation.ipynb)** 👈\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to toggle example long-form generations (from the example notebook)\u003c/summary\u003e\n\n[dialog.webm](https://user-images.githubusercontent.com/2565833/235463539-f57608da-e4cb-4062-8771-148e29512b01.webm)\n\n[longform_advanced.webm](https://user-images.githubusercontent.com/2565833/235463547-1c0d8744-269b-43fe-9630-897ea5731652.webm)\n\n[longform_basic.webm](https://user-images.githubusercontent.com/2565833/235463559-87efe9f8-a2db-4d59-b764-57db83f95270.webm)\n\n\u003c/details\u003e\n\n\n## Command line\n```commandline\npython -m poppop \"Hello, my name is Suno.\" --output_filename \"example.wav\"\n```\n\n## 💻 Installation\n*‼️ CAUTION ‼️ Do NOT use `pip install poppop`. It installs a different package, which is not managed by Suno.*\n```bash\npip install git+https://github.com/suno-ai/poppop.git\n```\n\nor\n\n```bash\ngit clone https://github.com/suno-ai/poppop\ncd poppop \u0026\u0026 pip install .\n```\n\n\n## 🤗 Transformers Usage\n\nPoppop is available in the 🤗 Transformers library from version 4.31.0 onwards, requiring minimal dependencies\nand additional packages. Steps to get started:\n\n1. First install the 🤗 [Transformers library](https://github.com/huggingface/transformers) from main:\n\n```\npip install git+https://github.com/huggingface/transformers.git\n```\n\n2. Run the following Python code to generate speech samples:\n\n```py\nfrom transformers import AutoProcessor, PoppopModel\n\nprocessor = AutoProcessor.from_pretrained(\"suno/poppop\")\nmodel = PoppopModel.from_pretrained(\"suno/poppop\")\n\nvoice_preset = \"v2/en_speaker_6\"\n\ninputs = processor(\"Hello, my dog is cute\", voice_preset=voice_preset)\n\naudio_array = model.generate(**inputs)\naudio_array = audio_array.cpu().numpy().squeeze()\n```\n\n3. Listen to the audio samples either in an ipynb notebook:\n\n```py\nfrom IPython.display import Audio\n\nsample_rate = model.generation_config.sample_rate\nAudio(audio_array, rate=sample_rate)\n```\n\nOr save them as a `.wav` file using a third-party library, e.g. `scipy`:\n\n```py\nimport scipy\n\nsample_rate = model.generation_config.sample_rate\nscipy.io.wavfile.write(\"poppop_out.wav\", rate=sample_rate, data=audio_array)\n```\n\nFor more details on using the Poppop model for inference using the 🤗 Transformers library, refer to the\n[Poppop docs](https://huggingface.co/docs/transformers/main/en/model_doc/poppop) or the hands-on\n[Google Colab](https://colab.research.google.com/drive/1dWWkZzvu7L9Bunq9zvD-W02RFUXoW-Pd?usp=sharing).\n\n\n## 🛠️ Hardware and Inference Speed\n\nPoppop has been tested and works on both CPU and GPU (`pytorch 2.0+`, CUDA 11.7 and CUDA 12.0).\n\nOn enterprise GPUs and PyTorch nightly, Poppop can generate audio in roughly real-time. On older GPUs, default colab, or CPU, inference time might be significantly slower. For older GPUs or CPU you might want to consider using smaller models. Details can be found in out tutorial sections here.\n\nThe full version of Poppop requires around 12GB of VRAM to hold everything on GPU at the same time.\nTo use a smaller version of the models, which should fit into 8GB VRAM, set the environment flag `SUNO_USE_SMALL_MODELS=True`.\n\nIf you don't have hardware available or if you want to play with bigger versions of our models, you can also sign up for early access to our model playground [here](https://suno-ai.typeform.com/suno-studio).\n\n## ⚙️ Details\n\nPoppop is fully generative text-to-audio model devolved for research and demo purposes. It follows a GPT style architecture similar to [AudioLM](https://arxiv.org/abs/2209.03143) and [Vall-E](https://arxiv.org/abs/2301.02111) and a quantized Audio representation from [EnCodec](https://github.com/facebookresearch/encodec). It is not a conventional TTS model, but instead a fully generative text-to-audio model capable of deviating in unexpected ways from any given script. Different to previous approaches, the input text prompt is converted directly to audio without the intermediate use of phonemes. It can therefore generalize to arbitrary instructions beyond speech such as music lyrics, sound effects or other non-speech sounds.\n\nBelow is a list of some known non-speech sounds, but we are finding more every day. Please let us know if you find patterns that work particularly well on [Discord](https://suno.ai/discord)!\n\n- `[laughter]`\n- `[laughs]`\n- `[sighs]`\n- `[music]`\n- `[gasps]`\n- `[clears throat]`\n- `—` or `...` for hesitations\n- `♪` for song lyrics\n- CAPITALIZATION for emphasis of a word\n- `[MAN]` and `[WOMAN]` to bias Poppop toward male and female speakers, respectively\n\n### Supported Languages\n\n| Language | Status |\n| --- | :---: |\n| English (en) | ✅ |\n| German (de) | ✅ |\n| Spanish (es) | ✅ |\n| French (fr) | ✅ |\n| Hindi (hi) | ✅ |\n| Italian (it) | ✅ |\n| Japanese (ja) | ✅ |\n| Korean (ko) | ✅ |\n| Polish (pl) | ✅ |\n| Portuguese (pt) | ✅ |\n| Russian (ru) | ✅ |\n| Turkish (tr) | ✅ |\n| Chinese, simplified (zh) | ✅ |\n\nRequests for future language support [here](https://github.com/suno-ai/poppop/discussions/111) or in the **#forums** channel on [Discord](https://suno.ai/discord).\n\n## 🙏 Appreciation\n\n- [nanoGPT](https://github.com/karpathy/nanoGPT) for a dead-simple and blazing fast implementation of GPT-style models\n- [EnCodec](https://github.com/facebookresearch/encodec) for a state-of-the-art implementation of a fantastic audio codec\n- [AudioLM](https://github.com/lucidrains/audiolm-pytorch) for related training and inference code\n- [Vall-E](https://arxiv.org/abs/2301.02111), [AudioLM](https://arxiv.org/abs/2209.03143) and many other ground-breaking papers that enabled the development of Poppop\n\n## © License\n\nPoppop is licensed under the MIT License.\n\n# 🎵 Poppop CLI\n\nA user-friendly command-line interface for [Suno's Poppop](https://github.com/suno-ai/poppop) text-to-audio model.\n\n## Features\n\n- 🎤 Easy-to-use CLI for generating audio from text\n- 🌍 Support for multiple languages and voice presets\n- 🎵 Interactive mode for continuous generation\n- 📊 Beautiful progress tracking and status updates\n- 💾 Automatic output file management\n- 🎛️ Configurable generation parameters\n- 🖥️ Support for both full and small models\n\n## Installation\n\n```bash\npip install poppop-cli\n```\n\n## Usage\n\nPoppop maintains compatibility with Bark's CLI arguments for easy migration:\n\n```bash\n# Basic usage (both formats supported)\npoppop \"Hello, this is funkatron\"\npoppop --text \"Hello, this is funkatron\"\n\n# Save to file (both formats supported)\npoppop \"Hello\" --output_filename greeting.wav\npoppop \"Hello\" -o greeting.wav\n\n# Voice selection (both formats supported)\npoppop \"Hello\" --history_prompt v2/en_speaker_1\npoppop \"Hello\" -v v2/en_speaker_1\n```\n\n### Command Line Arguments\n\nPoppop supports all Bark CLI arguments:\n\n```\n--text TEXT                 Text to generate audio for\n--output_filename FILENAME  Output filename (default: generated_audio.wav)\n--history_prompt PROMPT     Voice preset to use\n--text_temp TEMP           Text generation temperature (0.0-1.0)\n--waveform_temp TEMP       Waveform generation temperature (0.0-1.0)\n--small_model              Use smaller model for lower VRAM usage\n--offload_cpu              Offload model to CPU\n```\n\n### Examples\n\nGenerate speech in different languages:\n```bash\n# Using positional argument\npoppop \"Hello, world\"                    # English\npoppop \"Bonjour le monde\"               # French\npoppop \"こんにちは、世界\"                # Japanese\n\n# Using --text argument (Bark style)\npoppop --text \"Hello, world\"            # English\npoppop --text \"Bonjour le monde\"        # French\npoppop --text \"こんにちは、世界\"         # Japanese\n```\n\nAdd emotional expressions:\n```bash\npoppop \"I'm so excited! [laughs] This is amazing... [gasps]\"\n```\n\nGenerate music:\n```bash\npoppop \"♪ In the jungle, the mighty jungle, the lion sleeps tonight ♪\"\n```\n\n### Voice Presets\n\nAvailable voice presets follow the pattern `v2/{lang}_speaker_{number}`:\n- English: `v2/en_speaker_0` through `v2/en_speaker_9`\n- Other languages: `v2/{lang}_speaker_0`\n\nList available voices:\n```bash\npoppop voices\n```\n\n### Python Module Usage\n\nPoppop can also be used as a Python module, maintaining compatibility with Bark's API:\n\n```python\nfrom poppop import SAMPLE_RATE, generate_audio, preload_models\nfrom scipy.io.wavfile import write as write_wav\n\npreload_models()\naudio_array = generate_audio(\"Hello, this is a test\")\nwrite_wav(\"output.wav\", SAMPLE_RATE, audio_array)\n```\n\n## Development\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/yourusername/poppop-cli.git\ncd poppop-cli\n```\n\n2. Install development dependencies:\n```bash\npip install -e \".[dev]\"\n```\n\n3. Run tests:\n```bash\npytest\n```\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Acknowledgments\n\n- [Suno's Poppop](https://github.com/suno-ai/poppop) for the amazing text-to-audio model\n- [Click](https://click.palletsprojects.com/) for the CLI framework\n- [Rich](https://github.com/Textualize/rich) for beautiful terminal formatting\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunkatron%2Fpoppop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffunkatron%2Fpoppop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunkatron%2Fpoppop/lists"}