devduck 0.1.0__tar.gz → 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of devduck might be problematic. Click here for more details.

Files changed (30) hide show
  1. {devduck-0.1.0/devduck.egg-info → devduck-0.2.0}/PKG-INFO +48 -11
  2. {devduck-0.1.0 → devduck-0.2.0}/README.md +42 -5
  3. {devduck-0.1.0 → devduck-0.2.0}/devduck/__init__.py +546 -91
  4. devduck-0.2.0/devduck/__main__.py +7 -0
  5. devduck-0.2.0/devduck/_version.py +34 -0
  6. devduck-0.2.0/devduck/tools/__init__.py +7 -0
  7. devduck-0.2.0/devduck/tools/install_tools.py +308 -0
  8. devduck-0.2.0/devduck/tools/mcp_server.py +572 -0
  9. devduck-0.2.0/devduck/tools/tcp.py +627 -0
  10. devduck-0.2.0/devduck/tools/websocket.py +492 -0
  11. {devduck-0.1.0 → devduck-0.2.0/devduck.egg-info}/PKG-INFO +48 -11
  12. {devduck-0.1.0 → devduck-0.2.0}/devduck.egg-info/SOURCES.txt +7 -2
  13. {devduck-0.1.0 → devduck-0.2.0}/devduck.egg-info/requires.txt +5 -0
  14. devduck-0.2.0/docs/index.html +524 -0
  15. {devduck-0.1.0 → devduck-0.2.0}/pyproject.toml +5 -0
  16. devduck-0.2.0/test.py +3 -0
  17. devduck-0.1.0/devduck/tools/__init__.py +0 -0
  18. devduck-0.1.0/devduck/tools/tcp.py +0 -457
  19. devduck-0.1.0/setup.py +0 -67
  20. devduck-0.1.0/test.py +0 -3
  21. {devduck-0.1.0 → devduck-0.2.0}/.gitignore +0 -0
  22. {devduck-0.1.0 → devduck-0.2.0}/LICENSE +0 -0
  23. {devduck-0.1.0 → devduck-0.2.0}/MANIFEST.in +0 -0
  24. {devduck-0.1.0 → devduck-0.2.0}/devduck/install.sh +0 -0
  25. {devduck-0.1.0 → devduck-0.2.0}/devduck/test_redduck.py +0 -0
  26. {devduck-0.1.0 → devduck-0.2.0}/devduck.egg-info/dependency_links.txt +0 -0
  27. {devduck-0.1.0 → devduck-0.2.0}/devduck.egg-info/entry_points.txt +0 -0
  28. {devduck-0.1.0 → devduck-0.2.0}/devduck.egg-info/top_level.txt +0 -0
  29. {devduck-0.1.0 → devduck-0.2.0}/install.sh +0 -0
  30. {devduck-0.1.0 → devduck-0.2.0}/setup.cfg +0 -0
@@ -1,9 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: devduck
3
- Version: 0.1.0
3
+ Version: 0.2.0
4
4
  Summary: 🦆 Extreme minimalist self-adapting AI agent - one file, self-healing, runtime dependencies
5
- Home-page: https://github.com/cagataycali/devduck
6
- Author: maxs
7
5
  Author-email: duck <hey@devduck.dev>
8
6
  License-Expression: MIT
9
7
  Project-URL: Homepage, https://github.com/cagataycali/devduck
@@ -33,10 +31,12 @@ Requires-Dist: strands-agents[ollama]
33
31
  Requires-Dist: strands-agents[openai]
34
32
  Requires-Dist: strands-agents[anthropic]
35
33
  Requires-Dist: strands-agents-tools
36
- Dynamic: author
37
- Dynamic: home-page
34
+ Requires-Dist: strands-fun-tools[audio]
35
+ Requires-Dist: strands-fun-tools[vision]
36
+ Requires-Dist: strands-fun-tools[all]
37
+ Requires-Dist: websockets
38
+ Requires-Dist: prompt_toolkit
38
39
  Dynamic: license-file
39
- Dynamic: requires-python
40
40
 
41
41
  # 🦆 DevDuck
42
42
 
@@ -55,18 +55,54 @@ Requires: Python 3.10+, Ollama running
55
55
  ## Use
56
56
 
57
57
  ```bash
58
- # CLI
59
- devduck "what's the time?"
60
-
61
- # Interactive
58
+ # Start DevDuck (auto-starts TCP, WebSocket, MCP servers)
62
59
  devduck
63
60
 
61
+ # CLI mode
62
+ devduck "what's the time?"
63
+
64
64
  # Python
65
65
  import devduck
66
-
67
66
  devduck("calculate 2+2")
68
67
  ```
69
68
 
69
+ ## Auto-Started Servers
70
+
71
+ When you run `devduck`, three servers start automatically:
72
+
73
+ - **🌐 Web UI**: [http://cagataycali.github.io/devduck](http://cagataycali.github.io/devduck) (auto-connects)
74
+ - **🔌 TCP**: `nc localhost 9999` (raw socket)
75
+ - **🌊 WebSocket**: `ws://localhost:8080` (structured JSON)
76
+ - **🔗 MCP**: `http://localhost:8000/mcp` (Model Context Protocol)
77
+
78
+ ### Connect via MCP
79
+
80
+ Add to your MCP client (e.g., Claude Desktop):
81
+
82
+ ```json
83
+ {
84
+ "mcpServers": {
85
+ "devduck": {
86
+ "command": "uvx",
87
+ "args": [
88
+ "strands-mcp-server",
89
+ "--upstream-url",
90
+ "http://localhost:8000/mcp/"
91
+ ],
92
+ "disabled": false
93
+ }
94
+ }
95
+ }
96
+ ```
97
+
98
+ ### Connect via Terminal
99
+
100
+ ```bash
101
+ # Direct TCP connection
102
+ nc localhost 9999
103
+ > what's the time?
104
+ ```
105
+
70
106
  ## Features
71
107
 
72
108
  - **Self-healing** - Auto-fixes deps, models, errors
@@ -74,6 +110,7 @@ devduck("calculate 2+2")
74
110
  - **Adaptive** - Picks model based on OS (macOS: 1.7b, Linux: 30b)
75
111
  - **14 tools** - shell, editor, files, python, calculator, tcp, etc.
76
112
  - **History aware** - Remembers shell/conversation context
113
+ - **Multi-protocol** - TCP, WebSocket, MCP, CLI, Python
77
114
 
78
115
  ## Create Tool
79
116
 
@@ -15,18 +15,54 @@ Requires: Python 3.10+, Ollama running
15
15
  ## Use
16
16
 
17
17
  ```bash
18
- # CLI
19
- devduck "what's the time?"
20
-
21
- # Interactive
18
+ # Start DevDuck (auto-starts TCP, WebSocket, MCP servers)
22
19
  devduck
23
20
 
21
+ # CLI mode
22
+ devduck "what's the time?"
23
+
24
24
  # Python
25
25
  import devduck
26
-
27
26
  devduck("calculate 2+2")
28
27
  ```
29
28
 
29
+ ## Auto-Started Servers
30
+
31
+ When you run `devduck`, three servers start automatically:
32
+
33
+ - **🌐 Web UI**: [http://cagataycali.github.io/devduck](http://cagataycali.github.io/devduck) (auto-connects)
34
+ - **🔌 TCP**: `nc localhost 9999` (raw socket)
35
+ - **🌊 WebSocket**: `ws://localhost:8080` (structured JSON)
36
+ - **🔗 MCP**: `http://localhost:8000/mcp` (Model Context Protocol)
37
+
38
+ ### Connect via MCP
39
+
40
+ Add to your MCP client (e.g., Claude Desktop):
41
+
42
+ ```json
43
+ {
44
+ "mcpServers": {
45
+ "devduck": {
46
+ "command": "uvx",
47
+ "args": [
48
+ "strands-mcp-server",
49
+ "--upstream-url",
50
+ "http://localhost:8000/mcp/"
51
+ ],
52
+ "disabled": false
53
+ }
54
+ }
55
+ }
56
+ ```
57
+
58
+ ### Connect via Terminal
59
+
60
+ ```bash
61
+ # Direct TCP connection
62
+ nc localhost 9999
63
+ > what's the time?
64
+ ```
65
+
30
66
  ## Features
31
67
 
32
68
  - **Self-healing** - Auto-fixes deps, models, errors
@@ -34,6 +70,7 @@ devduck("calculate 2+2")
34
70
  - **Adaptive** - Picks model based on OS (macOS: 1.7b, Linux: 30b)
35
71
  - **14 tools** - shell, editor, files, python, calculator, tcp, etc.
36
72
  - **History aware** - Remembers shell/conversation context
73
+ - **Multi-protocol** - TCP, WebSocket, MCP, CLI, Python
37
74
 
38
75
  ## Create Tool
39
76