asky

A command-line AI assistant with web search, document Q&A, conversation history, and XMPP remote chat.

Install with uv

uv tool install asky-cli

Features

Works with OpenRouter, Gemini, OpenAI, Anthropic, or local models via LM Studio and Ollama.

Search the web, fetch URLs, and use tool calling. Supports SearXNG, Tavily, and Serper.

Ask questions about PDFs, EPUBs, or entire folders. Vector-indexed for semantic search.

Run as a background service and chat from any XMPP client on phone or desktop.

Every query is saved. Resume conversations with -c or use named sessions with -ss.

Iterative retrieval across web sources and local documents for comprehensive answers.

Create and switch between specialized AI personas tailored for specific workflows or domains.

Extend capabilities by defining your own executable tools that asky can use to solve tasks.

Long term memory storage allowing the assistant to remember your preferences and past context across sessions.

# Basic query

asky what is the correct temperature for green tea

# Ask about a local document

asky -r path/to/report.pdf "What are the main conclusions?"

# Web research mode

asky -r web "Compare the latest iPhone vs Samsung flagship specs"

# Continue a conversation

asky -c "~1" explain more

# Use a specific model

asky -m gf "Explain quantum entanglement"

Free and open source. MIT License.