smallestai 0.1.0__tar.gz → 1.2.0__tar.gz

{smallestai-0.1.0 → smallestai-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: smallestai
-Version: 0.1.0
+Version: 1.2.0
 Summary: Official Python client for the Smallest AI API
 Author-email: Smallest <info@smallest.ai>
 License: MIT
@@ -62,18 +62,12 @@ Currently, the library supports direct synthesis and the ability to synthesize s
 
 ## Installation
 
-To install the package, follow these steps:
-
-1. Clone the repository:
-   ```bash
-   git clone https://github.com/smallest-inc/smallest-python-sdk.git
-   ```
-
-2. Navigate to the cloned directory and install the package:
-   ```bash
-   cd smallest-python
-   pip install .
-   ```    
+To install the latest version available   
+```bash
+pip install smallestai
+```  
+When using an SDK in your application, make sure to pin to at least the major version (e.g., ==1.*). This helps ensure your application remains stable and avoids potential issues from breaking changes in future updates.   
+   
 
 ## Get the API Key  
 
@@ -94,9 +88,7 @@ from smallest import Smallest
 
 def main():
     client = Smallest(api_key=os.environ.get("SMALLEST_API_KEY"))
-    audio_data = client.synthesize("Hello, this is a test for sync synthesis function.")
-    with open("sync_synthesize.wav", "wb") as f:
-        f.write(audio_data)
+    client.synthesize("Hello, this is a test for sync synthesis function.", save_as="sync_synthesize.wav")
 
 if __name__ == "__main__":
     main()
@@ -113,7 +105,7 @@ if __name__ == "__main__":
 - `remove_extra_silence`: Remove additional silence (default: True)
 
 ### Async   
-A synchronous text-to-speech synthesis client.    
+Asynchronous text-to-speech synthesis client.    
 
 **Basic Usage:**   
 ```python
@@ -126,9 +118,9 @@ client = AsyncSmallest(api_key=os.environ.get("SMALLEST_API_KEY"))
 
 async def main():
     async with client as tts:
-        audio_bytes = await tts.synthesize("Hello, this is a test of the async synthesis function.")
+        audio_bytes = await tts.synthesize("Hello, this is a test of the async synthesis function.") 
         async with aiofiles.open("async_synthesize.wav", "wb") as f:
-            await f.write(audio_bytes)
+            await f.write(audio_bytes) # alternatively you can use the `save_as` parameter.
 
 if __name__ == "__main__":
     asyncio.run(main())

{smallestai-0.1.0 → smallestai-1.2.0}/README.md

@@ -35,18 +35,12 @@ Currently, the library supports direct synthesis and the ability to synthesize s
 
 ## Installation
 
-To install the package, follow these steps:
-
-1. Clone the repository:
-   ```bash
-   git clone https://github.com/smallest-inc/smallest-python-sdk.git
-   ```
-
-2. Navigate to the cloned directory and install the package:
-   ```bash
-   cd smallest-python
-   pip install .
-   ```    
+To install the latest version available   
+```bash
+pip install smallestai
+```  
+When using an SDK in your application, make sure to pin to at least the major version (e.g., ==1.*). This helps ensure your application remains stable and avoids potential issues from breaking changes in future updates.   
+   
 
 ## Get the API Key  
 
@@ -67,9 +61,7 @@ from smallest import Smallest
 
 def main():
     client = Smallest(api_key=os.environ.get("SMALLEST_API_KEY"))
-    audio_data = client.synthesize("Hello, this is a test for sync synthesis function.")
-    with open("sync_synthesize.wav", "wb") as f:
-        f.write(audio_data)
+    client.synthesize("Hello, this is a test for sync synthesis function.", save_as="sync_synthesize.wav")
 
 if __name__ == "__main__":
     main()
@@ -86,7 +78,7 @@ if __name__ == "__main__":
 - `remove_extra_silence`: Remove additional silence (default: True)
 
 ### Async   
-A synchronous text-to-speech synthesis client.    
+Asynchronous text-to-speech synthesis client.    
 
 **Basic Usage:**   
 ```python
@@ -99,9 +91,9 @@ client = AsyncSmallest(api_key=os.environ.get("SMALLEST_API_KEY"))
 
 async def main():
     async with client as tts:
-        audio_bytes = await tts.synthesize("Hello, this is a test of the async synthesis function.")
+        audio_bytes = await tts.synthesize("Hello, this is a test of the async synthesis function.") 
         async with aiofiles.open("async_synthesize.wav", "wb") as f:
-            await f.write(audio_bytes)
+            await f.write(audio_bytes) # alternatively you can use the `save_as` parameter.
 
 if __name__ == "__main__":
     asyncio.run(main())

{smallestai-0.1.0 → smallestai-1.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "smallestai"
-version = "0.1.0"
+version = "1.2.0"
 description = "Official Python client for the Smallest AI API"
 authors = [
     {name = "Smallest", email = "info@smallest.ai"},

{smallestai-0.1.0 → smallestai-1.2.0}/smallest/tts.py

@@ -1,4 +1,5 @@
 import os
+import wave
 import copy
 import requests
 from typing import Optional, Union, List
@@ -128,7 +129,11 @@ class Smallest:
                 with open(save_as, "wb") as wf:
                     wf.write(audio_content)
             else:
-                raise TTSError("WAV header is required for saving audio. Set 'add_wav_header=True' to add a WAV header.")
+                with wave.open(save_as, "wb") as wf:
+                    wf.setnchannels(1)
+                    wf.setsampwidth(2)
+                    wf.setframerate(self.opts.sample_rate)
+                    wf.writeframes(audio_content)
             return None
             
         return audio_content

{smallestai-0.1.0 → smallestai-1.2.0}/smallestai.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: smallestai
-Version: 0.1.0
+Version: 1.2.0
 Summary: Official Python client for the Smallest AI API
 Author-email: Smallest <info@smallest.ai>
 License: MIT
@@ -62,18 +62,12 @@ Currently, the library supports direct synthesis and the ability to synthesize s
 
 ## Installation
 
-To install the package, follow these steps:
-
-1. Clone the repository:
-   ```bash
-   git clone https://github.com/smallest-inc/smallest-python-sdk.git
-   ```
-
-2. Navigate to the cloned directory and install the package:
-   ```bash
-   cd smallest-python
-   pip install .
-   ```    
+To install the latest version available   
+```bash
+pip install smallestai
+```  
+When using an SDK in your application, make sure to pin to at least the major version (e.g., ==1.*). This helps ensure your application remains stable and avoids potential issues from breaking changes in future updates.   
+   
 
 ## Get the API Key  
 
@@ -94,9 +88,7 @@ from smallest import Smallest
 
 def main():
     client = Smallest(api_key=os.environ.get("SMALLEST_API_KEY"))
-    audio_data = client.synthesize("Hello, this is a test for sync synthesis function.")
-    with open("sync_synthesize.wav", "wb") as f:
-        f.write(audio_data)
+    client.synthesize("Hello, this is a test for sync synthesis function.", save_as="sync_synthesize.wav")
 
 if __name__ == "__main__":
     main()
@@ -113,7 +105,7 @@ if __name__ == "__main__":
 - `remove_extra_silence`: Remove additional silence (default: True)
 
 ### Async   
-A synchronous text-to-speech synthesis client.    
+Asynchronous text-to-speech synthesis client.    
 
 **Basic Usage:**   
 ```python
@@ -126,9 +118,9 @@ client = AsyncSmallest(api_key=os.environ.get("SMALLEST_API_KEY"))
 
 async def main():
     async with client as tts:
-        audio_bytes = await tts.synthesize("Hello, this is a test of the async synthesis function.")
+        audio_bytes = await tts.synthesize("Hello, this is a test of the async synthesis function.") 
         async with aiofiles.open("async_synthesize.wav", "wb") as f:
-            await f.write(audio_bytes)
+            await f.write(audio_bytes) # alternatively you can use the `save_as` parameter.
 
 if __name__ == "__main__":
     asyncio.run(main())