Package Exports
- agdi
- agdi/extension-api
- agdi/plugin-sdk
- agdi/plugin-sdk/account-helpers
- agdi/plugin-sdk/account-id
- agdi/plugin-sdk/account-resolution
- agdi/plugin-sdk/acp-runtime
- agdi/plugin-sdk/agent-runtime
- agdi/plugin-sdk/allow-from
- agdi/plugin-sdk/allowlist-config-edit
- agdi/plugin-sdk/bluebubbles
- agdi/plugin-sdk/boolean-param
- agdi/plugin-sdk/channel-actions
- agdi/plugin-sdk/channel-config-helpers
- agdi/plugin-sdk/channel-config-schema
- agdi/plugin-sdk/channel-contract
- agdi/plugin-sdk/channel-feedback
- agdi/plugin-sdk/channel-inbound
- agdi/plugin-sdk/channel-lifecycle
- agdi/plugin-sdk/channel-pairing
- agdi/plugin-sdk/channel-policy
- agdi/plugin-sdk/channel-reply-pipeline
- agdi/plugin-sdk/channel-runtime
- agdi/plugin-sdk/channel-send-result
- agdi/plugin-sdk/channel-setup
- agdi/plugin-sdk/channel-status
- agdi/plugin-sdk/channel-targets
- agdi/plugin-sdk/cli-runtime
- agdi/plugin-sdk/command-auth
- agdi/plugin-sdk/config-runtime
- agdi/plugin-sdk/conversation-runtime
- agdi/plugin-sdk/core
- agdi/plugin-sdk/device-bootstrap
- agdi/plugin-sdk/diagnostics-otel
- agdi/plugin-sdk/diffs
- agdi/plugin-sdk/directory-runtime
- agdi/plugin-sdk/discord
- agdi/plugin-sdk/discord-core
- agdi/plugin-sdk/extension-shared
- agdi/plugin-sdk/feishu
- agdi/plugin-sdk/gateway-runtime
- agdi/plugin-sdk/github-copilot-token
- agdi/plugin-sdk/googlechat
- agdi/plugin-sdk/group-access
- agdi/plugin-sdk/hook-runtime
- agdi/plugin-sdk/image-generation
- agdi/plugin-sdk/image-generation-core
- agdi/plugin-sdk/imessage
- agdi/plugin-sdk/imessage-core
- agdi/plugin-sdk/infra-runtime
- agdi/plugin-sdk/interactive-runtime
- agdi/plugin-sdk/irc
- agdi/plugin-sdk/json-store
- agdi/plugin-sdk/keyed-async-queue
- agdi/plugin-sdk/lazy-runtime
- agdi/plugin-sdk/line
- agdi/plugin-sdk/line-core
- agdi/plugin-sdk/line-runtime
- agdi/plugin-sdk/llm-task
- agdi/plugin-sdk/matrix
- agdi/plugin-sdk/matrix-runtime-heavy
- agdi/plugin-sdk/matrix-runtime-shared
- agdi/plugin-sdk/mattermost
- agdi/plugin-sdk/media-runtime
- agdi/plugin-sdk/media-understanding
- agdi/plugin-sdk/media-understanding-runtime
- agdi/plugin-sdk/memory-core
- agdi/plugin-sdk/memory-lancedb
- agdi/plugin-sdk/msteams
- agdi/plugin-sdk/nextcloud-talk
- agdi/plugin-sdk/nostr
- agdi/plugin-sdk/ollama-setup
- agdi/plugin-sdk/outbound-runtime
- agdi/plugin-sdk/param-readers
- agdi/plugin-sdk/plugin-entry
- agdi/plugin-sdk/plugin-runtime
- agdi/plugin-sdk/process-runtime
- agdi/plugin-sdk/provider-auth
- agdi/plugin-sdk/provider-auth-api-key
- agdi/plugin-sdk/provider-auth-login
- agdi/plugin-sdk/provider-catalog
- agdi/plugin-sdk/provider-entry
- agdi/plugin-sdk/provider-env-vars
- agdi/plugin-sdk/provider-google
- agdi/plugin-sdk/provider-models
- agdi/plugin-sdk/provider-onboard
- agdi/plugin-sdk/provider-setup
- agdi/plugin-sdk/provider-stream
- agdi/plugin-sdk/provider-usage
- agdi/plugin-sdk/provider-web-search
- agdi/plugin-sdk/provider-zai-endpoint
- agdi/plugin-sdk/reply-history
- agdi/plugin-sdk/reply-payload
- agdi/plugin-sdk/reply-runtime
- agdi/plugin-sdk/request-url
- agdi/plugin-sdk/routing
- agdi/plugin-sdk/runtime
- agdi/plugin-sdk/runtime-env
- agdi/plugin-sdk/runtime-store
- agdi/plugin-sdk/sandbox
- agdi/plugin-sdk/secret-input
- agdi/plugin-sdk/security-runtime
- agdi/plugin-sdk/self-hosted-provider-setup
- agdi/plugin-sdk/setup
- agdi/plugin-sdk/setup-adapter-runtime
- agdi/plugin-sdk/setup-runtime
- agdi/plugin-sdk/setup-tools
- agdi/plugin-sdk/signal
- agdi/plugin-sdk/slack
- agdi/plugin-sdk/slack-core
- agdi/plugin-sdk/slack-targets
- agdi/plugin-sdk/speech
- agdi/plugin-sdk/speech-core
- agdi/plugin-sdk/speech-runtime
- agdi/plugin-sdk/ssrf-runtime
- agdi/plugin-sdk/state-paths
- agdi/plugin-sdk/status-helpers
- agdi/plugin-sdk/telegram
- agdi/plugin-sdk/telegram-core
- agdi/plugin-sdk/temp-path
- agdi/plugin-sdk/testing
- agdi/plugin-sdk/text-runtime
- agdi/plugin-sdk/thread-bindings-runtime
- agdi/plugin-sdk/thread-ownership
- agdi/plugin-sdk/tlon
- agdi/plugin-sdk/tool-send
- agdi/plugin-sdk/twitch
- agdi/plugin-sdk/voice-call
- agdi/plugin-sdk/web-media
- agdi/plugin-sdk/webhook-ingress
- agdi/plugin-sdk/webhook-path
- agdi/plugin-sdk/whatsapp-core
- agdi/plugin-sdk/whatsapp-shared
- agdi/plugin-sdk/windows-spawn
- agdi/plugin-sdk/zalo
- agdi/plugin-sdk/zalouser
Readme
β‘ Agdi β‘
The AI that actually does things.
An advanced, open-source orchestration system for AI agents. Run it anywhere, connect to any model, deploy to any messaging channel, and securely execute real-world tasks.
π¦ One-Line Install
Get started instantly with the global npm package:
npm install -g agdiOnce installed, simply type agdi in your terminal to launch the setup wizard and access the dashboard!
π Comprehensive Capabilities
Agdi is not just a chatbotβit is a full-fledged agentic orchestration platform. Here is everything it can do out of the box:
π§ Model Agnostic (Bring Your Own AI)
Seamlessly switch between the best AI models in the world without changing your workflow.
- Anthropic Claude (Opus, Sonnet, Haiku)
- OpenAI (GPT-4o, GPT-4 Turbo)
- Google Gemini (Pro, Flash)
- Local Models (Llama 3, Mistral, via Ollama & LM Studio)
- Vision & Audio Processing (Send images, documents, and voice notes directly to the AI)
π¬ Universal Messaging Channels
Interact with your AI assistant where you already spend your time. Agdi natively connects to:
- Discord (Threads, direct messages, attachments)
- Slack (Interactive buttons, thread tracking)
- Microsoft Teams (Rich cards, streaming replies, seamless enterprise integration)
- Telegram & WhatsApp
- Apple iMessage & SMS (via macOS integration)
- Web Dashboard (Built-in rich chat interface)
π Powerful Plugin & Skill Ecosystem
Give your AI the tools it needs to take action in the real world.
- File System & Terminal: Securely read/write files and execute shell commands.
- Web Browsing & Search: Search the internet, summarize articles, and extract data from websites.
- Smart Home Controls: Control Philips Hue, Sonos, Eight Sleep, and other IoT devices.
- Productivity Apps: Read and write to Apple Notes, Notion, Google Calendar, and Trello.
- GitHub & DevOps: Automate PR reviews, issue management, and GitHub Actions.
- Plus dozens of community plugins easily installable via
agdi skills list.
π Unmatched Privacy & Security
- Local First: All your API keys, configuration files, and chat logs are stored strictly on your local machine (or your VPS). Nothing routes through third-party telemetry servers.
- Execution Guardrails: Fine-grained permissions ensure the AI cannot run destructive terminal commands or access sensitive files without explicit approval.
- Secure Remote Access: Built-in Tailscale support allows you to securely access your Agdi instance remotely without exposing ports to the public internet.
π₯οΈ Built-In Control Dashboard
Agdi ships with a stunning, local web dashboard designed for true control:
- Manage running agents and monitor CPU/Memory usage.
- Install, configure, and toggle plugins with a single click.
- Review and approve pending tool execution requests.
- Read analytics, token usage, and execution traces.
π Getting Started (From Source)
If you prefer to run Agdi from source or contribute to the project:
Prerequisites
Installation Steps
Clone the repository:
git clone https://github.com/anassagd432/Agdi.git cd Agdi
Install dependencies:
pnpm install
Build the core engine:
pnpm buildStart the application:
pnpm dev
π Documentation & Help
To see all available CLI commands, simply run agdi --help.
For complete guides on configuring specialized channels (like provisioning the Slack bot or setting up Microsoft Teams), configuring Docker, or developing your own custom plugins using the OpenClaw plugin SDK architecture, check the docs/ folder in this repository.