sAId - Smart AI Assistant

A modular AI agent with Telegram integration, Web UI, job scheduling, and extensible skills system.

Features

• Telegram Bot - Chat with the AI assistant via Telegram
• Multiple LLM Providers - OpenCode (MiniMax, GPT, Claude, etc.) or MiniMax
• Web UI - Manage and configure the agent via browser at http://localhost:3000
• Job Scheduler - Schedule recurring tasks
• Skills System - Extensible skills (file edit, web surf, API calls, tool calls)

Installation

# Clone and install dependencies
npm install

# Build all packages
npm run build

Configuration

Quick Setup

Run the interactive setup wizard:

npm run setup

This will prompt you for:

• Telegram bot token (get from @BotFather on Telegram)
• LLM provider selection (opencode or minimax)
• API key for the selected provider

Manual Configuration

Edit the .env file:

# Telegram Bot
TELEGRAM_BOT_TOKEN=your_bot_token_here

# Provider (opencode or minimax)
SAID_PROVIDER=opencode

# OpenCode Configuration
OPENCODE_BASE_URL=https://opencode.ai/zen/v1
OPENCODE_API_KEY=your_opencode_api_key
OPENCODE_MODEL=minimax-m2.5-free

# Or MiniMax Configuration
# MINIMAX_API_KEY=your_minimax_api_key
# MINIMAX_MODEL=MiniMax-Text-01

Available Models

OpenCode (via https://opencode.ai/zen/v1):

• MiniMax: minimax-m2.5-free, minimax-m2.5, minimax-m2.1-free, minimax-m2.1
• GPT: gpt-5.3-codex, gpt-5.2, gpt-5.1, etc.
• Claude: opus-4-6, sonnet-4-6, haiku-4-5, etc.
• Gemini: gemini-3.1-pro, gemini-3-flash
• And more...

Usage

Start the Agent

npm run start

The bot will:

• Connect to Telegram
• Start the Web UI at http://localhost:3000
• Initialize the scheduler

Telegram Commands

• Send a message to your bot to chat with the AI
• The agent maintains conversation context

Web UI

Open http://localhost:3000 in your browser to:

• View agent status
• Manage configuration
• View conversation history
• Manage skills
• Schedule jobs

Skills

The agent includes built-in skills:

• file-edit - Read, write, and edit files
• web-surf - Fetch URLs and extract content
• api-call - Make HTTP requests to external APIs
• tool-call - Execute custom tools

Skills can be invoked using: [[skill-name:action]] syntax in messages.

Development

# Build all packages
npm run build

# Start in development mode
npm run start

# Run setup wizard
npm run setup

Architecture

packages/
├── core/              # Base service, config, app framework
├── adapter-telegram/  # Telegram bot integration
├── provider-opencode/ # OpenCode LLM provider
├── provider-minimax/  # MiniMax LLM provider
├── agent/             # AI agent with skills support
├── skills/            # Skill framework and implementations
├── scheduler/         # Job scheduling service
├── web-ui/            # Web dashboard
└── main/              # Application entry point