agdi
v2026.5.9
Published
Agdi AI agent runtime with extensible messaging, gateway, and tool integrations
Maintainers
Readme
Agdi
Agdi is an open-source agent workspace for running assistants, automations, connected chat apps, and real tool execution on your own machine or private host.
Install
Native installers:
- Windows: download the latest
agdi-windows.exerelease artifact - macOS: download the latest
agdi-macosrelease artifact - Linux: download the latest
agdi-linuxrelease artifact
npm:
npm install -g agdiAfter install:
agdi onboardWorkspace quick start
Start the local runtime:
agdi gatewayOpen the workspace:
agdi dashboardCanonical workspace auth env vars:
AGDI_GATEWAY_TOKENAGDI_GATEWAY_PASSWORDAGDI_PROFILE
Legacy OPENCLAW_* daemon env vars are still accepted as compatibility fallbacks, but Agdi-native names are the recommended public surface.
What Agdi provides
- Local runtime with WebSocket control, HTTP APIs, and a workspace UI
- Connections across built-in and plugin chat apps
- Local and remote node execution
- Tooling for shell, files, web, and automation workflows
- Profile-aware daemon/service installs on macOS, Linux/WSL, and Windows task surfaces
Docs
- Getting started: https://docs.agdi.ai/start/getting-started
- Onboarding: https://docs.agdi.ai/start/wizard
- Runtime runbook: https://docs.agdi.ai/gateway
- Workspace UI: https://docs.agdi.ai/web/dashboard
- Remote access: https://docs.agdi.ai/gateway/remote
- Configuration: https://docs.agdi.ai/gateway/configuration
Run from source
Prerequisites:
- Node.js 22+
- pnpm
Setup:
git clone https://github.com/anassagd432/Agdi.git
cd Agdi
pnpm install
pnpm build
pnpm devDevelopment checks
pnpm check # lint, format, branding, boundary checks
pnpm test # unit, gateway, channel, and extension tests
pnpm build # tsdown bundle + postbuildCI runs automatically via GitHub Actions on push/PR to main; it includes lint, type-check, unit tests across Linux and Windows, build smoke tests, and docs validation.
License
MIT
