{"id":28995885,"url":"https://github.com/AgentDock/AgentDock","last_synced_at":"2025-06-25T05:03:15.110Z","repository":{"id":289123663,"uuid":"936395722","full_name":"AgentDock/AgentDock","owner":"AgentDock","description":"Build Anything with AI Agents","archived":false,"fork":false,"pushed_at":"2025-06-23T00:13:47.000Z","size":29518,"stargazers_count":1386,"open_issues_count":22,"forks_count":69,"subscribers_count":27,"default_branch":"main","last_synced_at":"2025-06-23T00:31:54.794Z","etag":null,"topics":["agentic-ai","agentic-framework","ai-agents","llm","natural-language-inference","nextjs","typescript","workflows"],"latest_commit_sha":null,"homepage":"https://agentdock.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AgentDock.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-21T02:29:23.000Z","updated_at":"2025-06-22T23:42:11.000Z","dependencies_parsed_at":"2025-06-23T00:23:50.610Z","dependency_job_id":"f1ec07af-49df-4468-b5d1-e2d9b6ac74a4","html_url":"https://github.com/AgentDock/AgentDock","commit_stats":null,"previous_names":["agentdock/agentdock"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/AgentDock/AgentDock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgentDock%2FAgentDock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgentDock%2FAgentDock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgentDock%2FAgentDock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgentDock%2FAgentDock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AgentDock","download_url":"https://codeload.github.com/AgentDock/AgentDock/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgentDock%2FAgentDock/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261807929,"owners_count":23212683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","agentic-framework","ai-agents","llm","natural-language-inference","nextjs","typescript","workflows"],"created_at":"2025-06-25T05:01:27.086Z","updated_at":"2025-06-25T05:03:15.094Z","avatar_url":"https://github.com/AgentDock.png","language":"TypeScript","funding_links":[],"categories":["Frameworks","Building","AI Agent Frameworks \u0026 SDKs","Agent Categories","🤖 AI \u0026 Machine Learning","TypeScript"],"sub_categories":["Frameworks","Cognitive Architecture Frameworks","\u003ca name=\"Unclassified\"\u003e\u003c/a\u003eUnclassified"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./public/AgentDock-logo.png\" alt=\"AgentDock Logo\" width=\"800\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"left\"\u003eBuild Anything with AI Agents\u003c/h1\u003e\n\n\n[![GitHub stars](https://img.shields.io/github/stars/agentdock/agentdock)](https://github.com/agentdock/agentdock/stargazers)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/AgentDock/AgentDock/blob/main/LICENSE)\n[![Status: Beta](https://img.shields.io/badge/Status-Beta-blue)](https://github.com/AgentDock/AgentDock/releases)\n[![Documentation](https://img.shields.io/badge/Documentation-📕-blue)](https://hub.agentdock.ai/docs)\n[![Discord](https://img.shields.io/discord/1335979387975110656?color=7289DA\u0026label=Discord\u0026logo=discord\u0026logoColor=white)](https://discord.gg/fDYFFmwuRA)\n[![Cloud](https://img.shields.io/badge/Cloud-☁️-blue)](https://agentdock.ai)\n[![Twitter Follow](https://img.shields.io/twitter/follow/AgentDock?style=social)](https://x.com/agentdock)\n\n\n\nAgentDock is a framework for building sophisticated AI agents that deliver complex tasks with **configurable determinism**. It consists of two main components:\n\n1. **AgentDock Core**: An open-source, backend-first framework for building and deploying AI agents. It's designed to be *framework-agnostic* and *provider-independent*, giving you complete control over your agent's implementation.\n\n2. **Open Source Client**: A complete Next.js application that serves as a reference implementation and consumer of the AgentDock Core framework. You can see it in action at [https://hub.agentdock.ai](https://hub.agentdock.ai)\n\nBuilt with TypeScript, AgentDock emphasizes *simplicity*, *extensibility*, and ***configurable determinism*** - making it ideal for building reliable and predictable AI systems that can operate with minimal supervision.\n\n\u003cbr\u003e\n\n[![AgentDock](https://github.com/user-attachments/assets/d8037f82-4091-4323-b7d2-4c1935777505)](https://agentdock.ai?utm_source=github\u0026utm_medium=readme\u0026utm_campaign=main)\n\n\u003cbr\u003e\n\n🌐 **AgentDock Pro Coming Soon**: Experience the future of AI automation with our comprehensive cloud platform featuring visual workflow builders, advanced orchestration, and enterprise-grade infrastructure. [Sign up at AgentDock.ai](https://agentdock.ai?utm_source=github\u0026utm_medium=readme\u0026utm_campaign=main) to secure early access and earn free platform credits when we launch.\n\n📖 **AI Agents Book**: Master the complete methodology for building production-ready AI agents with our comprehensive guide at **[AI Agents Book](https://agentdock.ai/docs/ai-agents-book?utm_source=github\u0026utm_medium=readme\u0026utm_campaign=main)** - covering everything from fundamentals to enterprise deployment patterns.\n\n🎯 **Comprehensive Prompt Library**: We're building the most extensive prompt library covering everyday automation needs and highly specialized vertical requirements. From general productivity to industry-specific workflows, our curated collection empowers agents with battle-tested prompts for any scenario.\n\n## Demos\n\n**[Dr. Gregory House](https://github.com/AgentDock/AgentDock/tree/main/agents/dr-house):** A diagnostic reasoning powerhouse that orchestrates **`search`**, **`deep_research`**, and **`pubmed`** tools in a multi-stage workflow to tackle complex medical cases using methodical investigation techniques that rival expert diagnosticians.\n\nhttps://github.com/user-attachments/assets/50c766dc-fc65-481c-aad2-9a71169c7b28\n\n\u003c/br\u003e\n\n**[Cognitive Reasoner](https://github.com/AgentDock/AgentDock/tree/main/agents/cognitive-reasoner):** Multi-stage reasoning engine that orchestrates seven specialized cognitive tools (**`search`**, **`think`**, **`reflect`**, **`compare`**, **`critique`**, **`brainstorm`**, **`debate`**) in configurable workflows to systematically deconstruct and solve complex problems with human-like reasoning patterns.\n\nhttps://github.com/user-attachments/assets/279a4e48-a980-4f83-becb-5e039fe10c56\n\n\u003c/br\u003e\n\n**[History Mentor](https://github.com/AgentDock/AgentDock/tree/main/agents/history-mentor):** Immersive educational agent combining vectorized historical knowledge with **`search`** capabilities and dynamic Mermaid diagram rendering to create authentic learning experiences that visualize complex historical relationships and timelines on demand.\n\nhttps://github.com/user-attachments/assets/56e80a15-eac3-452b-aa8b-efe7b7f3360c\n\n\u003c/br\u003e\n\n**[Calorie Vision](https://github.com/AgentDock/AgentDock/tree/main/agents/calorie-vision):** Vision-based nutritional analysis system that combines computer vision with structured data extraction to deliver precise macro and micronutrient breakdowns from food images, functioning like a nutritionist that can instantly quantify meal composition without relying on manual input.\n\nhttps://github.com/user-attachments/assets/6b4e71cf-accc-4c18-bb42-7bc5ad2f37e4\n\n\n\n\n\n## 🌐 README Translations\n\n[Français](./docs/i18n/french/README.md) • [日本語](./docs/i18n/japanese/README.md) • [한국어](./docs/i18n/korean/README.md) • [中文](./docs/i18n/chinese/README.md) • [Español](./docs/i18n/spanish/README.md) • [Deutsch](./docs/i18n/deutsch/README.md) • [Italiano](./docs/i18n/italian/README.md) • [Nederlands](./docs/i18n/dutch/README.md) • [Polski](./docs/i18n/polish/README.md) • [Türkçe](./docs/i18n/turkish/README.md) • [Українська](./docs/i18n/ukrainian/README.md) • [Ελληνικά](./docs/i18n/greek/README.md) • [Русский](./docs/i18n/russian/README.md) • [العربية](./docs/i18n/arabic/README.md)\n\n## 🧠 Design Principles\n\nAgentDock is built on these core principles:\n\n- **Simplicity First**: Minimal code required to create functional agents\n- **Node-Based Architecture**: All capabilities implemented as nodes\n- **Tools as Specialized Nodes**: Tools extend the node system for agent capabilities\n- **Configurable Determinism**: Control the predictability of agent behavior\n- **Type Safety**: Comprehensive TypeScript types throughout\n\n### Configurable Determinism\n\n***Configurable determinism*** is a cornerstone of AgentDock's design philosophy, enabling you to balance creative AI capabilities with predictable system behavior:\n\n- AgentNodes are inherently non-deterministic as LLMs may generate different responses each time\n- Workflows can be made more deterministic through *defined tool execution paths*\n- Developers can **control the level of determinism** by configuring which parts of the system use LLM inference\n- Even with LLM components, the overall system behavior remains **predictable** through structured tool interactions\n- This balanced approach enables both *creativity* and **reliability** in your AI applications\n\n#### Deterministic Workflows\n\nAgentDock fully supports the deterministic workflows you're familiar with from typical workflow builders. All the predictable execution paths and reliable outcomes you expect are available, with or without LLM inference:\n\n```mermaid\nflowchart LR\n  Input[Input] --\u003e Process[Process]\n  Process --\u003e Database[(Database)]\n  Process --\u003e Output[Output]\n  \n  style Input fill:#f9f9f9,stroke:#333,stroke-width:1px\n  style Output fill:#f9f9f9,stroke:#333,stroke-width:1px\n  style Process fill:#d4f1f9,stroke:#333,stroke-width:1px\n  style Database fill:#e8e8e8,stroke:#333,stroke-width:1px\n```\n\n#### Non-Deterministic Agent Behavior\n\nWith AgentDock, you can also leverage AgentNodes with LLMs when you need more adaptability. The creative outputs may vary based on your needs, while maintaining structured interaction patterns:\n\n```mermaid\nflowchart TD\n  Input[User Query] --\u003e Agent[AgentNode]\n  Agent --\u003e|\"LLM Reasoning (Non-Deterministic)\"| ToolChoice{Tool Selection}\n  ToolChoice --\u003e|\"Option A\"| ToolA[Deep Research Tool]\n  ToolChoice --\u003e|\"Option B\"| ToolB[Data Analysis Tool]\n  ToolChoice --\u003e|\"Option C\"| ToolC[Direct Response]\n  ToolA --\u003e Response[Final Response]\n  ToolB --\u003e Response\n  ToolC --\u003e Response\n  \n  style Input fill:#f9f9f9,stroke:#333,stroke-width:1px\n  style Agent fill:#ffdfba,stroke:#333,stroke-width:1px\n  style ToolChoice fill:#ffdfba,stroke:#333,stroke-width:1px\n  style ToolA fill:#d4f1f9,stroke:#333,stroke-width:1px\n  style ToolB fill:#d4f1f9,stroke:#333,stroke-width:1px\n  style ToolC fill:#d4f1f9,stroke:#333,stroke-width:1px\n  style Response fill:#f9f9f9,stroke:#333,stroke-width:1px\n```\n\n#### Non-Deterministic Agents with Deterministic Sub-Workflows\n\nAgentDock gives you the ***best of both worlds*** by combining non-deterministic agent intelligence with deterministic workflow execution:\n\n```mermaid\nflowchart TD\n  Input[User Query] --\u003e Agent[AgentNode]\n  Agent --\u003e|\"LLM Reasoning (Non-Deterministic)\"| FlowChoice{Sub-Workflow Selection}\n  FlowChoice --\u003e|\"Decision A\"| Flow1[Deterministic Workflow 1]\n  FlowChoice --\u003e|\"Decision B\"| Flow2[Deterministic Workflow 2]\n  FlowChoice --\u003e|\"Decision C\"| DirectResponse[Generate Response]\n  \n  Flow1 --\u003e |\"Step 1 → 2 → 3 → ... → 200\"| Flow1Result[Workflow 1 Result]\n  Flow2 --\u003e |\"Step 1 → 2 → 3 → ... → 100\"| Flow2Result[Workflow 2 Result]\n  \n  Flow1Result --\u003e Response[Final Response]\n  Flow2Result --\u003e Response\n  DirectResponse --\u003e Response\n  \n  style Input fill:#f9f9f9,stroke:#333,stroke-width:1px\n  style Agent fill:#ffdfba,stroke:#333,stroke-width:1px\n  style FlowChoice fill:#ffdfba,stroke:#333,stroke-width:1px\n  style Flow1 fill:#c9e4ca,stroke:#333,stroke-width:1px\n  style Flow2 fill:#c9e4ca,stroke:#333,stroke-width:1px\n  style Flow1Result fill:#c9e4ca,stroke:#333,stroke-width:1px\n  style Flow2Result fill:#c9e4ca,stroke:#333,stroke-width:1px\n  style DirectResponse fill:#ffdfba,stroke:#333,stroke-width:1px\n  style Response fill:#f9f9f9,stroke:#333,stroke-width:1px\n```\n\nThis approach enables complex multi-step workflows (potentially involving hundreds of deterministic steps implemented within tools or as connected node sequences) to be invoked by intelligent agent decisions. Each workflow executes predictably despite being triggered by non-deterministic agent reasoning.\n\nFor more advanced AI agent workflows and multi-stage processing pipelines, we're building [AgentDock Pro](docs/agentdock-pro.md) - a powerful platform for creating, visualizing, and running complex agent systems.\n\n#### TL;DR on Configurable Determinism \n\nThink of it like driving. Sometimes you need the AI's creativity (like navigating city streets - non-deterministic), and sometimes you need reliable, step-by-step processes (like following highway signs - deterministic). AgentDock lets you build systems that use *both*, choosing the right approach for each part of a task. You get the AI's smarts *and* predictable results where needed.\n\n\n## 🏗️ Core Architecture\n\nThe framework is built around a powerful, modular node-based system, serving as the foundation for all agent functionality. This architecture uses distinct node types as building blocks:\n\n-   **`BaseNode`**: The fundamental class establishing the core interface and capabilities for all nodes.\n-   **`AgentNode`**: A specialized core node orchestrating LLM interactions, tool usage, and agent logic.\n-   **Tools \u0026 Custom Nodes**: Developers implement agent capabilities and custom logic as nodes extending `BaseNode`.\n\nThese nodes interact through managed registries and can be connected (leveraging the core architecture's ports and potential message bus) to enable complex, configurable, and potentially deterministic agent behaviors and workflows.\n\nFor a detailed explanation of the node system's components and capabilities, please see the [Node System Documentation](docs/nodes/README.md).\n\n## 🚀 Getting Started\n\nFor a comprehensive guide, see the [Getting Started Guide](docs/getting-started.md).\n\n### Requirements\n\n* Node.js ≥ 20.11.0 (LTS)\n* pnpm ≥ 9.15.0 (Required)\n* API keys for LLM providers (Anthropic, OpenAI, etc.)\n\n### Installation\n\n1. **Clone the Repository**:\n\n   ```bash\n   git clone https://github.com/AgentDock/AgentDock.git\n   cd AgentDock\n   ```\n\n2. **Install pnpm**:\n\n   ```bash\n   corepack enable\n   corepack prepare pnpm@latest --activate\n   ```\n\n3. **Install Dependencies**:\n\n   ```bash\n   pnpm install\n   ```\n   \n   For a clean reinstallation (when you need to rebuild from scratch):\n   ```bash\n   pnpm run clean-install\n   ```\n   This script removes all node_modules, lock files, and reinstalls dependencies correctly.\n\n4. **Configure Environment**:\n   \n   Create an environment file (`.env` or `.env.local`) based on `.env.example`:\n   \n   ```bash\n   # Option 1: Create .env.local\n   cp .env.example .env.local\n   \n   # Option 2: Create .env\n   cp .env.example .env\n   ```\n   \n   Then add your API keys to the environment file.\n\n5. **Start Development Server**:\n\n   ```bash\n   pnpm dev\n   ```\n## Deploy the Open Source Client\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FAgentDock%2FAgentDock)\n\nClick the button above to deploy the AgentDock Open Source Client directly to your Vercel account. \n\n### Advanced Capabilities\n\n| Capability             | Description                                                                    | Documentation                                                        |\n|------------------------|--------------------------------------------------------------------------------|----------------------------------------------------------------------|\n| **Session Management** | Isolated, performant state management for conversations                        | [Session Documentation](./docs/architecture/sessions/README.md)      |\n| **Orchestration Framework** | Control agent behavior and tool availability based on context                  | [Orchestration Documentation](./docs/architecture/orchestration/README.md) |\n| **Storage Abstraction**  | Flexible storage system with pluggable providers for KV, Vector, and Secure storage | [Storage Documentation](./docs/storage/README.md)                    |\n| **Evaluation Framework** | Systematically measure and improve agent quality with diverse evaluators       | [Evaluation Documentation](./docs/evaluations/README.md)             |\n\nThe storage system is currently evolving with key-value storage (Memory, Redis, Vercel KV providers) and secure client-side storage, while vector storage and additional backends are in development.\n\n## 📕 Documentation\n\nDocumentation for the AgentDock framework is available at [hub.agentdock.ai/docs](https://hub.agentdock.ai/docs) and in the `/docs/` folder of this repository. The documentation includes:\n\n- Getting started guides\n- API references\n- Node creation tutorials\n- Integration examples\n\nFor comprehensive ecosystem documentation and guides, visit [agentdock.ai/docs](https://agentdock.ai/docs).\n\n## 📂 Repository Structure\n\nThis repository contains:\n\n1.  **AgentDock Core**: The core framework located in `agentdock-core/`\n2.  **Open Source Client**: A complete reference implementation built with Next.js, serving as a consumer of the AgentDock Core framework.\n3.  **Example Agents**: Ready-to-use agent configurations in the `agents/` directory\n4.  **AI Agents Book**: Comprehensive guide content in the `content/ai-agents-book/` directory\n\nYou can use AgentDock Core independently in your own applications, or use this repository as a starting point for building your own agent-powered applications.\n\n## 📝 Agent Templates\n\nAgentDock includes several pre-configured agent templates. Explore them in the `agents/` directory or read the [Agent Templates Documentation](docs/agent-templates.md) for details on configuration.\n\n## 🔧 Example Implementations\n\nExample implementations showcase specialized use cases and advanced functionality:\n\n| Implementation | Description | Status |\n|----------------|-------------|--------|\n| **Orchestrated Agent** | Example agent using orchestration to adapt behavior based on context | Available |\n| **Cognitive Reasoner** | Tackles complex problems using structured reasoning \u0026 cognitive tools | Available |\n| **Agent Planner** | Specialized agent for designing and implementing other AI agents | Available |\n| [**Code Playground**](docs/roadmap/code-playground.md) | Sandboxed code generation and execution with rich visualization capabilities | Planned |\n| [**Generalist AI Agent**](docs/roadmap/generalist-agent.md) | Manus-like agent that can use browser and execute complex tasks | Planned |\n\n\n\n## 🔐 Environment Configuration Details\n\nThe AgentDock Open Source Client requires API keys for LLM providers to function. These are configured in an environment file (`.env` or `.env.local`) which you create based on the provided `.env.example` file.\n\n### LLM Provider API Keys\n\nAdd your LLM provider API keys (at least one is required):\n\n```bash\n# LLM Provider API Keys - at least one is required\nANTHROPIC_API_KEY=sk-ant-xxxxxxx  # Anthropic API key\nOPENAI_API_KEY=sk-xxxxxxx         # OpenAI API key\nGEMINI_API_KEY=xxxxxxx            # Google Gemini API key\nDEEPSEEK_API_KEY=xxxxxxx          # DeepSeek API key\nGROQ_API_KEY=xxxxxxx              # Groq API key\n```\n\n### API Key Resolution\n\nThe AgentDock Open Source Client follows a priority order when resolving which API key to use:\n\n1. **Per-agent custom API key** (set via agent settings in the UI)\n2. **Global settings API key** (set via the settings page in the UI)\n3. **Environment variable** (from .env.local or deployment platform)\n\n### Tool-specific API Keys\n\nSome tools also require their own API keys:\n\n```bash\n# Tool-specific API Keys\nSERPER_API_KEY=                  # Required for search functionality\nFIRECRAWL_API_KEY=               # Required for deeper web search\n```\n\nFor more details about environment configuration, see the implementation in [`src/types/env.ts`](src/types/env.ts).\n\n### Using Your Own API Keys (BYOK)\n\nAgentDock follows a BYOK (Bring Your Own Key) model:\n\n1. Add your API keys in the settings page of the application\n2. Alternatively, provide keys via request headers for direct API usage\n3. Keys are securely stored using the built-in encryption system\n4. No API keys are shared or stored on our servers\n\n## 📦 Package Manager\n\nThis project *requires* the use of `pnpm` for consistent dependency management. `npm` and `yarn` are not supported.\n\n## 💡 What You Can Build\n\n1. **AI-Powered Applications**\n   - Custom chatbots with any frontend\n   - Command-line AI assistants\n   - Automated data processing pipelines\n   - Backend service integrations\n\n2. **Integration Capabilities**\n   - Any AI provider (OpenAI, Anthropic, etc.)\n   - Any frontend framework\n   - Any backend service\n   - Custom data sources and APIs\n\n3. **Automation Systems**\n   - Data processing workflows\n   - Document analysis pipelines\n   - Automated reporting systems\n   - Task automation agents\n\n## Key Features\n\n| Feature                 | Description                                                               |\n|-------------------------|---------------------------------------------------------------------------|\n| 🔌 **Framework Agnostic (Node.js Backend)** | Core library integrates with Node.js backend stacks.                      |\n| 🧩 **Modular Design**     | Build complex systems from simple nodes                                   |\n| 🛠️ **Extensible**         | Create custom nodes for any functionality                                 |\n| 🔒 **Secure**             | Built-in security features for API keys and data                          |\n| 🔑 **BYOK**               | Use your *own API keys* for LLM providers                                 |\n| 📦 **Self-Contained**     | Core framework has minimal dependencies                                   |\n| ⚙️ **Multi-Step Tool Calls** | Support for *complex reasoning chains*                                    |\n| 📊 **Structured Logging** | Detailed insights into agent execution                                    |\n| 🛡️ **Robust Error Handling**| Predictable behavior and simplified debugging                            |\n| 📝 **TypeScript First**   | Type safety and enhanced developer experience                             |\n| 🌐 **Open Source Client** | Complete Next.js reference implementation included                       |\n| 🔄 **Orchestration**      | *Dynamic control* of agent behavior based on context                      |\n| 💾 **Session Management** | Isolated state for concurrent conversations                               |\n| 🎮 **Configurable Determinism** | Balance AI creativity \u0026 predictability via node logic/workflows        |\n| 📊 **Evaluation Framework** | Robust tools to define, run, and analyze agent performance evaluations   |\n\n## 🧰 Components\n\nAgentDock's modular architecture is built upon these key components:\n\n*   **BaseNode**: The foundation for all nodes in the system\n*   **AgentNode**: The primary abstraction for agent functionality\n*   **Tools \u0026 Custom Nodes**: Callable capabilities and custom logic implemented as nodes.\n*   **Node Registry**: Manages the registration and retrieval of all node types\n*   **Tool Registry**: Manages tool availability for agents\n*   **CoreLLM**: Unified interface for interacting with LLM providers\n*   **Provider Registry**: Manages LLM provider configurations\n*   **Evaluation Framework**: Core components for agent assessment\n*   **Error Handling**: System for handling errors and ensuring predictable behavior\n*   **Logging**: Structured logging system for monitoring and debugging\n*   **Orchestration**: Controls tool availability and behavior based on conversation context\n*   **Sessions**: Manages state isolation between concurrent conversations\n\nFor detailed technical documentation on these components, see the [Architecture Overview](docs/architecture/README.md).\n\n\n\n## 🗺️ Roadmap\n\nBelow is our development roadmap for AgentDock. Most improvements listed here relate to the core AgentDock framework (`agentdock-core`), which is currently developed locally and will be published as a versioned NPM package upon reaching a stable release. Some roadmap items may also involve enhancements to the open-source client implementation.\n\n| Feature | Description | Category |\n|---------|-------------|--------|\n| [**Storage Abstraction Layer**](docs/roadmap/storage-abstraction.md) | Flexible storage system with pluggable providers | **In Progress** |\n| [**Advanced Memory Systems**](docs/roadmap/advanced-memory.md) | Long-term context management | **In Progress** |\n| [**Vector Storage Integration**](docs/roadmap/vector-storage.md) | Embedding-based retrieval for documents and memory | **In Progress** |\n| [**Evaluation for AI Agents**](docs/roadmap/evaluation-framework.md) | Comprehensive testing and evaluation framework | **In Progress** |\n| [**Platform Integration**](docs/roadmap/platform-integration.md) | Support for Telegram, WhatsApp, and other messaging platforms | **Planned** |\n| [**Multi-Agent Collaboration**](docs/roadmap/multi-agent-collaboration.md) | Enable agents to work together | **Planned** |\n| [**Model Context Protocol (MCP) Integration**](docs/roadmap/mcp-integration.md) | Support for discovering and using external tools via MCP | **Planned** |\n| [**Voice AI Agents**](docs/roadmap/voice-agents.md) | AI agents using voice interfaces and phone numbers via AgentNode | **Planned** |\n| [**Telemetry and Traceability**](docs/roadmap/telemetry.md) | Advanced logging and performance tracking | **Planned** |\n| [**Workflow Runtime \u0026 Nodes**](docs/roadmap/workflow-nodes.md) | Core runtime, node types, and orchestration logic for complex automations | **Planned** |\n| [**AgentDock Pro**](docs/agentdock-pro.md) | Comprehensive enterprise cloud platform for scaling AI agents \u0026 workflows | **Cloud** |\n| [**Natural Language AI Agent Builder**](docs/roadmap/nl-agent-builder.md) | Visual builder + natural language agent and workflow construction | **Cloud** |\n| [**Agent Marketplace**](docs/roadmap/agent-marketplace.md) | Monetizable agent templates | **Cloud** |\n\n## 👥 Contributing\n\nWe welcome contributions to AgentDock! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) for detailed contribution guidelines.\n\n## 📜 License\n\nAgentDock is released under the [MIT License](LICENSE).\n\n## ✨ Build Anything!\n\nAgentDock provides the foundation to build almost any AI-powered application or automation you can imagine. We encourage you to explore the framework, build innovative agents, and contribute back to the community. Let's build the future of AI interaction together!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAgentDock%2FAgentDock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAgentDock%2FAgentDock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAgentDock%2FAgentDock/lists"}