# reorproject/reor

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/reorproject-reor).**

8,560 stars · 527 forks · JavaScript · AGPL-3.0 · archived

## Links

- GitHub: https://github.com/reorproject/reor
- Homepage: https://reorproject.org
- awesome-repositories: https://awesome-repositories.com/repository/reorproject-reor.md

## Topics

`ai` `lancedb` `llama` `llamacpp` `local-first` `markdown` `note-taking` `ollama` `pkm` `rag` `second-brain` `vector-database`

## Description

Reor is a local AI knowledge management application that stores, links, and searches personal notes using large language models and vector embeddings entirely on the user's device. It functions as a private AI note assistant, keeping all data and processing local for full privacy without relying on external cloud services.

The application integrates with Ollama to manage the lifecycle of local LLMs and embedding models, handling downloads, updates, and execution. Notes are imported from markdown files, preserving existing file structure, and are automatically linked through vector-similarity comparisons that surface semantic connections without manual tagging. Users can search their note corpus by meaning rather than exact keywords, and ask natural language questions that retrieve relevant passages and generate answers using the local LLM.

Reor also provides an OpenAI-compatible API bridge, allowing users to optionally connect to external AI services as an alternative to local models. The embedding pipeline runs entirely on the machine, computing and storing vector representations locally to ensure data never leaves the device.

## Tags

### Artificial Intelligence & ML

- [AI Knowledge Management](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-knowledge-management.md) — Provides a complete private AI knowledge management system that stores, links, and searches personal notes using local LLMs.
- [Local AI Model Runtimes](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/local-ai-model-runtimes.md) — Downloads and manages LLMs and embedding models through Ollama, keeping all processing on the user's machine. ([source](https://cdn.jsdelivr.net/gh/reorproject/reor@main/README.md))
- [Model Lifecycle Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-application-frameworks/local-on-device-ai/ollama-engine-integrations/model-lifecycle-managers.md) — Manages the full lifecycle of local LLM and embedding models through Ollama for private AI processing.
- [Ollama Model Runners](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-application-frameworks/local-on-device-ai/ollama-engine-integrations/ollama-model-runners.md) — Downloads, updates, and executes LLMs and embedding models through the Ollama runtime for local AI processing.
- [Ollama-Powered Note Tools](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-application-frameworks/local-on-device-ai/ollama-engine-integrations/ollama-powered-note-tools.md) — Integrates with Ollama to run local LLMs and embedding models for AI-assisted note features like semantic search and question answering.
- [Retrieval-Augmented Generation](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-interfaces/retrieval-augmented-generation.md) — Retrieves relevant note passages via vector search and feeds them to a local LLM for grounded answer generation.
- [Local Embedding Pipelines](https://awesome-repositories.com/f/artificial-intelligence-ml/embeddings/local-embedding-pipelines.md) — Computes and stores vector embeddings entirely on the user's machine using locally-run models for full privacy.
- [Local Model Query APIs](https://awesome-repositories.com/f/artificial-intelligence-ml/model-api-integrations/local-model-query-apis.md) — Answers questions by sending a natural-language query to a locally-run large language model and returning the generated response. ([source](https://www.reorproject.org/docs/documentation/openai-like-api))
- [Contextual Note Surfacing](https://awesome-repositories.com/f/artificial-intelligence-ml/relational-indexing/contextual-note-surfacing.md) — Automatically connects notes by comparing their vector embeddings, surfacing related content as you write. ([source](https://cdn.jsdelivr.net/gh/reorproject/reor@main/README.md))

### Part of an Awesome List

- [Question Answering](https://awesome-repositories.com/f/awesome-lists/ai/question-answering.md) — Retrieves relevant passages from the note corpus and feeds them to a local LLM to answer user queries. ([source](https://cdn.jsdelivr.net/gh/reorproject/reor@main/README.md))
- [Note Importers](https://awesome-repositories.com/f/awesome-lists/productivity/note-taking-apps/note-importers.md) — Reads markdown files from a designated directory, allowing migration of notes from other applications. ([source](https://cdn.jsdelivr.net/gh/reorproject/reor@main/README.md))

### Business & Productivity Software

- [Local-First Knowledge Bases](https://awesome-repositories.com/f/business-productivity-software/local-first-knowledge-bases.md) — Operates as a local-first knowledge base that stores and processes all notes and AI models entirely on the user's device.
- [Automatic Note Discovery](https://awesome-repositories.com/f/business-productivity-software/note-taking-search/automatic-note-discovery.md) — Discovers semantic connections between notes as they are created or edited and surfaces those relationships automatically. ([source](https://www.reorproject.org/docs/documentation/openai-like-api))
- [Markdown Note Managers](https://awesome-repositories.com/f/business-productivity-software/markdown-note-managers.md) — Imports, organizes, and edits markdown notes with automatic semantic linking and full-text search capabilities.

### Data & Databases

- [Embedding-Based Note Searches](https://awesome-repositories.com/f/data-databases/vector-search/embedding-generation/embedding-based-note-searches.md) — Searches notes by meaning using local embedding models and vector similarity, enabling natural language queries over the corpus.

### Development Tools & Productivity

- [Note-Taking App AI Assistants](https://awesome-repositories.com/f/development-tools-productivity/note-taking-app-ai-assistants.md) — Answers questions and surfaces related content using locally-run AI models, keeping all data on-device as a private note assistant.
- [Note-Taking App Similarity Searchers](https://awesome-repositories.com/f/development-tools-productivity/note-taking-app-similarity-searchers.md) — Links notes by comparing their vector embeddings via cosine similarity, surfacing related content without manual tagging.

### Security & Cryptography

- [Semantic Note Retrieval](https://awesome-repositories.com/f/security-cryptography/credential-vaults/encrypted-vaults/semantic-note-retrieval.md) — Finds notes by meaning using vector similarity and local embedding models, without relying on external cloud services.

### Operating Systems & Systems Programming

- [Markdown Note Importers](https://awesome-repositories.com/f/operating-systems-systems-programming/file-content-import/markdown-note-importers.md) — Imports existing notes from markdown files, preserving file structure and enabling migration from other applications.
