What is Wispy?

Wispy is an autonomous AI agent that lives in your terminal, messaging apps, and APIs. Dual-engine architecture powered by Google Gemini 2.5 Pro and Anthropic Claude, with cross-model delegation to GPT-4o, Llama, and 200+ models via OpenRouter. Features a structured Memory Bank with typed categories, lifecycle management, and AI-powered reflection.

npm install -g wispy-ai
wispy onboard
wispy chat

Features

Core

• 125+ Built-in Tools across file system, web, browser automation, code execution, memory, media, blockchain, and identity
• Dual Engine -- switch between Gemini and Claude with a single env var (ENGINE=gemini|claude)
• Memory Bank with 4 typed categories (episodic, semantic, procedural, preference), time-based decay, reinforcement, and AI-powered reflection
• Marathon Mode for multi-step, long-running autonomous tasks with checkpointing and auto-recovery
• Thinking Levels (low/medium/high/ultra) with up to 24K thinking tokens (Gemini) or 32K budget tokens (Claude)
• Named Sessions with isolated context, daily auto-reset, and instant switching
• Process Manager to spawn, monitor, and manage background processes
• Skills.sh Registry with 67,000+ community skills you can install with a single command

Multi-Model / Dual Engine

• Gemini 2.5 Pro -- primary reasoning engine with native function calling and extended thinking
• Claude (Opus/Sonnet/Haiku) -- switchable alternative engine via @anthropic-ai/sdk with tool_use and extended thinking
• Engine abstraction layer -- seamless switching, embeddings always via Gemini
• Cross-model delegation to GPT-4o, Groq, Kimi, Llama via Ollama, and 200+ models via OpenRouter
• Model comparison to send the same prompt to multiple models and compare responses
• Setup wizard configures all providers in one flow

Channels (10)

| Channel | Status | |---------|--------| | CLI (REPL) | Built-in | | Telegram | Full adapter with Marathon support, file access, voice | | WhatsApp | Baileys adapter with Marathon support | | Discord | Full adapter with threads, file uploads | | Slack | Socket Mode adapter with mentions, threads | | Matrix | Client-Server API v3 with long-poll sync | | Signal | signal-cli REST API adapter | | REST API | Express with API key auth | | WebSocket | Real-time streaming | | Agent-to-Agent (A2A) | Google A2A protocol |

Integrations (42+)

| Category | Integrations | |----------|-------------| | AI Models | OpenAI, Anthropic, Ollama, OpenRouter, Groq, Kimi | | Google | Calendar, Docs, Drive, Gmail, Maps, Meet, Search, Sheets, YouTube | | Chat | Discord, Slack, Matrix, Signal, MS Teams | | Productivity | Notion, GitHub, Linear, Obsidian, Trello, Asana, Calendly | | Social | Twitter/X, LinkedIn, Instagram, Reddit | | Smart Home | Home Assistant, Hue, Sonos | | Music | Spotify | | Commerce | Stripe | | Security | 1Password | | Media | Image Generation (DALL-E/Stability/Replicate), Camera/Screenshot | | Tools | Weather, Webhooks, Canvas (SVG/Mermaid) | | Browser | 39 automation tools + 55 built-in skills via Playwright |

Agentic Commerce (x402)

• x402 protocol for autonomous USDC payments on SKALE (gasless)
• AP2 mandate chains (intent, cart, payment, receipt)
• BITE v2 encryption for private transactions (BLS threshold)
• DeFi swap engine with Algebra DEX integration and risk controls
• Cross-model payment bridge so any AI model can trigger payments
• Budget controls with daily limits, per-transaction caps, auto-approve thresholds

Quick Start

# Install
npm install -g wispy-ai

# Interactive setup (Gemini key + optional providers + Telegram + wallet)
wispy onboard

# Chat in the terminal
wispy chat

# Start a Marathon (autonomous multi-step task)
wispy marathon "Build a full-stack SaaS dashboard with auth and payments"

# Run the gateway (all channels simultaneously)
wispy gateway

# Run as a background daemon
wispy gateway --daemon

CLI Commands

wispy chat                    # Interactive REPL
wispy agent "prompt"          # Single-shot prompt
wispy marathon "goal"         # Autonomous multi-step task
wispy gateway                 # Start all channels
wispy onboard                 # Setup wizard
wispy doctor                  # Health check
wispy skills list             # List browser skills
wispy integrations list       # List all integrations
wispy wallet balance          # Check wallet balance
wispy wallet details          # Wallet address + chain info

Configuration

Wispy uses ~/.wispy/config.yaml for configuration and .env for secrets:

# config.yaml
engine: gemini  # or "claude"

gemini:
  models:
    pro: gemini-2.5-pro-preview-05-06
    flash: gemini-2.5-flash-preview-05-20

claude:
  models:
    reasoning: claude-sonnet-4-20250514
    fast: claude-haiku-4-5-20251001

channels:
  telegram: { enabled: true }
  discord: { enabled: false }
  slack: { enabled: false }

providers:
  anthropic: { apiKey: "..." }
  openai: { apiKey: "..." }

security:
  autonomousMode: true
  fullFilesystemAccess: true

wallet:
  enabled: true
  chain: skale-bite-sandbox

theme: day

# .env
ENGINE=gemini              # Switch engine: gemini or claude
GEMINI_API_KEY=AIza...
ANTHROPIC_API_KEY=sk-ant-...
CLAUDE_MODEL=claude-sonnet-4-20250514  # Optional override
TELEGRAM_BOT_TOKEN=123456:ABC...
AGENT_PRIVATE_KEY=0x...
OPENAI_API_KEY=sk-...

Architecture

              ┌──────────────────┐     ┌──────────────────┐
              │  Gemini 2.5 Pro  │ ◄─► │  Claude (Anthropic│
              │  (default)       │     │  (switchable)     │
              └────────┬─────────┘     └────────┬─────────┘
                       └──────────┬─────────────┘
                       ┌──────────▼──────────┐
                       │  Engine Abstraction  │
                       │  + Memory Bank       │
                       │  + Cross-Model Bridge│
                       └──────────┬──────────┘
                                  │
              ┌───────────────────┼───────────────────┐
              │                   │                     │
     ┌────────▼──────┐  ┌───────▼───────┐  ┌─────────▼────────┐
     │  125+ Tools    │  │  42+ Integs   │  │  x402 Commerce   │
     │  Sessions      │  │  Skills.sh    │  │  Payment Bridge  │
     │  Processes     │  │  Browser (39) │  │  Budget Policy   │
     └────────┬──────┘  └───────┬───────┘  └─────────┬────────┘
              │                  │                      │
     ┌────────▼──────────────────▼──────────────────────▼──────┐
     │                    Channel Dock                          │
     │  CLI | Telegram | WhatsApp | Discord | Slack | Matrix   │
     │  Signal | REST | WebSocket | A2A                        │
     └─────────────────────────────────────────────────────────┘

Documentation

Full documentation at docs.wispy.cc

Team

Built by Hausor Labs

• Brian Mwai - Engineering
• Joy C. Langat - Product

License

MIT