README file from
GithubFree AI and Agents
Free AI chat and vault-editing agents in your Obsidian sidebar. No account, no signup, and no API key needed to start. You get free monthly tokens You can also bring your own key if you want to use other providers. You can also get more AI tokens from usefree.space.
Features of this Obsidian APP
- TopTier Free AI Models — Get AI models for FREE like: Deepseek, Qwen, Mecury, etc All for free.
- Agents that edit your vault — create, rewrite, move and tag notes through tools, with an approval step before anything is changed.
- Chat and agent modes — ask questions, or let the agent act with tools such as read, search, write, move, tags, properties and canvas.
- Web tools —
web_readandweb_searchlet the model read a page or search the web, using the free web allowance or your own Jina key. - Voice typing — optional dictation. Defaults to the Riemann STT service (private, no keys: a per-device key is issued automatically on first use). Cloud providers (Groq, OpenAI) remain available as alternatives.
- Quick tools — translate, summarize, calculate, explain, or ask about your current note in one click from the sidebar header.
- Chat display settings — adjust the chat font size to your liking.
- Localized UI — follows Obsidian's interface language (English, 简体中文, 繁體中文, 日本語, 한국어, Español, Français, Deutsch, Português, Русский, Italiano, العربية, हिन्दी, ไทย, Tiếng Việt) for all core interface text and settings.
- Local history and snapshots — a change history with restore, and chats you can export.
Install?
To install either
- GO to Obsidian → Go to Settings → Community plugins → Browse**, search for Free AI and Agents, then Install and Enable.
OR,
- Download
main.js,manifest.jsonandstyles.cssfrom the latest release. - Put them in
<your vault>/.obsidian/plugins/free-ai-agents/. - Reload Obsidian, then enable Free AI and Agents under Settings → Community plugins.
How the free allowance works
- The free pool gives each device a monthly token allowance. No account or email is needed.
- The web tools give each device a monthly web allowance, and are capped per network as well.
- When an allowance runs out, the plugin tells you the reset time and links to usefree.space for free keys, promos and deals from many other AI services.
- Adding your own key (for any provider, including Jina) routes requests to that provider directly and skips the free allowance for that feature.
Permissions and safety
- The agent only touches your vault, and only after you approve each change (approval mode is configurable).
- A power-user
eval_jstool can run JavaScript inside Obsidian. It is off by default and requires you to enable it in the settings. - Tool results from your notes and from the web are treated as untrusted data.
License
MIT. See LICENSE.
- Website: usefree.space
- Issues: GitHub issues