# Khoj

Khoj is an open-source AI personal assistant and second brain.

Canonical page: https://ourlocalhost.com/app/8553/khoj

## Description

Khoj is an open-source AI personal assistant and second brain. It indexes your notes, documents, bookmarks, and personal files, then lets you search and chat with that content using local (e.g. Ollama, Llama) or cloud-hosted large language models. Built for homelabbers and knowledge workers who want a private, self-hosted assistant that keeps data on their own hardware, Khoj also offers an extensible tool ecosystem for research and content workflows.

## Platform availability

Available on 1 of 10 platforms: Any server.

## Health score

59/100 (Fair), based on 4 of 4 factors.
- Maintained: 67 (last commit 111 days ago)
- Popular: 92 (38,183 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Official website: https://khoj.dev/
- Documentation: https://docs.khoj.dev
- GitHub: https://github.com/khoj-ai/khoj

## Common questions

### How do I start Khoj with Docker Compose and where is its setup stored?

Create a ~/.khoj folder, place docker-compose.yml in that folder, and run docker-compose up from there. Your setup stays in ~/.khoj, and the logs indicate readiness with the ready-to-engage message.

### What Emacs configuration do I need for Khoj to find my notes?

Set khoj-api-key to your sign-in token, khoj-server-url to the server address, and khoj-index-directories or khoj-index-files to the folders and files you want searched. Without those settings, Khoj will not pick up those notes.

### What must I do to run the LiteLLM proxy for the Mistral model?

Install the proxy with pip install litellm[proxy], set MISTRAL_API_KEY, and start it with litellm --model mistral/mistral-tiny --drop_params. Missing the key prevents the proxy from talking to Mistral.

### Which note file types can Khoj index and search?

Khoj understands PDF, plaintext, Markdown, org-mode files, and Notion pages.

## Alternatives

- AnythingLLM: AnythingLLM is a local, all-in-one AI app for self-hosters that works with any large language model, providing document chat, retrieval-aug…
- Apertus: As a fully open language model, Apertus allows researchers, professionals and enthusiasts to build upon the model and adapt it to their spe…
- Hermes Agent: Hermes Agent is a self-improving AI agent by Nous Research that creates and refines skills from experience, builds a persistent model of yo…
- Jan.ai: Open-source offline AI chat software supporting local LLMs, cloud model connections, custom assistant creation, OpenAI-compatible API, and…
- Lumo by Proton: Privacy-first AI assistant with zero-access encryption, no logging or profiling, open-source code, and user-controlled conversations, subje…
- Manus: Transforms thoughts into actions with personalized travel itineraries, stock analysis, and educational content while autonomously completin…
- OpenClaw: OpenClaw is an open-source, self-hosted AI assistant gateway that connects large language models (LLMs) to Discord, Telegram, and WhatsApp,…
- PocketPal: An app that brings language models directly to your phone.
- Poe: Poe is a web-based AI platform that hosts multiple assistant bots—including Claude and various GPT and image/audio models—to provide conver…
- Secret Llama: Fully private offline chatbot runs locally in browser, with no server or installation needed.

---
Source: Our Local Host (https://ourlocalhost.com/app/8553/khoj), the self-hosted and open-source app directory.
