The obsidian-llm-wiki software turns your personal notes into a powerful team of virtual assistants. It reads your markdown vault and creates a structured knowledge base. This base works with AI tools like Claude Code, Codex, and Gemini.
The software acts as a bridge. It takes the ideas you already wrote in Obsidian and lets AI models access them. These models use your specific information to answer questions. They cite your notes to prove their accuracy. They do not guess or halluciation facts. You gain a headless knowledge base that acts as a personal research expert.
Your computer must meet these basic standards to run this software:
- Windows 10 or Windows 11.
- A stable internet connection for the AI tools.
- At least 4GB of free hard drive space.
- An existing Obsidian vault with your notes.
Visit the official repository page to download the software.
- Click the link above to reach the main page.
- Look for the "Releases" section on the right side of the screen.
- Click the latest version link.
- Download the file ending in
.exefor Windows. - Save the file to your desktop.
Once the download finishes, double-click the file. Windows might show a security prompt. Click "Run" to continue. The installer will guide you through the setup. Choose a folder where you want to keep the application.
The software needs to read your notes to function. Follow these steps to connect your vault:
- Open the obsidian-llm-wiki application.
- Click the "Settings" tab.
- Locate the "Vault Path" input box.
- Click "Browse" and select the folder on your computer that contains your Obsidian notes.
- Save your changes.
The application scan your files for the first time. This creates the internal concept graph. The graph connects your wikilinks and tags. It makes your knowledge searchable for AI agents.
Once the scan finishes, you can use the agents. The software creates a 6-persona team. Each persona has a specific way of processing your notes.
- The Analyst: Searches for patterns in your research.
- The Writer: Helps draft content based on your style.
- The Archivist: Maintains the structure of your links.
- The Coder: Uses your notes to help write software.
- The Strategist: Organizes your concepts into plans.
- The Teacher: Explains your notes in simple terms.
To use an agent, select it from the sidebar. Type your question into the chat box. The agent reads your relevant notes. It displays an answer with links to the exact files it used. You can click these links to open the original markdown file directly in Obsidian.
- Headless Integration: The software runs in the background. It stays out of your way while you work in Obsidian.
- Citation System: Every tool response includes direct references to your vault. You verify every claim against your own text.
- Automatic Graph Creation: The system tracks wikilinks and tags. It builds a map of your knowledge automatically.
- Multi-Model Support: You switch between Claude, Gemini, and local coding tools with a single click.
- Privacy Focused: Your notes stay on your local machine. The AI tools only see the specific snippets required to answer your prompt.
The software does not show my notes.
Check your Vault Path in the settings. Ensure you selected the main folder that holds your .md files. Restart the application after you update the path.
The chat window stays empty. Check your internet connection. AI agents require a connection to fetch the logic files. If you use a firewall, ensure it allows the obsidian-llm-wiki to reach the internet.
The software runs slowly. Large vaults take more time to scan. If you have thousands of notes, give the application a few minutes to index the content. Once finished, performance becomes fast and responsive.
The agents provide short answers. The agents base answers on the information they find in your vault. If an agent struggles, add more detail or context to your notes. The software performs best when your notes contain clear concepts and proper wikilinks.
The quality of the AI output depends on your note quality. Use these tips to get the most from your wiki:
- Use Wikilinks: Connect your notes using
[[Note Name]]. These links help the software understand relationships between your ideas. - Use Tags: Add tags to categorize your notes. Use tags for common topics like
projects,ideas, orresearch. - Be Specific: Write clear headings. Use descriptive titles for your notes.
- Keep it Clean: Avoid using too many different formats. Standard markdown works best.
The obsidian-llm-wiki grows through user feedback. If you find a bug, report it on the repository page. Keep your notes organized. The software handles the technical work of preparing your data for modern AI tools. Enjoy building your personal knowledge base.