https://github.com/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.

https://github.com/khoj-ai/khoj

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    1 of 59 committers (1.7%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.9%) to scientific vocabulary

Keywords

agent ai assistant chat chatgpt emacs image-generation llama3 llamacpp llm obsidian obsidian-md offline-llm productivity rag research self-hosted semantic-search stt whatsapp-ai

Keywords from Contributors

cryptocurrencies transformers langchain anthropic gemini tensors optimism vlms asyncio document-parser
Last synced: 5 months ago · JSON representation

Repository

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.

Basic Info
  • Host: GitHub
  • Owner: khoj-ai
  • License: agpl-3.0
  • Language: Python
  • Default Branch: master
  • Homepage: https://khoj.dev
  • Size: 111 MB
Statistics
  • Stars: 30,815
  • Watchers: 152
  • Forks: 1,781
  • Open Issues: 82
  • Releases: 161
Topics
agent ai assistant chat chatgpt emacs image-generation llama3 llamacpp llm obsidian obsidian-md offline-llm productivity rag research self-hosted semantic-search stt whatsapp-ai
Created over 4 years ago · Last pushed 6 months ago
Metadata Files
Readme License

README.md

Khoj Logo

[![test](https://github.com/khoj-ai/khoj/actions/workflows/test.yml/badge.svg)](https://github.com/khoj-ai/khoj/actions/workflows/test.yml) [![docker](https://github.com/khoj-ai/khoj/actions/workflows/dockerize.yml/badge.svg)](https://github.com/khoj-ai/khoj/pkgs/container/khoj) [![pypi](https://github.com/khoj-ai/khoj/actions/workflows/pypi.yml/badge.svg)](https://pypi.org/project/khoj/) [![discord](https://img.shields.io/discord/1112065956647284756?style=plastic&label=discord)](https://discord.gg/BDgyabRM6e)
Your AI second brain


[📑 Docs](https://docs.khoj.dev)   •   [🌐 Web](https://khoj.dev)   •   [🔥 App](https://app.khoj.dev)   •   [💬 Discord](https://discord.gg/BDgyabRM6e)   •   [✍🏽 Blog](https://blog.khoj.dev) khoj-ai%2Fkhoj | Trendshift

🎁 New

  • Start any message with /research to try out the experimental research mode with Khoj.
  • Anyone can now create custom agents with tunable personality, tools and knowledge bases.
  • 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.

Owner

  • Name: Khoj AI
  • Login: khoj-ai
  • Kind: organization

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 4,278
  • Total Committers: 59
  • Avg Commits per committer: 72.508
  • Development Distribution Score (DDS): 0.35
Past Year
  • Commits: 1,789
  • Committers: 33
  • Avg Commits per committer: 54.212
  • Development Distribution Score (DDS): 0.453
Top Committers
Name Email Commits
Debanjum Singh Solanky d****m@g****m 2,782
sabaimran n****s@g****m 1,399
Raghav Tirumale 6****w 16
Alexander Matyasko a****o@g****m 5
Henri Jamet 4****t 5
Desmond d****d@D****l 4
Ikko Eltociear Ashimine e****r@g****m 4
Sam Ho s****6@g****m 4
Shantanu Sakpal s****0@g****m 3
Yash-1511 y****0@g****m 2
Jiho Lee o****t@k****m 2
Jason Qin 6****n 2
Muftawo h****f@g****m 2
Artem Yurchenko z****8@g****m 2
ayushjha119 a****3@h****n 2
Husain007 9****a 1
Felix Yan f****s@a****g 1
Emmanuel Ferdman e****n@g****m 1
Ellen7ions l****5@g****m 1
Dmitry 9****t 1
Darya 1****s 1
Daniel Grossmann-Kavanagh me@d****m 1
Brian Kanya b****a@g****m 1
Asim Shrestha 5****a 1
Andrew Spott a****t@g****m 1
Albert Davies a****t@a****m 1
tjsousa t****b@g****m 1
thinker007 t****e@g****m 1
suliveevil 3****l 1
srikary12 1****2 1
and 29 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 311
  • Total pull requests: 499
  • Average time to close issues: 2 months
  • Average time to close pull requests: 6 days
  • Total issue authors: 175
  • Total pull request authors: 68
  • Average comments per issue: 2.08
  • Average comments per pull request: 0.44
  • Merged pull requests: 395
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 141
  • Pull requests: 234
  • Average time to close issues: 14 days
  • Average time to close pull requests: 6 days
  • Issue authors: 94
  • Pull request authors: 50
  • Average comments per issue: 1.4
  • Average comments per pull request: 0.5
  • Merged pull requests: 159
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • sabaimran (43)
  • debanjum (28)
  • thinker007 (9)
  • balonarsIh (6)
  • baditaflorin (6)
  • JOduMonT (5)
  • edbock (5)
  • nesretep-anp1 (4)
  • mingLvft (3)
  • andreiramani (3)
  • raphaelventura (3)
  • kalle07 (3)
  • stevennt (3)
  • ses770227 (3)
  • Sandhyateju (2)
Pull Request Authors
  • debanjum (220)
  • sabaimran (134)
  • MythicalCow (24)
  • aam-at (10)
  • shantanuSakpal (8)
  • kira-offgrid (6)
  • hjamet (6)
  • eltociear (5)
  • samhoooo (4)
  • adityakrmishra (4)
  • bryanbkmb (4)
  • HusainBhattiwala (4)
  • bearycool11 (3)
  • emmanuel-ferdman (3)
  • ArtemkaKun (3)
Top Labels
Issue Labels
fix (157) upgrade (86) good first issue (13) question (8) plugin (3) coverage (3) docker (3) documentation (2) maintain (2) try (1)
Pull Request Labels
upgrade (85) fix (41) maintain (33) plugin (20) coverage (13) try (12) documentation (4) help wanted (2) docker (1) improve (1)

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 16,138 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 3
    (may contain duplicates)
  • Total versions: 1,344
  • Total maintainers: 2
  • Total advisories: 3
proxy.golang.org: github.com/khoj-ai/khoj
  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 6.5%
Average: 6.7%
Dependent repos count: 7.0%
Last synced: 6 months ago
pypi.org: khoj-assistant

khoj-assistant is now khoj

  • Versions: 784
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 5,797 Last month
Rankings
Stargazers count: 1.2%
Forks count: 3.9%
Downloads: 4.2%
Average: 8.2%
Dependent packages count: 10.1%
Dependent repos count: 21.6%
Maintainers (2)
Last synced: 6 months ago
pypi.org: khoj

Your Second Brain

  • Versions: 554
  • Dependent Packages: 0
  • Dependent Repositories: 2
  • Downloads: 10,341 Last month
Rankings
Dependent packages count: 10.0%
Average: 10.8%
Dependent repos count: 11.6%
Maintainers (2)
Last synced: 6 months ago

Dependencies

.github/workflows/build_khoj_el.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v1 composite
.github/workflows/dockerize.yml actions
  • actions/checkout v3 composite
  • docker/build-push-action v2 composite
  • docker/login-action v2 composite
  • docker/setup-buildx-action v2 composite
.github/workflows/dockerize_telemetry_server.yml actions
  • actions/checkout v3 composite
  • docker/build-push-action v2 composite
  • docker/login-action v2 composite
  • docker/setup-buildx-action v2 composite
.github/workflows/pypi.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
  • pypa/gh-action-pypi-publish v1.6.4 composite
.github/workflows/release.yml actions
  • actions/checkout v3 composite
  • actions/setup-node v3 composite
  • actions/upload-artifact v3 composite
  • softprops/action-gh-release v1 composite
.github/workflows/test.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/test_khoj_el.yml actions
  • actions/checkout v3 composite
  • purcell/setup-emacs master composite
Dockerfile docker
  • ubuntu jammy build
docker-compose.yml docker
  • ghcr.io/khoj-ai/khoj latest
src/telemetry/Dockerfile docker
  • tiangolo/uvicorn-gunicorn python3.11-slim build
src/interface/obsidian/versions.json meteor
versions.json meteor
src/interface/desktop/package.json npm
  • electron 26.1.0 development
  • @todesktop/runtime ^1.3.0
  • axios ^1.5.0
  • cron ^2.4.3
  • electron-store ^8.1.0
  • fs ^0.0.1-security
src/interface/desktop/yarn.lock npm
  • 181 dependencies
src/interface/obsidian/package.json npm
  • @types/node ^16.11.6 development
  • @typescript-eslint/eslint-plugin 5.29.0 development
  • @typescript-eslint/parser 5.29.0 development
  • builtin-modules 3.3.0 development
  • esbuild 0.14.47 development
  • obsidian latest development
  • tslib 2.4.0 development
  • typescript 4.7.4 development
  • @types/node-fetch ^2.6.4
  • node-fetch ^3.1.0
src/interface/obsidian/yarn.lock npm
  • @nodelib/fs.scandir 2.1.5
  • @nodelib/fs.stat 2.0.5
  • @nodelib/fs.walk 1.2.8
  • @types/codemirror 0.0.108
  • @types/estree 1.0.0
  • @types/json-schema 7.0.11
  • @types/node 20.3.3
  • @types/node 16.18.12
  • @types/node-fetch 2.6.4
  • @types/tern 0.23.4
  • @typescript-eslint/eslint-plugin 5.29.0
  • @typescript-eslint/parser 5.29.0
  • @typescript-eslint/scope-manager 5.29.0
  • @typescript-eslint/type-utils 5.29.0
  • @typescript-eslint/types 5.29.0
  • @typescript-eslint/typescript-estree 5.29.0
  • @typescript-eslint/utils 5.29.0
  • @typescript-eslint/visitor-keys 5.29.0
  • array-union 2.1.0
  • asynckit 0.4.0
  • braces 3.0.2
  • builtin-modules 3.3.0
  • combined-stream 1.0.8
  • data-uri-to-buffer 4.0.1
  • debug 4.3.4
  • delayed-stream 1.0.0
  • dir-glob 3.0.1
  • esbuild 0.14.47
  • esbuild-android-64 0.14.47
  • esbuild-android-arm64 0.14.47
  • esbuild-darwin-64 0.14.47
  • esbuild-darwin-arm64 0.14.47
  • esbuild-freebsd-64 0.14.47
  • esbuild-freebsd-arm64 0.14.47
  • esbuild-linux-32 0.14.47
  • esbuild-linux-64 0.14.47
  • esbuild-linux-arm 0.14.47
  • esbuild-linux-arm64 0.14.47
  • esbuild-linux-mips64le 0.14.47
  • esbuild-linux-ppc64le 0.14.47
  • esbuild-linux-riscv64 0.14.47
  • esbuild-linux-s390x 0.14.47
  • esbuild-netbsd-64 0.14.47
  • esbuild-openbsd-64 0.14.47
  • esbuild-sunos-64 0.14.47
  • esbuild-windows-32 0.14.47
  • esbuild-windows-64 0.14.47
  • esbuild-windows-arm64 0.14.47
  • eslint-scope 5.1.1
  • eslint-utils 3.0.0
  • eslint-visitor-keys 2.1.0
  • eslint-visitor-keys 3.3.0
  • esrecurse 4.3.0
  • estraverse 4.3.0
  • estraverse 5.3.0
  • fast-glob 3.2.12
  • fastq 1.15.0
  • fetch-blob 3.2.0
  • fill-range 7.0.1
  • form-data 3.0.1
  • formdata-polyfill 4.0.10
  • functional-red-black-tree 1.0.1
  • glob-parent 5.1.2
  • globby 11.1.0
  • ignore 5.2.4
  • is-extglob 2.1.1
  • is-glob 4.0.3
  • is-number 7.0.0
  • lru-cache 6.0.0
  • merge2 1.4.1
  • micromatch 4.0.5
  • mime-db 1.52.0
  • mime-types 2.1.35
  • moment 2.29.4
  • ms 2.1.2
  • node-domexception 1.0.0
  • node-fetch 3.3.1
  • obsidian 1.1.1
  • path-type 4.0.0
  • picomatch 2.3.1
  • queue-microtask 1.2.3
  • regexpp 3.2.0
  • reusify 1.0.4
  • run-parallel 1.2.0
  • semver 7.3.8
  • slash 3.0.0
  • to-regex-range 5.0.1
  • tslib 2.4.0
  • tslib 1.14.1
  • tsutils 3.21.0
  • typescript 4.7.4
  • web-streams-polyfill 3.2.1
  • yallist 4.0.0
pyproject.toml pypi
  • aiohttp == 3.8.5
  • anyio == 3.7.1
  • bs4 >= 0.0.1
  • dateparser >= 1.1.1
  • defusedxml == 0.7.1
  • fastapi == 0.77.1
  • gpt4all == 1.0.12; platform_system == 'Linux' and platform_machine == 'x86_64'
  • gpt4all == 1.0.12; platform_system == 'Windows' or platform_system == 'Darwin'
  • jinja2 == 3.1.2
  • langchain >= 0.0.187
  • openai >= 0.27.0
  • pillow == 9.3.0
  • pydantic >= 1.10.10
  • pymupdf >= 1.23.3
  • pyyaml == 6.0
  • requests >= 2.26.0
  • rich >= 13.3.1
  • schedule == 1.1.0
  • sentence-transformers == 2.2.2
  • tenacity >= 8.2.2
  • tiktoken >= 0.3.2
  • torch >= 2.0.1
  • transformers >= 4.28.0
  • uvicorn == 0.17.6
src/telemetry/requirements.txt pypi
  • fastapi *
  • posthog *
  • python-dotenv *
  • uvicorn *
.github/workflows/desktop.yml actions
  • actions/checkout v3 composite
  • actions/setup-node v3 composite
.github/workflows/dockerize_production.yml actions
  • actions/checkout v3 composite
  • docker/build-push-action v2 composite
  • docker/login-action v2 composite
  • docker/setup-buildx-action v2 composite
.github/workflows/pre-commit.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite