devduck 1.1.5__py3-none-any.whl → 1.1.6__py3-none-any.whl

devduck/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '1.1.5'
-__version_tuple__ = version_tuple = (1, 1, 5)
+__version__ = version = '1.1.6'
+__version_tuple__ = version_tuple = (1, 1, 6)
 
 __commit_id__ = commit_id = None

{devduck-1.1.5.dist-info → devduck-1.1.6.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: devduck
-Version: 1.1.5
-Summary: 🦆 Extreme minimalist self-adapting AI agent - one file, self-healing, runtime dependencies
+Version: 1.1.6
+Summary: 🦆 Self-adapting agent - one file.
 Author-email: Cagatay Cali <cagataycali@icloud.com>
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/cagataycali/devduck
@@ -31,7 +31,6 @@ Requires-Dist: prompt_toolkit
 Requires-Dist: strands-agents[ollama]
 Requires-Dist: strands-agents[anthropic]
 Requires-Dist: strands-agents[openai]
-Requires-Dist: strands-agents[bidi-all]
 Requires-Dist: strands-agents[otel]
 Requires-Dist: strands-agents-tools
 Requires-Dist: beautifulsoup4
@@ -43,6 +42,8 @@ Requires-Dist: bedrock-agentcore-starter-toolkit
 Requires-Dist: bedrock-agentcore
 Requires-Dist: rumps; sys_platform == "darwin"
 Requires-Dist: strands-mlx; sys_platform == "darwin"
+Provides-Extra: speech
+Requires-Dist: strands-agents[bidi-all]; extra == "speech"
 Dynamic: license-file
 
 # 🦆 DevDuck
@@ -74,6 +75,9 @@ Learn more: https://duck.nyc
 # Install & run
 pipx install devduck && devduck
 
+# With speech-to-speech capabilities (optional)
+pipx install "devduck[speech]" && devduck
+
 # One-shot query
 devduck "create a REST API with FastAPI"
 
@@ -83,6 +87,9 @@ python -c "import devduck; devduck('analyze this code')"
 
 **Requirements:** Python 3.10-3.13, AWS credentials (or Ollama/Anthropic/GitHub/MLX)
 
+**Optional extras:**
+- `devduck[speech]` - Real-time speech-to-speech conversations (Nova Sonic, OpenAI Realtime, Gemini Live)
+
 ---
 
 ## Core Capabilities
@@ -98,6 +105,7 @@ python -c "import devduck; devduck('analyze this code')"
 | 💾 **State Time-Travel** | Save/restore agent state | `state_manager(action="export")` |
 | 📝 **Self-Improvement** | Updates own system prompt | `system_prompt(action="add_context", ...)` |
 | ☁️ **AWS Deploy** | One-command serverless | `agentcore_config(auto_launch=True)` |
+| 🎤 **Speech-to-Speech** | Real-time voice conversations | `pip install devduck[speech]` |
 
 ---
 
@@ -108,7 +116,13 @@ git clone git@github.com:cagataycali/devduck.git
 cd devduck
 python3.13 -m venv .venv
 source .venv/bin/activate
+
+# Basic install
 .venv/bin/pip3.13 install -e .
+
+# With speech capabilities
+.venv/bin/pip3.13 install -e ".[speech]"
+
 devduck
 ```
 
@@ -279,6 +293,67 @@ devduck
 
 ---
 
+## Speech-to-Speech (Optional)
+
+**Install speech capabilities:**
+```bash
+pip install "devduck[speech]"
+```
+
+**Real-time voice conversations** with multiple providers:
+
+```python
+# Start speech session with Nova Sonic (AWS Bedrock)
+speech_to_speech(action="start", provider="novasonic")
+
+# Start with OpenAI Realtime API
+speech_to_speech(action="start", provider="openai")
+
+# Start with Gemini Live
+speech_to_speech(action="start", provider="gemini_live")
+
+# Custom voice and settings
+speech_to_speech(
+    action="start",
+    provider="novasonic",
+    model_settings={
+        "provider_config": {"audio": {"voice": "matthew"}},
+        "client_config": {"region": "us-east-1"}
+    }
+)
+
+# Stop session
+speech_to_speech(action="stop", session_id="speech_20250126_140000")
+
+# Check status
+speech_to_speech(action="status")
+
+# List conversation histories
+speech_to_speech(action="list_history")
+
+# List available audio devices
+speech_to_speech(action="list_audio_devices")
+```
+
+**Supported Providers:**
+- **Nova Sonic (AWS Bedrock):** 11 voices (English, French, Italian, German, Spanish)
+- **OpenAI Realtime API:** GPT-4o Realtime models
+- **Gemini Live:** Native audio streaming
+
+**Environment Variables:**
+- `OPENAI_API_KEY` - For OpenAI Realtime
+- `GOOGLE_API_KEY` or `GEMINI_API_KEY` - For Gemini Live
+- AWS credentials - For Nova Sonic (boto3 default credential chain)
+
+**Features:**
+- Background execution (parent agent stays responsive)
+- Tool inheritance from parent agent
+- Conversation history saved automatically
+- Natural interruption with VAD
+- Custom audio device selection
+
+---
+
 ## MCP Integration
 
 ### As MCP Server (Expose DevDuck)
@@ -445,9 +520,9 @@ create_subagent(action="list", repository="owner/repo", workflow_id="agent.yml")
 ---
 
 <details>
-<summary><strong>📋 All Built-in Tools (38 total)</strong></summary>
+<summary><strong>📋 All Built-in Tools (39 total)</strong></summary>
 
-### DevDuck Core (17 tools)
+### DevDuck Core (18 tools)
 - `system_prompt` - Update agent's system prompt (GitHub sync support)
 - `store_in_kb` - Store content in Bedrock Knowledge Base
 - `state_manager` - Save/restore agent state (time-travel)
@@ -466,6 +541,7 @@ create_subagent(action="list", repository="owner/repo", workflow_id="agent.yml")
 - `agentcore_agents` - List/manage agent runtimes
 - `manage_tools` - Runtime tool add/remove/reload
 - `view_logs` - View/search/clear DevDuck logs
+- `speech_to_speech` - Real-time speech-to-speech conversations (optional - install with `pip install devduck[speech]`)
 
 ### Strands Tools (13 tools)
 - `shell` - Interactive shell with PTY support
@@ -572,7 +648,7 @@ devduck
 | `LITELLM_API_KEY` | - | LiteLLM API key (auto-detected) |
 | `LLAMAAPI_API_KEY` | - | LlamaAPI key (auto-detected) |
 | **Tools** | | |
-| `DEVDUCK_TOOLS` | 38 tools | Format: `package1:tool1,tool2;package2:tool3` |
+| `DEVDUCK_TOOLS` | 39 tools | Format: `package1:tool1,tool2;package2:tool3` |
 | `DEVDUCK_LOAD_TOOLS_FROM_DIR` | `false` | Auto-load from `./tools/` directory |
 | **Memory** | | |
 | `DEVDUCK_KNOWLEDGE_BASE_ID` | - | Bedrock KB ID for auto-RAG |
@@ -588,6 +664,8 @@ devduck
 | `DEVDUCK_ENABLE_WS` | `true` | Enable WebSocket server |
 | `DEVDUCK_ENABLE_MCP` | `true` | Enable MCP server |
 | `DEVDUCK_ENABLE_IPC` | `true` | Enable IPC server |
+| **Speech** | | |
+| `BIDI_MODEL_ID` | Provider default | Override bidi model (e.g., `amazon.nova-2-sonic-v1:0`) |
 | **Context** | | |
 | `DEVDUCK_LOG_LINE_COUNT` | `50` | Recent log lines in context |
 | `DEVDUCK_LAST_MESSAGE_COUNT` | `200` | Recent messages in context |
@@ -630,6 +708,15 @@ export DEVDUCK_LOG_LINE_COUNT=20
 export DEVDUCK_LAST_MESSAGE_COUNT=50
 ```
 
+**Speech dependencies not found:**
+```bash
+# Install speech extras
+pip install "devduck[speech]"
+
+# Or with pipx
+pipx install "devduck[speech]"
+```
+
 **Ambient overlay not starting:**
 ```bash
 # Make sure tkinter is installed

{devduck-1.1.5.dist-info → devduck-1.1.6.dist-info}/RECORD

@@ -1,6 +1,6 @@
 devduck/__init__.py,sha256=CVG9qHRG-63ZNI6nLGFyAqvv4m9mgSB46s5XAVM9HOM,75958
 devduck/__main__.py,sha256=aeF2RR4k7lzSR2X1QKV9XQPCKhtsH0JYUv2etBBqmL0,145
-devduck/_version.py,sha256=SBXhEAFQbfcjLb_eXnqg0cn0I8-y4wDGA3DkPBmBv2s,704
+devduck/_version.py,sha256=Ss7ZrKeNFejVcP8xqi-vmh6yUDDLhmA6FdF5e4QxSZA,704
 devduck/agentcore_handler.py,sha256=0DKJTTjoH9P8a70G0f5dOIIwy6bjqaN46voAWaSOpDY,2221
 devduck/test_redduck.py,sha256=ILtKKMuoyVfmhnibmbojpbOsqbcKooZv4j9qtE2LWdw,1750
 devduck/tools/__init__.py,sha256=GtqhtyTeWz3Glwj7MJ1ncKIQf_0KFu33AmtBOeIm3XY,1176
@@ -25,9 +25,9 @@ devduck/tools/tcp.py,sha256=w2m_Jf6vZ4NYu0AwgZd7C7eKs4No2EVHZ2WYIl_Bt0A,22017
 devduck/tools/tray.py,sha256=FgVhUtLdsdv5_ERK-RyAIpDE8Zb0IfoqhHQdwMxrHUQ,7547
 devduck/tools/use_github.py,sha256=nr3JSGk48mKUobpgW__2gu6lFyUj93a1XRs3I6vH8W4,13682
 devduck/tools/websocket.py,sha256=A8bqgdDZs8hcf2HctkJzQOzMvb5mXUC7YZ-xqkOyn94,16959
-devduck-1.1.5.dist-info/licenses/LICENSE,sha256=UANcoWwfVeuM9597WUkjEQbzqIUH0bJoE9Tpwgj_LvU,11345
-devduck-1.1.5.dist-info/METADATA,sha256=ZcfCUGNHo62mWRffSh_UUePWZcQuR9yYVSdLdNVOncM,21729
-devduck-1.1.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-devduck-1.1.5.dist-info/entry_points.txt,sha256=PJ8gvdi2MnKEK8yCwcmZDeLQ-lx94EV_jp4-v8AKuTA,58
-devduck-1.1.5.dist-info/top_level.txt,sha256=ySXWlVronp8xHYfQ_Hdfr463e0EnbWuqyuxs94EU7yk,8
-devduck-1.1.5.dist-info/RECORD,,
+devduck-1.1.6.dist-info/licenses/LICENSE,sha256=UANcoWwfVeuM9597WUkjEQbzqIUH0bJoE9Tpwgj_LvU,11345
+devduck-1.1.6.dist-info/METADATA,sha256=qM-9zZVITXW36-Bz6O3GkV9LLiI_XRj_agZve8ZIujA,24090
+devduck-1.1.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+devduck-1.1.6.dist-info/entry_points.txt,sha256=PJ8gvdi2MnKEK8yCwcmZDeLQ-lx94EV_jp4-v8AKuTA,58
+devduck-1.1.6.dist-info/top_level.txt,sha256=ySXWlVronp8xHYfQ_Hdfr463e0EnbWuqyuxs94EU7yk,8
+devduck-1.1.6.dist-info/RECORD,,