GitHub

Vaman AI — Personal AI Assistant with Discord, Gmail, CLI & Voice

Anoop Sharma

— 1 min read

GitHub: anoop22/vaman-ai · Also see: vikram-ai (evolved form)

A lightweight personal AI assistant with Discord, Gmail, CLI, and voice interfaces. Built on OpenClaw's multi-channel gateway architecture and pi-mono's multi-provider agent runtime.

Features

  • Multi-channel: Discord, Gmail, CLI, and Voice
  • WebSocket Gateway: Central hub managing sessions, heartbeats, and cron jobs
  • Multi-provider LLM: OpenRouter, Anthropic, OpenAI, Google via pi-agent-core
  • Voice mode: Parakeet STT + Kokoro TTS on Apple Silicon (mlx-audio)
  • Skills system: Extensible markdown-based skills with YAML frontmatter
  • Self-management: Hot-reload config, self-restart, LaunchAgent daemon

Quick Start

git clone https://github.com/anoop22/vaman-ai.git
cd vaman-ai && npm install
npm run build
npx vaman onboard
npx vaman chat

Architecture

packages/
  shared/    - Config, types, logger
  agent/     - Pi-agent-core wrapper
  gateway/   - WebSocket server, sessions
  discord/   - Discord adapter
  gmail/     - Gmail adapter
  voice/     - Parakeet STT + Kokoro TTS
  skills/    - Skill loader
  cli/       - CLI entry point

Node.js >= 22 · macOS for voice · MIT License

Read more