πŸ¦†

DevDuck

Extreme minimalist self-adapting AI agent

πŸ”§ Self-Healing 🎬 Session Recording πŸŒ™ Ambient Mode πŸ”Œ Zenoh P2P
↓ Scroll to explore

Why DevDuck?

A single-file AI agent that's self-aware, self-healing, and ridiculously powerful.

🎬

Session Recording & Resume

Record complete sessions with three-layer capture (sys/tool/agent). Resume from any snapshot with full conversation state restored.

Learn more β†’
πŸŒ™

Ambient Mode

Background thinking while you're idle. Standard mode explores topics; autonomous mode builds entire features.

Learn more β†’
πŸ”„

Hot Reload

Modify the agent while it's running. Code changes apply instantly without restart. Protected during execution.

πŸ”Œ

Zenoh P2P Networking

Multiple DevDuck instances auto-discover each other. Broadcast commands to all or send to specific peers.

Learn more β†’
πŸ› οΈ

Dynamic Tool Loading

Load tools from any Python package at runtime. Fetch tools from GitHub URLs. MCP server integration.

Learn more β†’
🧠

Self-Aware

Full access to its own source code. Can read, understand, and modify itself. Answers questions about its implementation.

πŸ’Ύ

Knowledge Base RAG

Automatic retrieval and storage with Amazon Bedrock Knowledge Bases. Seamless memory across sessions.

Learn more β†’
🌐

WebSocket Server

Built-in WebSocket server for real-time streaming. Connect from browsers, apps, or other agents.

πŸ”—

MCP Integration

Expose DevDuck as MCP server for Claude Desktop, or load external MCP servers to extend capabilities.

Learn more β†’
🌍

Run Anywhere

One-click setup for Linux, macOS, Windows, Docker, Android, and Cloud. Generate custom install scripts.

Setup wizard β†’
πŸ”„

Hot Reload

Modify the agent while it's running. Code changes apply instantly without restart. Protected during execution.

Learn more β†’

Quick Start

Get DevDuck running in under a minute.

1

Install

pipx install devduck
2

Run

devduck
3

Query

devduck "build me a web scraper"

More Ways to Use

🎬 Record: devduck --record
▢️ Resume: devduck --resume session.zip
πŸŒ™ Ambient: DEVDUCK_AMBIENT_MODE=true devduck
πŸ”Œ MCP: devduck --mcp (for Claude Desktop)
🐍 Python: from devduck import ask
🌐 Zenoh: ZENOH_CONNECT=tcp/host:7447 devduck
# Python API
from devduck import ask, status, devduck

# Quick query
result = ask("create a REST API")

# Direct agent access
result = devduck("analyze this codebase")

# Session recording
from devduck import start_recording, stop_recording, load_session

start_recording()
# ... work ...
export_path = stop_recording()

# Resume session
session = load_session("session.zip")
session.resume_from_snapshot(2, agent=devduck.agent)

Try It Live

Connect to a running DevDuck instance via WebSocket.

πŸ’¬ DevDuck Chat

WebSocket: localhost:8080

Session Recording & Replay

Time-travel debugging for AI agents with full state restoration.

πŸ“Έ

State Snapshots

Capture complete agent state including conversation history, system prompt, model info, and working directory.

πŸ’¬

Conversation Restore

Full agent.messages array stored in snapshots. Resume with complete contextβ€”like hitting pause and play.

πŸ”

Three-Layer Events

Sys (file I/O, network), Tool (calls & results), Agent (messages, decisions). Complete visibility.

πŸ“– Recording Docs ▢️ Session Player