devduck 0.1.1766644714__tar.gz → 0.3.0__tar.gz

{devduck-0.1.1766644714 → devduck-0.3.0}/.github/workflows/agent.yml

@@ -1,8 +1,8 @@
 name: DevDuck
 
 on:
-  # schedule:
-  #   - cron: '0 8 * * *'
+  schedule:
+    - cron: '0 8 * * *'
   issues:
     types: [opened, edited, closed, reopened, assigned, unassigned, labeled, unlabeled]
   issue_comment:

devduck-0.3.0/.gitignore

@@ -0,0 +1,8 @@
+.venv
+*.egg
+*.egg-info
+__pycache__
+*.bak
+dist/
+build
+_version.py

devduck-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 maxs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

devduck-0.3.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: devduck
+Version: 0.3.0
+Summary: 🦆 Extreme minimalist self-adapting AI agent - one file, self-healing, runtime dependencies
+Author-email: duck <hey@devduck.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/cagataycali/devduck
+Project-URL: Repository, https://github.com/cagataycali/devduck.git
+Project-URL: Documentation, https://github.com/cagataycali/devduck#readme
+Project-URL: Bug Tracker, https://github.com/cagataycali/devduck/issues
+Keywords: ai,agent,minimalist,self-healing,ollama,strands-agents
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: strands-agents
+Requires-Dist: prompt_toolkit
+Requires-Dist: strands-agents[ollama]
+Requires-Dist: strands-agents-tools
+Requires-Dist: strands-agentcore-tools
+Requires-Dist: beautifulsoup4
+Requires-Dist: colorama
+Requires-Dist: websockets
+Provides-Extra: all
+Requires-Dist: strands-agents[openai]; extra == "all"
+Requires-Dist: strands-agents[anthropic]; extra == "all"
+Requires-Dist: strands-fun-tools[audio]; extra == "all"
+Requires-Dist: strands-fun-tools[vision]; extra == "all"
+Requires-Dist: strands-fun-tools[all]; extra == "all"
+Requires-Dist: strands-mcp-server; extra == "all"
+Dynamic: license-file
+
+# 🦆 DevDuck
+
+**One file. Self-healing. Adaptive.**
+
+Minimalist AI agent that fixes itself when things break.
+
+## Install
+
+```bash
+# Minimal install
+pipx install devduck
+
+# Full install (all tools)
+pipx install "devduck[all]"
+```
+
+Requires: Python 3.10+, Ollama running (or set MODEL_PROVIDER)
+
+## Use
+
+```bash
+# Start DevDuck (auto-starts TCP, WebSocket, MCP servers)
+devduck
+
+# CLI mode
+devduck "what's the time?"
+
+# Python
+import devduck
+devduck("calculate 2+2")
+```
+
+## Auto-Started Servers
+
+When you run `devduck`, three servers start automatically:
+
+- **🌐 Web UI**: [http://cagataycali.github.io/devduck](http://cagataycali.github.io/devduck) (auto-connects)
+- **🔌 TCP**: `nc localhost 9999` (raw socket)
+- **🌊 WebSocket**: `ws://localhost:8080` (structured JSON)
+- **🔗 MCP**: `http://localhost:8000/mcp` (Model Context Protocol)
+
+### Connect via MCP
+
+Add to your MCP client (e.g., Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "devduck": {
+      "command": "uvx",
+      "args": [
+        "strands-mcp-server",
+        "--upstream-url",
+        "http://localhost:8000/mcp/"
+      ],
+      "disabled": false
+    }
+  }
+}
+```
+
+### Connect via Terminal
+
+```bash
+# Direct TCP connection
+nc localhost 9999
+> what's the time?
+```
+
+## Features
+
+- **Self-healing** - Auto-fixes deps, models, errors
+- **Hot-reload** - Create tools in `./tools/*.py`, use instantly
+- **Adaptive** - Picks model based on OS (macOS: 1.7b, Linux: 30b)
+- **14 tools** - shell, editor, files, python, calculator, tcp, etc.
+- **History aware** - Remembers shell/conversation context
+- **Multi-protocol** - TCP, WebSocket, MCP, CLI, Python
+
+## Create Tool
+
+```python
+# ./tools/greet.py
+from strands import tool
+
+@tool
+def greet(name: str) -> str:
+    return f"Hello {name}!"
+```
+
+Save. Done. Use immediately.
+
+## Multi-Model
+
+```bash
+export MODEL_PROVIDER="bedrock"
+export STRANDS_MODEL_ID="us.anthropic.claude-sonnet-4-5-20250929-v1:0"
+export STRANDS_ADDITIONAL_REQUEST_FIELDS='{"anthropic_beta": ["interleaved-thinking-2025-05-14", "context-1m-2025-08-07"], "thinking": {"type": "enabled", "budget_tokens": 2048}}'
+export STRANDS_MAX_TOKENS="64000"
+
+devduck "analyze data"
+```
+
+---
+
+**Quack.** 🦆
+
+*Built with [Strands Agents SDK](https://github.com/strands-agents/sdk-python)*

devduck-0.3.0/README.md

@@ -0,0 +1,107 @@
+# 🦆 DevDuck
+
+**One file. Self-healing. Adaptive.**
+
+Minimalist AI agent that fixes itself when things break.
+
+## Install
+
+```bash
+# Minimal install
+pipx install devduck
+
+# Full install (all tools)
+pipx install "devduck[all]"
+```
+
+Requires: Python 3.10+, Ollama running (or set MODEL_PROVIDER)
+
+## Use
+
+```bash
+# Start DevDuck (auto-starts TCP, WebSocket, MCP servers)
+devduck
+
+# CLI mode
+devduck "what's the time?"
+
+# Python
+import devduck
+devduck("calculate 2+2")
+```
+
+## Auto-Started Servers
+
+When you run `devduck`, three servers start automatically:
+
+- **🌐 Web UI**: [http://cagataycali.github.io/devduck](http://cagataycali.github.io/devduck) (auto-connects)
+- **🔌 TCP**: `nc localhost 9999` (raw socket)
+- **🌊 WebSocket**: `ws://localhost:8080` (structured JSON)
+- **🔗 MCP**: `http://localhost:8000/mcp` (Model Context Protocol)
+
+### Connect via MCP
+
+Add to your MCP client (e.g., Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "devduck": {
+      "command": "uvx",
+      "args": [
+        "strands-mcp-server",
+        "--upstream-url",
+        "http://localhost:8000/mcp/"
+      ],
+      "disabled": false
+    }
+  }
+}
+```
+
+### Connect via Terminal
+
+```bash
+# Direct TCP connection
+nc localhost 9999
+> what's the time?
+```
+
+## Features
+
+- **Self-healing** - Auto-fixes deps, models, errors
+- **Hot-reload** - Create tools in `./tools/*.py`, use instantly
+- **Adaptive** - Picks model based on OS (macOS: 1.7b, Linux: 30b)
+- **14 tools** - shell, editor, files, python, calculator, tcp, etc.
+- **History aware** - Remembers shell/conversation context
+- **Multi-protocol** - TCP, WebSocket, MCP, CLI, Python
+
+## Create Tool
+
+```python
+# ./tools/greet.py
+from strands import tool
+
+@tool
+def greet(name: str) -> str:
+    return f"Hello {name}!"
+```
+
+Save. Done. Use immediately.
+
+## Multi-Model
+
+```bash
+export MODEL_PROVIDER="bedrock"
+export STRANDS_MODEL_ID="us.anthropic.claude-sonnet-4-5-20250929-v1:0"
+export STRANDS_ADDITIONAL_REQUEST_FIELDS='{"anthropic_beta": ["interleaved-thinking-2025-05-14", "context-1m-2025-08-07"], "thinking": {"type": "enabled", "budget_tokens": 2048}}'
+export STRANDS_MAX_TOKENS="64000"
+
+devduck "analyze data"
+```
+
+---
+
+**Quack.** 🦆
+
+*Built with [Strands Agents SDK](https://github.com/strands-agents/sdk-python)*

{devduck-0.1.1766644714 → devduck-0.3.0}/action.yml

@@ -1,4 +1,4 @@
-name: 'DevDuck Action'
+name: 'DevDuck'
 description: 'Quack.'
 author: 'Cagatay Cali'
 
@@ -42,7 +42,7 @@ inputs:
   tools:
     description: 'Comma-separated list of tools to enable'
     required: false
-    default: 'strands_tools:current_time'
+    default: 'current_time'
   
   # Authentication & Access
   github_token:
@@ -100,7 +100,15 @@ outputs:
 runs:
   using: 'composite'
   steps:
+    - name: Use Homebrew Python 3.13
+      if: runner.os == 'macOS'
+      shell: bash
+      run: |
+        echo "/opt/homebrew/opt/python@3.13/libexec/bin" >> $GITHUB_PATH
+        echo "/opt/homebrew/bin" >> $GITHUB_PATH
+
     - name: Set up Python
+      if: runner.os != 'macOS'
       uses: actions/setup-python@v4
       with:
         python-version: '3.13'
@@ -127,16 +135,22 @@ runs:
         curl -LsSf https://astral.sh/uv/install.sh | sh
         echo "$HOME/.cargo/bin" >> $GITHUB_PATH
 
-    - name: Install DevDuck
+    - name: Install Strands Agents
+      shell: bash
+      run: |
+        uv pip install --system -r requirements.txt --quiet
+
+    - name: Install Local Dependencies
+      if: runner.os == 'macOS'
       shell: bash
       run: |
-        uv pip install devduck --system --quiet
+        uv pip install --system -r requirements-local.txt --quiet
 
     - name: Configure Git
       shell: bash
       run: |
         git config --global user.name "DevDuck" 2>/dev/null
-        git config --global user.email "hey@redduck.dev" 2>/dev/null
+        git config --global user.email "hey@strands.my" 2>/dev/null
 
     - name: Configure AWS credentials
       if: inputs.aws_role_arn != ''