sarathy 0.1.5

Sarathy : My Personal _claw style_ Assistant

Sarathy : My Personal Assistant

Who is Sarathy and Why ?

Sarathy is my own AI assistant implementation focused on local models. Frustrated with bloated alternatives and API costs, I built this to run 100% offline with only the features I need.

Sarathy means helper, guide, driver, mentor in both Sanskrit & Tamil.

Supported Models

Local Providers (Primary)

• Ollama - http://localhost:11434
• LMStudio - http://localhost:1234/v1
• vLLM - any OpenAI-compatible local endpoint

Custom Endpoints

• Custom - any OpenAI-compatible API (local or cloud)

Supported Channels

Channel	Description
Telegram	Bot via @BotFather
Discord	Bot via Discord Developer Portal
Email	IMAP/SMTP

Installation

Install from source (latest features, recommended for development)

git clone https://github.com/kspviswa/sarathy.git
cd sarathy
pip install -e .

Install with uv (stable, fast)

uv tool install sarathy

Install from PyPI (stable)

pip install sarathy

Quick Start

[!TIP] Make sure you have Ollama, LMStudio, or vLLM running before starting Sarathy.

1. Initialize

sarathy onboard

2. Configure (~/.sarathy/config.json)

Example for Ollama:

{
  "agents": {
    "defaults": {
      "model": "llama3"
    }
  },
  "providers": {
    "ollama": {}
  }
}

Example for LMStudio:

{
  "agents": {
    "defaults": {
      "model": "llama-3-8b"
    }
  },
  "providers": {
    "lmstudio": {}
  }
}

Example for Custom (e.g., local vLLM or other OpenAI-compatible):

{
  "agents": {
    "defaults": {
      "model": "llama-3-70b-instruct"
    }
  },
  "providers": {
    "custom": {
      "apiBase": "http://localhost:8000/v1"
    }
  }
}

3. Chat

sarathy agent -m "Hello!"

Or start the gateway for multi-channel support:

sarathy gateway

CLI Reference

Command	Description
sarathy onboard	Initialize config & workspace
sarathy agent -m "..."	Chat with the agent
sarathy agent	Interactive chat mode
sarathy gateway	Start the gateway (Telegram/Discord/Email)
sarathy status	Show status

Interactive mode exits: exit, quit, /exit, /quit, :q, or Ctrl+D.