Is khoj still maintained?

Slowing down. Last change 3 months ago. Latest release 2.0.0-beta.28, 8 months ago.

Widely used. 38k stars, 5 years old, by an organization. As with any download, get it from the official repo.

Reading the repo

Opening the box…

How to install on macOS

khoj-ai/khoj

Your AI second brain. Self-hostable. Get answers from the web or your docs. Build custom agents, schedule automations, do deep research. Turn any online or local LLM into your personal, autonomous AI (gpt, claude, gemini, llama, qwen, mistral). Get started - free.

Python#agent#ai#assistant#chat

Difficulty: Moderate
Time: about 15 min
Stars: ★ 38,036
Activity: Updated 3 months ago
License: AGPL-3.0
Open issues: 170
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Before you start

Is it free?: YesOpen source (AGPL-3.0).
Still maintained?: Slowing downLast change 3 months ago. Latest release 2.0.0-beta.28, 8 months ago.
Can I trust it?: Widely used38k stars, 5 years old, by an organization. As with any download, get it from the official repo.

Start here

Website ↗khoj.devThe project's own site.Docs ↗docs.khoj.devLinked from the README.In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Will it work on my device?

Yes, it runs on macOS

You'll build it yourself with Python.
It also needs PostgreSQL running (Docker handles this).

Checking for

macOS Windows Linux

5 steps on macOS

Download setup.sh

Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

1
Clone the repository
Needs Git: xcode-select --install
```
git clone https://github.com/khoj-ai/khoj.git
cd khoj
```
2
Install the required runtimes
Python >=3.10, <3.13
```
brew install uv
```
3
Start backing services
Needs: PostgreSQL
```
brew install --cask docker  # Docker Desktop
docker compose -f docker-compose.yml up -d
```
If you see Cannot connect to the Docker daemon: start Docker Desktop (or the Docker service) first.
4
Install dependencies
```
uv sync
```
5
Run the tests
```
uv run pytest
```

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Python >=3.10, <3.13runtime
1×uv package manager
1×PostgreSQL service

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/khoj-ai/khoj/badge.svg)](https://gitmanual.com/khoj-ai/khoj)

Good to know

Dockerfile available (base image: ubuntu:jammy).
Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Nested projects: documentation/package.json, src/interface/desktop/package.json, src/interface/obsidian/package.json, src/interface/web/package.json and 1 more

Files we read (11)

.devcontainer/devcontainer.json

.github/workflows/build_khoj_el.yml

.github/workflows/desktop.yml

.github/workflows/dockerize.yml

.github/workflows/dockerize_telemetry_server.yml

.github/workflows/test.yml

.github/workflows/test_khoj_el.yml

Dockerfile

README.md

docker-compose.yml

pyproject.toml

Branch master · 702 files in the repo

Opening the box…

Before you start

Start here

Yes, it runs on macOS

5 steps on macOS

Clone the repository

Install the required runtimes

Start backing services

Install dependencies

Run the tests

Did you get it running?

Still stuck? Ask an AI