langchain-camb 0.1.0__py3-none-any.whl

langchain_camb-0.1.0.dist-info/METADATA

@@ -0,0 +1,307 @@
+Metadata-Version: 2.4
+Name: langchain-camb
+Version: 0.1.0
+Summary: LangChain integration for CAMB AI - multilingual audio and localization tools
+Project-URL: Homepage, https://github.com/camb-ai/langchain-camb
+Project-URL: Documentation, https://docs.camb.ai
+Project-URL: Repository, https://github.com/camb-ai/langchain-camb
+Author-email: CAMB AI <support@camb.ai>
+License-Expression: MIT
+Keywords: audio,camb,langchain,localization,multilingual,text-to-speech,transcription,translation,tts,voice-cloning
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Requires-Dist: camb-sdk>=1.5.0
+Requires-Dist: langchain-core>=0.3.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: langchain-tests>=0.3.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# langchain-camb
+
+LangChain integration for [CAMB AI](https://camb.ai) - multilingual audio and localization services supporting 140+ languages.
+
+## Installation
+
+```bash
+pip install langchain-camb
+```
+
+## Quick Start
+
+```python
+from langchain_camb import CambToolkit, CambTTSTool
+from langchain_openai import ChatOpenAI
+from langgraph.prebuilt import create_react_agent
+
+# Set your API key
+import os
+os.environ["CAMB_API_KEY"] = "your-api-key"
+
+# Use individual tools
+tts = CambTTSTool()
+audio_path = tts.invoke({
+    "text": "Hello, world!",
+    "language": "en-us",
+    "voice_id": 147320
+})
+print(f"Audio saved to: {audio_path}")
+
+# Or use the toolkit with a LangChain agent
+toolkit = CambToolkit()
+agent = create_react_agent(ChatOpenAI(), toolkit.get_tools())
+
+result = agent.invoke({
+    "messages": [{"role": "user", "content": "Say 'Good morning' in Spanish"}]
+})
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `CambTTSTool` | Text-to-Speech - Convert text to natural speech |
+| `CambTranslatedTTSTool` | Translate text and convert to speech in one step |
+| `CambTranslationTool` | Text translation between 140+ languages |
+| `CambTranscriptionTool` | Speech-to-text with speaker identification |
+| `CambVoiceListTool` | List available voices for TTS |
+| `CambVoiceCloneTool` | Clone voices from 2+ second audio samples |
+| `CambTextToSoundTool` | Generate music and sound effects from text |
+| `CambAudioSeparationTool` | Separate vocals from background audio |
+
+## Tool Examples
+
+### Text-to-Speech
+
+```python
+from langchain_camb import CambTTSTool
+
+tts = CambTTSTool()
+result = tts.invoke({
+    "text": "Hello, how are you today?",
+    "language": "en-us",
+    "voice_id": 147320,
+    "speech_model": "mars-flash",  # or "mars-pro", "mars-instruct"
+    "speed": 1.0,  # 0.5 to 2.0
+    "output_format": "file_path"  # or "base64", "bytes"
+})
+```
+
+### Translation
+
+```python
+from langchain_camb import CambTranslationTool
+
+translator = CambTranslationTool()
+result = translator.invoke({
+    "text": "Hello, how are you?",
+    "source_language": 1,   # English (en-us)
+    "target_language": 54,  # Spanish (es-es)
+    "formality": 1  # 1=formal, 2=informal
+})
+print(result)  # "Hola, ¿cómo está usted?"
+```
+
+### Transcription
+
+```python
+from langchain_camb import CambTranscriptionTool
+
+transcriber = CambTranscriptionTool()
+result = transcriber.invoke({
+    "audio_url": "https://example.com/audio.mp3",
+    "language": 1  # English
+})
+# Returns JSON with text, segments, and speaker identification
+```
+
+### Voice Cloning
+
+```python
+from langchain_camb import CambVoiceCloneTool
+
+cloner = CambVoiceCloneTool()
+result = cloner.invoke({
+    "voice_name": "My Custom Voice",
+    "audio_file_path": "/path/to/sample.wav",  # 2+ seconds
+    "gender": 2,  # 1=Male, 2=Female
+    "description": "A warm, friendly voice"
+})
+# Returns new voice_id to use with TTS
+```
+
+### Text-to-Sound
+
+```python
+from langchain_camb import CambTextToSoundTool
+
+sound_gen = CambTextToSoundTool()
+result = sound_gen.invoke({
+    "prompt": "Upbeat electronic music with a driving beat",
+    "duration": 30,
+    "audio_type": "music"  # or "sound"
+})
+```
+
+### Audio Separation
+
+```python
+from langchain_camb import CambAudioSeparationTool
+
+separator = CambAudioSeparationTool()
+result = separator.invoke({
+    "audio_file_path": "/path/to/mixed_audio.mp3"
+})
+# Returns JSON with paths to vocals and background audio
+```
+
+## Using the Toolkit
+
+The `CambToolkit` bundles all tools and allows filtering:
+
+```python
+from langchain_camb import CambToolkit
+
+# All tools
+toolkit = CambToolkit()
+tools = toolkit.get_tools()
+
+# TTS-focused toolkit
+tts_toolkit = CambToolkit(
+    include_tts=True,
+    include_voice_list=True,
+    include_translation=False,
+    include_transcription=False,
+    include_translated_tts=False,
+    include_voice_clone=False,
+    include_text_to_sound=False,
+    include_audio_separation=False,
+)
+
+# Translation-focused toolkit
+translation_toolkit = CambToolkit(
+    include_tts=False,
+    include_translated_tts=True,
+    include_translation=True,
+    include_transcription=True,
+    include_voice_list=False,
+    include_voice_clone=False,
+    include_text_to_sound=False,
+    include_audio_separation=False,
+)
+```
+
+## Language Codes
+
+CAMB AI uses integer language codes. Common codes:
+
+| Code | Language | BCP-47 |
+|------|----------|--------|
+| 1 | English (US) | en-us |
+| 31 | German (Germany) | de-de |
+| 54 | Spanish (Spain) | es-es |
+| 76 | French (France) | fr-fr |
+| 87 | Italian | it-it |
+| 88 | Japanese | ja-jp |
+| 94 | Korean | ko-kr |
+| 108 | Dutch | nl-nl |
+| 111 | Portuguese (Brazil) | pt-br |
+| 114 | Russian | ru-ru |
+| 139 | Chinese (Simplified) | zh-cn |
+
+Use `client.languages.get_source_languages()` for the full list of 140+ languages.
+
+For TTS, use BCP-47 codes like `"en-us"`, `"es-es"`, `"fr-fr"`.
+
+## Configuration
+
+### API Key
+
+Set your API key via environment variable or parameter:
+
+```python
+# Environment variable
+import os
+os.environ["CAMB_API_KEY"] = "your-api-key"
+
+# Or pass directly
+tool = CambTTSTool(api_key="your-api-key")
+toolkit = CambToolkit(api_key="your-api-key")
+```
+
+### Timeouts and Polling
+
+For async operations (transcription, text-to-sound, etc.):
+
+```python
+tool = CambTranscriptionTool(
+    timeout=60.0,         # HTTP request timeout
+    max_poll_attempts=60, # Max polling attempts
+    poll_interval=2.0,    # Seconds between polls
+)
+```
+
+## Agent Integration
+
+### LangGraph ReAct Agent
+
+```python
+from langchain_camb import CambToolkit
+from langchain_openai import ChatOpenAI
+from langgraph.prebuilt import create_react_agent
+
+toolkit = CambToolkit()
+agent = create_react_agent(ChatOpenAI(model="gpt-4"), toolkit.get_tools())
+
+# TTS
+result = agent.invoke({
+    "messages": [{"role": "user", "content": "Say 'Hello world' in a friendly tone"}]
+})
+
+# Translation
+result = agent.invoke({
+    "messages": [{"role": "user", "content": "Translate 'Good morning' to French and German"}]
+})
+
+# Transcription
+result = agent.invoke({
+    "messages": [{"role": "user", "content": "Transcribe https://example.com/audio.mp3"}]
+})
+```
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run unit tests
+pytest tests/unit/
+
+# Run integration tests (requires CAMB_API_KEY)
+CAMB_API_KEY=your-key pytest tests/integration/ -m integration
+
+# Lint
+ruff check .
+
+# Type check
+mypy langchain_camb/
+```
+
+## License
+
+MIT

langchain_camb-0.1.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+langchain_camb/__init__.py,sha256=S7r0ohLJv41r5526YflCo2nmmYoLJ0QRhn3gOjb0Blg,1935
+langchain_camb/version.py,sha256=7EtB2_SBceTNBe8WDAqFol_HvwbXsmbQxgR66U5BitE,69
+langchain_camb/toolkits/__init__.py,sha256=GPTYILnePtU7utUwbI9NVqgb5PfYflw72WjDKm10izI,123
+langchain_camb/toolkits/camb_toolkit.py,sha256=-PenuVyBX-Al5FqyXoOSR2YQSDPM-njR6y4BrQGxgTQ,4202
+langchain_camb/tools/__init__.py,sha256=qunsMGavyO_jvWlch0RiVQj2NpWhpHuHYrZyxciycXI,1250
+langchain_camb/tools/audio_separation.py,sha256=GsrIPCrkDC588tVm2ctF4PD-vIG-xur9Kl4E8_lkSpw,6304
+langchain_camb/tools/base.py,sha256=cFRQPbZ10jUlnE7MMMeMz6U8k34wJp5V2vd1yvfSKGY,5143
+langchain_camb/tools/text_to_sound.py,sha256=EzBiEtXgdJMsgK5O1Zz-8mx_GglAUCjFPOcG6LmIuFA,4893
+langchain_camb/tools/transcription.py,sha256=HeFjd4gLCyCiA8Bbg-3o2qet-VgP84J3gLQon5lhoak,6323
+langchain_camb/tools/translated_tts.py,sha256=RKPDnqlvA8HKdHkpDxQxZIPDnKsR_mRFtgcDIhcsUeY,12056
+langchain_camb/tools/translation.py,sha256=Ja8q3h7jMZDk_wx3Gcb5Npj4kAk5ChFJtcI68mSXl4E,4765
+langchain_camb/tools/tts.py,sha256=J3WQvDtDv41k62OFcGqd8l5-avbmu-PbmZdeg-thB7A,5838
+langchain_camb/tools/voice_clone.py,sha256=Ua-NjDzUTFmXyRqkGw5dHrU5FXZbTWwxJtByVABozUY,4410
+langchain_camb/tools/voice_list.py,sha256=ov8a1SrOI94eZJiHght0o4-Gx22jxHYTU6g2bNJLcbg,3508
+langchain_camb-0.1.0.dist-info/METADATA,sha256=6liWskzqX3i5Z43CbbU5DbS-DHXYUQeaGJ5YUymv488,7908
+langchain_camb-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+langchain_camb-0.1.0.dist-info/RECORD,,

langchain_camb-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any