Real Chat

by Chris Gage
5
4
3
2
1
Score: 52/100

Description

BYOK chat sidebar for Obsidian: any OpenAI-compatible API, vault read/edit, ranked search, web access, images, memory.

Reviews

No reviews yet.

Stats

4
stars
1,300
downloads
0
forks
141
days
1
days
1
days
5
total PRs
0
open PRs
0
closed PRs
5
merged PRs
2
total issues
0
open issues
2
closed issues
33
commits

Latest Version

2 days ago

Changelog

Fixed

  • Store API keys in Obsidian SecretStorage instead of plugin data.json; migrate existing keys automatically.
  • Require Obsidian 1.11.4 or newer for SecretStorage support. SecretStorage values are local to each device and must be configured separately.

README file from

Github

Real Chat

A chat sidebar for Obsidian that works with any OpenAI-compatible API — DeepSeek, OpenRouter (300+ models including Claude, GPT and Gemini), or your own endpoint. Bring your own key. It can read and edit your notes, search your vault, browse the web, and process images, all from a conversation in the sidebar.

📖 Full documentation is on the wiki » — setup, usage, vision & images, tools & vault actions, and memory & triggers.

Features

  • Five chat sessions with their own history, draft, model and settings. Histories persist across restarts; archive and reload past chats; export a chat to a note.
  • Any OpenAI-compatible provider — DeepSeek direct (cache-aware pricing) or OpenRouter (live model list, per-model pricing, favourites). Per-session model selection.
  • Acts in your vault — create, edit, append, rename, delete and find/replace notes; frontmatter and tag editing; backlinks, orphans and broken-link finders; word count and vault stats. File changes prompt for confirmation (or enable YOLO mode to skip).
  • Ranked vault search — a 🔍 search box (toolbar button or hotkey-able command) for instant, token-free results weighted by title/heading/tag/body; or ask in chat for synonym-expanded, reasoned search.
  • Web access (optional) — web search, fetch a page, and download a file into your vault. DuckDuckGo needs no key; add a Brave or Tavily key for better search.
  • Images — paste, drag or attach images; processed locally (compress, resize, convert, crop, rotate). Vision input routes to a natively multimodal model, or a vision provider you configure. Attached images are sticky (the chip persists across follow-up turns; tap × to remove), and the vision model runs the full tool loop — so it can see an image and act on it in one turn: save the actual picture into your vault, OCR it into a note, create/edit, search.
  • Persistent memory & triggers — a memory note read on every message, with user-defined command "triggers".
  • Reasoning models — chain-of-thought shows in a collapsible block (display only).
  • Cost tracking, streaming, slash commands, a saved prompt library, and inline "edit selection" from any note.

Support

Real Chat is free and MIT-licensed, built in the evenings around a full-time job. If it's earned a place in your vault, any support helps keep development going.

Sponsor on GitHub Ko-fi

Install

From the Community Plugins store

Once accepted: Settings → Community plugins → Browse → search "Real Chat" → Install → Enable.

Manual install

  1. Download main.js, manifest.json and styles.css from the latest release.
  2. Put them in <your vault>/.obsidian/plugins/real-chat/.
  3. Reload Obsidian, then enable Real Chat under Settings → Community plugins.

Setup

  1. Open Settings → Real Chat.
  2. Choose a provider: DeepSeek direct (cheapest), Mistral, or OpenRouter (one key, many models).
  3. Select or add your API key in Obsidian SecretStorage. On OpenRouter, click Load / refresh models.
  4. Open the sidebar from the ribbon (speech-bubble icon) or the "Open Real Chat" command.
  5. Add/select keys separately on each device; SecretStorage is not synced with vault files.

Privacy & network use

Real Chat only makes network requests you configure or trigger:

  • Your messages, and any note content you add as context, are sent to the API provider you choose (DeepSeek, OpenRouter, or your own endpoint) to generate replies. Choose a provider you trust; review their data policy.
  • Web access (off unless enabled) makes requests to your chosen search provider and to URLs you/the model fetch or download from.
  • OpenRouter model list and pricing are fetched from OpenRouter when you use that provider.

There is no telemetry and no other data collection. Your API keys are stored in Obsidian SecretStorage rather than the plugin's data.json, and are only sent to their configured providers when used. SecretStorage values are local to each device, so add/select them separately on every device. The plugin does not download or execute any remote code.

License

MIT © Chris Gage