Task: Summarize emails and send highlights to Slack

saiki --config-file ./configuration/examples/email_slack.yml

saiki --config-file ./configuration/examples/notion.yml #Requires setup

The saiki command supports several options to customize its behavior. Run saiki --help for the full list.

> saiki -h
Usage: saiki [options] [command] [prompt...]

Saiki CLI allows you to talk to Saiki, build custom AI Agents, build complex AI applications like Cursor, and more.

Run saiki interactive CLI with `saiki` or run a one-shot prompt with `saiki <prompt>`
Run saiki web UI with `saiki --mode web`
Run saiki as a server (REST APIs + WebSockets) with `saiki --mode server`
Run saiki as a discord bot with `saiki --mode discord`
Run saiki as a telegram bot with `saiki --mode telegram`
Run saiki as an MCP server with `saiki --mode mcp`

Check subcommands for more features. Check https://github.com/truffle-ai/saiki for documentation on how to customize saiki and other examples

Arguments:
  prompt                    Natural-language prompt to run once. If not passed, saiki will start as an interactive CLI

Options:
  -v, --version             output the current version
  -c, --config-file <path>  Path to config file (default: "configuration/saiki.yml")
  -s, --strict              Require all server connections to succeed
  --no-verbose              Disable verbose output
  -m, --model <model>       Specify the LLM model to use.
  -r, --router <router>     Specify the LLM router to use (vercel or in-built)
  --mode <mode>             The application in which saiki should talk to you - cli | web | server | discord | telegram | mcp (default: "cli")
  --web-port <port>         optional port for the web UI (default: "3000")
  -h, --help                display help for command

Commands:
  create-app                Scaffold a new Saiki Typescript app
  init-app                  Initialize an existing Typescript app with Saiki

Common Examples:

• Specify a custom configuration file:

  cp configuration/saiki.yml configuration/custom_config.yml
  saiki --config-file configuration/custom_config.yml

• Use a specific AI model (if configured):

  saiki -m gemini-2.5-pro-exp-03-25

Saiki defines agents using a YAML config file (configuration/saiki.yml by default). To configure an agent, use tool servers (MCP servers) and LLM providers.

mcpServers:
  filesystem:
    type: stdio
    command: npx
    args:
      - -y
      - "@modelcontextprotocol/server-filesystem"
      - .
  puppeteer:
    type: stdio
    command: npx
    args:
      - -y
      - "@truffle-ai/puppeteer-server"

llm:
  provider: openai
  model: gpt-4.1-mini
  apiKey: $OPENAI_API_KEY

Saiki supports multiple LLM providers out of the box, plus any OpenAI SDK-compatible provider.

• OpenAI: gpt-4.1-mini, gpt-4o, o3, o1 and more
• Anthropic: claude-3-7-sonnet-20250219, claude-3-5-sonnet-20240620 and more
• Google: gemini-2.5-pro-exp-03-25, gemini-2.0-flash and more
• Groq: llama-3.3-70b-versatile, gemma-2-9b-it

You will need to set your provider specific API keys accordingly.

Set your API key and run:

# OpenAI (default)
export OPENAI_API_KEY=your_key
saiki

# Switch providers via CLI
saiki -m claude-3-5-sonnet-20240620
saiki -m gemini-2.0-flash

For comprehensive setup instructions, all supported models, advanced configuration, and troubleshooting, see our LLM Providers Guide.

Saiki can be easily integrated into your applications as a powerful AI agent library. Here's a simple example to get you started:

import 'dotenv/config';
import { loadConfigFile, createSaikiAgent } from '@truffle-ai/saiki';

// Load your agent configuration
const config = await loadConfigFile('./saiki.yml');
const agent = await createSaikiAgent(config);

// Use the agent for single tasks
const result = await agent.run("Analyze the files in this directory and create a summary");
console.log(result);

// Or have conversations
const response1 = await agent.run("What files are in the current directory?");
const response2 = await agent.run("Create a README for the main.py file");

// Reset conversation when needed
agent.resetConversation();

For detailed information on the available API endpoints and WebSocket communication protocol, please see the Saiki API and WebSocket Interface documentation.

For comprehensive guides on building different types of applications with Saiki, including:

• Web backends and APIs
• Discord/Telegram bots
• Advanced patterns and best practices
• Multi-agent systems

See our Building with Saiki Developer Guide.

Saiki includes a powerful MCPClientManager that can be used as a standalone utility for managing MCP servers in your own applications. This is perfect for developers who need MCP server management without the full Saiki agent framework.

import { MCPClientManager } from '@truffle-ai/saiki';

// Create manager instance
const manager = new MCPClientManager();

// Connect to MCP servers
await manager.connectServer('filesystem', {
  type: 'stdio',
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-filesystem', '.']
});

await manager.connectServer('web-search', {
  type: 'stdio', 
  command: 'npx',
  args: ['-y', 'tavily-mcp@0.1.2'],
  env: { TAVILY_API_KEY: process.env.TAVILY_API_KEY }
});

// Get all available tools across servers
const tools = await manager.getAllTools();
console.log('Available tools:', Object.keys(tools));

// Execute a tool
const result = await manager.executeTool('readFile', { path: './README.md' });
console.log('File contents:', result);

// List connected servers
const clients = manager.getClients();
console.log('Connected servers:', Array.from(clients.keys()));

// Disconnect when done
await manager.disconnectAll();

The MCPClientManager provides a simple, unified interface for connecting to and managing multiple MCP servers simultaneously. See our MCP Manager Documentation for complete API reference and advanced usage patterns.

Find detailed guides, architecture, and API reference in our comprehensive documentation:

• Quick Start - Get up and running in minutes
• Configuration Guide - Configure agents, LLMs, and tools
• Building with Saiki - Developer guide with examples and patterns
• Multi-Agent Systems - Agent collaboration patterns
• API Reference - REST APIs, WebSocket, and SDKs
• MCP Manager - Standalone MCP server management
• Architecture - System design and concepts

• What is an AI Agent? - Understanding AI agents
• Model Context Protocol - Learn about MCP
• Examples & Demos - See Saiki in action

We welcome contributions! Refer to our Contributing Guide for more details.

Saiki was built by the team at Truffle AI.

Saiki is better with you! Join our Discord whether you want to say hello, share your projects, ask questions, or get help setting things up:

If you're enjoying Saiki, please give us a ⭐ on GitHub!

Elastic License 2.0. See LICENSE for details.

Thanks to all these amazing people for contributing to Saiki! (full list):