MCPcopy Index your code
hub / github.com/khoj-ai/khoj

github.com/khoj-ai/khoj @2.0.0-beta.28

repository ↗ · DeepWiki ↗ · release 2.0.0-beta.28 ↗ · + Follow
2,628 symbols 9,209 edges 377 files 510 documented · 19% 44 cross-repo links updated 11d ago2.0.0-beta.28 · 2026-03-26★ 35,47695 open issues
README

Khoj Logo

test docker pypi discord

Your AI second brain

📑 Docs   •   🌐 Web   •   🔥 App   •   💬 Discord   •   ✍🏽 Blog

khoj-ai%2Fkhoj | Trendshift


🎁 New

  • Meet 🌶️ Pipali - our open-source AI coworker that runs on your computer.
  • Read about Khoj's excellent performance on modern retrieval and reasoning benchmarks.

Overview

Khoj is a personal AI app to extend your capabilities. It smoothly scales up from an on-device personal AI to a cloud-scale enterprise AI.

  • Chat with any local or online LLM (e.g llama3, qwen, gemma, mistral, gpt, claude, gemini, deepseek).
  • Get answers from the internet and your docs (including image, pdf, markdown, org-mode, word, notion files).
  • Access it from your Browser, Obsidian, Emacs, Desktop, Phone or Whatsapp.
  • Create agents with custom knowledge, persona, chat model and tools to take on any role.
  • Automate away repetitive research. Get personal newsletters and smart notifications delivered to your inbox.
  • Find relevant docs quickly and easily using our advanced semantic search.
  • Generate images, talk out loud, play your messages.
  • Khoj is open-source, self-hostable. Always.
  • Run it privately on your computer or try it on our cloud app.

See it in action

demo_chat

Go to https://app.khoj.dev to see Khoj live.

Full feature list

You can see the full feature list here.

Self-Host

To get started with self-hosting Khoj, read the docs.

Enterprise

Khoj is available as a cloud service, on-premises, or as a hybrid solution. To learn more about Khoj Enterprise, visit our website.

Frequently Asked Questions (FAQ)

Q: Can I use Khoj without self-hosting?

Yes! You can use Khoj right away at https://app.khoj.dev — no setup required.

Q: What kinds of documents can Khoj read?

Khoj supports a wide variety: PDFs, Markdown, Notion, Word docs, org-mode files, and more.

Q: How can I make my own agent?

Check out this blog post for a step-by-step guide to custom agents. For more questions, head over to our Discord!

Contributors

Cheers to our awesome contributors! 🎉

Made with contrib.rocks.

Interested in Contributing?

Khoj is open source. It is sustained by the community and we’d love for you to join it! Whether you’re a coder, designer, writer, or enthusiast, there’s a place for you.

Why Contribute? - Make an Impact: Help build, test and improve a tool used by thousands to boost productivity. - Learn & Grow: Work on cutting-edge AI, LLMs, and semantic search technologies.

You can help us build new features, improve the project documentation, report issues and fix bugs. If you're a developer, please see our Contributing Guidelines and check out good first issues to work on.

Extension points exported contracts — how you extend this code

ProcessedEditResult (Interface)
* Interface representing the result of processing an edit block
src/interface/obsidian/src/interact_with_files.ts
PartialEditBlockResult (Interface)
* Interface representing the result of detecting a partial edit block
src/interface/obsidian/src/interact_with_files.ts
SimilarResult (Interface)
(no doc)
src/interface/obsidian/src/similar_view.ts
EditBlock (Interface)
(no doc)
src/interface/obsidian/src/interact_with_files.ts
ParsedEditBlock (Interface)
(no doc)
src/interface/obsidian/src/interact_with_files.ts

Core symbols most depended-on inside this repo

get
called by 623
tests/evals/eval.py
add
called by 197
tests/evals/eval.py
cn
called by 166
src/interface/web/lib/utils.ts
is_none_or_empty
called by 105
src/khoj/utils/helpers.py
parse
called by 63
src/khoj/search_filter/date_filter.py
save
called by 44
src/khoj/database/models/__init__.py
toast
called by 38
src/interface/web/components/ui/use-toast.ts
update_telemetry_state
called by 37
src/khoj/routers/helpers.py

Shape

Function 1,374
Method 619
Class 392
Interface 127
Route 111
Enum 5

Languages

Python66%
TypeScript34%
Java1%

Modules by API surface

src/khoj/database/adapters/__init__.py191 symbols
src/interface/desktop/assets/markdown-it.min.js123 symbols
src/khoj/routers/helpers.py95 symbols
src/khoj/database/models/__init__.py95 symbols
src/interface/obsidian/src/chat_view.ts75 symbols
src/khoj/utils/helpers.py69 symbols
src/khoj/routers/api_chat.py60 symbols
src/khoj/processor/conversation/utils.py46 symbols
src/interface/desktop/assets/three.min.js43 symbols
src/khoj/routers/api_content.py39 symbols
src/interface/web/app/components/chatMessage/chatMessage.tsx34 symbols
tests/test_client.py32 symbols

Dependencies from manifests, versioned

@docusaurus/core3.9.2 · 1×
@docusaurus/module-type-aliases3.9.2 · 1×
@docusaurus/plugin-sitemap3.9.2 · 1×
@docusaurus/preset-classic3.9.2 · 1×
@docusaurus/types3.9.2 · 1×
@hookform/resolvers3.10.0 · 1×
@mdx-js/react3.0.0 · 1×
@phosphor-icons/react2.1.10 · 1×
@radix-ui/react-alert-dialog1.1.15 · 1×
@radix-ui/react-avatar1.1.10 · 1×
@radix-ui/react-checkbox1.3.3 · 1×

For agents

$ claude mcp add khoj \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact