Skip to content
Qark Qark
Download for Mac

Five Things to Try Right Now

Five workflows to try once you have a provider connected and a conversation running.

Sparks from any application

Section titled “Sparks from any application”

Get an AI response without leaving your current app.

  1. Highlight text in any application.
  2. Press the Sparks hotkey — Ctrl+Alt+Space (Windows/Linux) or Cmd+Option+Space (macOS).
  3. The overlay appears with the highlighted text captured as context.
  4. Type a prompt (e.g. “Summarize in 3 bullets”) and press Enter.
  5. Use the output action to copy, paste at cursor, or open in a full conversation.
  6. Press Esc to dismiss.

The conversation is saved in the Sparks group in the sidebar.

Attach a PDF and ask questions

Section titled “Attach a PDF and ask questions”
  1. Create a new conversation (Ctrl+N / Cmd+N).
  2. Drag a PDF into the composer or the Artifacts tab in the info panel.
  3. Wait for the indexing indicator to finish — QARK chunks the document, generates embeddings, and builds a vector index.
  4. Type @ → select document-search → ask a question about the document.
  5. Press Enter.

The response includes inline citations referencing specific pages and passages. Supported file types: PDF, DOCX, XLSX, PPTX, TXT, Markdown, HTML, EPUB, and source code files.

Generate an image

Section titled “Generate an image”
  1. In any conversation, type a descriptive prompt.
  2. Type @ → select image-generation.
  3. Press Enter.

The image appears inline. Click to view full resolution, right-click to save. The metadata badge shows the generation cost and model used.

Search the web

Section titled “Search the web”

Web search is enabled by default. QARK ships with a free local browser search that uses your installed Chromium-based browser (Chrome, Brave, Edge) in headless mode — no API key needed.

For better results, you can add external search providers in Settings → Tools & MCP: Brave Search, Exa, Tavily, Perplexity, Jina, and others. Some providers also support built-in search natively (Anthropic, OpenAI, Gemini, Perplexity Sonar). Configure priority order by dragging providers in settings — QARK tries them in order and uses the first successful result.

  1. Ask a question that needs current information.
  2. The model uses web search automatically when relevant.

All search queries run from your machine directly to the search provider. No data passes through any intermediate server.

Create a custom agent

Section titled “Create a custom agent”
  1. Open the Agents view in the sidebar (Bot icon).
  2. Click Create Agent.
  3. Configure:
    • Name — e.g. “Code Reviewer”
    • System prompt — e.g. “Review the provided code for bugs, security issues, and performance problems. Cite line numbers and suggest fixes.”
    • Model — pick from any connected provider
    • Tools — select which tools this agent can use
  4. Save.
  5. In a conversation, open the Info panel → Config tab and select your agent.

The agent executes with the system prompt, model, and tools you configured. It appears in the agent picker for reuse across any conversation.