KendaliAI

KendaliAI is a self-hosted AI automation platform that unified AI access, enables AI agents, provides workflow automation, controls messaging bots, and is highly extensible via plugins.

Architecture: Monolithic (single repository, unified config).

Project Plan & Checklist

• Phase 1: Core Runtime

  • Core primitives (src/core)
  • Event Bus (src/eventbus)
  • Tool System (src/tools)
  • Intent Router (src/router)
  • Database Layer (src/database)

• Phase 2: AI Gateway & Agents

  • AI Gateway (model routing, provider adapters, caching) (src/gateway)
  • Agent Runtime (planner, executor, memory) (src/agents)

• Phase 3: Workflow Automation

  • Workflow engine (node engine, triggers, scheduler) (src/workflow)

• Phase 4: Dashboard UI

  • System monitoring (src/dashboard/pages/Overview)
  • Workflow editor (src/dashboard/pages/Workflows)

• Phase 5: Plugin SDK

  • Tool extensions, workflow nodes, UI widgets SDK (src/sdk)

• Phase 6: Messaging Integration

  • Messaging adapters (Telegram, Discord, WhatsApp) (src/adapters)

Quickstart

Gateway CLI (Telegram Bots)

The fastest way to get started is with the Gateway CLI, which lets you create and manage AI-powered Telegram bots.

# Start the interactive TUI to create a gateway
bun start

# Or use direct commands:
bun run gateway list              # List all gateways
bun run gateway start <name>      # Start a gateway
bun run gateway stop <name>       # Stop a gateway
bun run gateway logs <name>       # Follow gateway logs

The TUI wizard will guide you through:

1. Selecting an AI provider (ZAI/DeepSeek)
2. Entering your API key
3. Choosing a model
4. Connecting a Telegram bot token
5. Configuring optional skills and hooks

Gateway configurations are stored in gateways/ directory (not tracked in git).

Frontend Dashboard

bun install
bun run dev

The frontend application runs on top of Vite and React. The backend API is entirely unified under src/server (or run concurrently) to avoid monorepo setups.

Backend Server

bun run src/server/index.ts

Available Scripts

Script	Description
bun start	Start the interactive TUI
bun run gateway	Gateway management commands
bun run dev	Start frontend + backend concurrently
bun test	Run unit tests

Security Notes

• Gateway configurations contain sensitive credentials (API keys, bot tokens)
• The gateways/ directory is excluded from git via .gitignore
• Shell commands executed by AI are restricted to a safe allowlist
• File system access is limited to allowed directories

Testing

Unit tests run natively via bun test. Test files are stored under the tests/ directory.

bun test