[MLsys2026 Best Paper]: https://arxiv.org/abs/2506.08276. RAG on Everything with LEANN. Enjoy 97% storage savings while running a fast, accurate, and 100% private RAG application on your personal device.
Python aifaissgpt-osslangchainllama-indexllmlocalstorageoffline-firstollamaprivacypythonragretrieval-augmented-generationvector-databasevector-searchvectors
docs: update repository URLs to StarTrail-org/LEANN (#426)
Jackson Wangae9fa67bc8dc
diff --git a/CLAUDE.md b/CLAUDE.mdindex c6f5487..81e4705 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -165,7 +165,7 @@ Requires Python 3.10+ (uses PEP 604 union syntax `X | Y`).## Roadmap- Public roadmap: `docs/roadmap.md` — tracks P0/P1 priorities, completed milestones, and timeline.- Long-term vision: `docs/ultimate_goal.md` — the north star for where LEANN is headed.-- Keep in sync with [GitHub issue #237](https://github.com/yichuan-w/LEANN/issues/237).+- Keep in sync with [GitHub issue #237](https://github.com/StarTrail-org/LEANN/issues/237).- Welcome everyone to add more, and the craziest feature you want to put here! If people want some feature, all put there.## Changelog (for contributors)diff --git a/README.md b/README.mdindex 3305bb6..fd3c74b 100755--- a/README.md+++ b/README.md@@ -4,13 +4,13 @@<p align="center"><a href="https://trendshift.io/repositories/15049" target="_blank">- <img src="https://trendshift.io/api/badge/repositories/15049" alt="yichuan-w/LEANN | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>+ <img src="https://trendshift.io/api/badge/repositories/15049" alt="StarTrail-org/LEANN | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a></p><p align="center"><img src="https://img.shields.io/badge/Python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue.svg" alt="Python Versions">- <img src="https://github.com/yichuan-w/LEANN/actions/workflows/build-and-publish.yml/badge.svg" alt="CI Status">+ <img src="https://github.com/StarTrail-org/LEANN/actions/workflows/build-and-publish.yml/badge.svg" alt="CI Status"><img src="https://img.shields.io/badge/Platform-Ubuntu%20%26%20Arch%20%26%20WSL%20%7C%20macOS%20(ARM64%2FIntel)%20%7C%20Windows-lightgrey" alt="Platform"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="MIT License"><img src="https://img.shields.io/badge/MCP-Native%20Integration-blue" alt="MCP Integration">@@ -36,7 +36,7 @@<p>We'd love for you to be part of the LEANN community!<br>👉 <a href="https://join.slack.com/t/leann-e2u9779/shared_invite/zt-3ol2ww9ic-Eg_kB8omwe6xmYVd0epr4Q"><b>Join LEANN Slack</b></a><br>- If the invite link has expired or you have trouble joining, please <a href="https://github.com/yichuan-w/LEANN/issues">open an issue</a> and we'll help you get in!+ If the invite link has expired or you have trouble joining, please <a href="https://github.com/StarTrail-org/LEANN/issues">open an issue</a> and we'll help you get in!</p></div>@@ -104,7 +104,7 @@ curl -LsSf https://astral.sh/uv/install.sh | shClone the repository to access all examples and try amazing applications,```bash-git clone https://github.com/yichuan-w/LEANN.git leann+git clone https://github.com/StarTrail-org/LEANN.git leanncd leann```@@ -131,7 +131,7 @@ uv pip install leann```bash-git clone https://github.com/yichuan-w/LEANN.git leann+git clone https://github.com/StarTrail-org/LEANN.git leanncd leanngit submodule update --init --recursive```@@ -147,7 +147,7 @@ uv sync --extra diskann**Linux (Ubuntu/Debian):**-Note: On Ubuntu 20.04, you may need to build a newer Abseil and pin Protobuf (e.g., v3.20.x) for building DiskANN. See [Issue #30](https://github.com/yichuan-w/LEANN/issues/30) for a step-by-step note.+Note: On Ubuntu 20.04, you may need to build a newer Abseil and pin Protobuf (e.g., v3.20.x) for building DiskANN. See [Issue #30](https://github.com/StarTrail-org/LEANN/issues/30) for a step-by-step note.You can manually install [Intel oneAPI MKL](https://www.intel.com/content/www/us/en/developer/tools/oneapi/onemkl.html) instead of `libmkl-full-dev` for DiskANN. You can also use `libopenblas-dev` for building HNSW only, by removing `--extra diskann` in the command below.@@ -178,7 +178,7 @@ uv sync --extra diskann**Linux (RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux):**-See [Issue #50](https://github.com/yichuan-w/LEANN/issues/50) for more details.+See [Issue #50](https://github.com/StarTrail-org/LEANN/issues/50) for more details.```bashsudo dnf groupinstall -y "Development Tools"@@ -223,7 +223,7 @@ uv sync --extra diskannOur declarative API makes RAG as easy as writing a config file.-Check out [demo.ipynb](demo.ipynb) or [](https://colab.research.google.com/github/yichuan-w/LEANN/blob/main/demo.ipynb)+Check out [demo.ipynb](demo.ipynb) or [](https://colab.research.google.com/github/StarTrail-org/LEANN/blob/main/demo.ipynb)```pythonfrom leann import LeannBuilder, LeannSearcher, LeannChat@@ -1359,7 +1359,7 @@ This work is done at [**Berkeley Sky Computing Lab**](https://sky.cs.berkeley.ed## Star History-[](https://star-history.dera.page/#yichuan-w/LEANN&Date)+[](https://star-history.dera.page/#StarTrail-org/LEANN&Date)<p align="center"><strong>⭐ Star us on GitHub if Leann is useful for your research or applications!</strong></p>@@ -1370,4 +1370,4 @@ This work is done at [**Berkeley Sky Computing Lab**](https://sky.cs.berkeley.ed## 🤖 Explore LEANN with AI-LEANN is indexed on [DeepWiki](https://deepwiki.com/yichuan-w/LEANN), so you can ask questions to LLMs using Deep Research to explore the codebase and get help to add new features.+LEANN is indexed on [DeepWiki](https://deepwiki.com/StarTrail-org/LEANN), so you can ask questions to LLMs using Deep Research to explore the codebase and get help to add new features.diff --git a/demo.ipynb b/demo.ipynbindex e91ec01..c56f468 100644--- a/demo.ipynb+++ b/demo.ipynb@@ -6,7 +6,7 @@"source": ["# Quick Start \n","\n",- "**Home GitHub Repository:** [LEANN on GitHub](https://github.com/yichuan-w/LEANN)\n",+ "**Home GitHub Repository:** [LEANN on GitHub](https://github.com/StarTrail-org/LEANN)\n","\n","**Important for Colab users:** Set your runtime type to T4 GPU for optimal performance. Go to Runtime → Change runtime type → Hardware accelerator → T4 GPU."]diff --git a/docs/COLQWEN_GUIDE.md b/docs/COLQWEN_GUIDE.mdindex 42772f6..10fdcc6 100644--- a/docs/COLQWEN_GUIDE.md+++ b/docs/COLQWEN_GUIDE.md@@ -135,7 +135,7 @@ Auto-detection: CUDA > MPS > CPU- **Pylate**: https://github.com/lightonai/pylate- **ColBERT**: https://github.com/stanford-futuredata/ColBERT- **ColPali Paper**: Vision-Language Models for Document Retrieval-- **Issue #119**: https://github.com/yichuan-w/LEANN/issues/119+- **Issue #119**: https://github.com/StarTrail-org/LEANN/issues/119## 🐛 Troubleshootingdiff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.mdindex 3629d4f..843878b 100644--- a/docs/CONTRIBUTING.md+++ b/docs/CONTRIBUTING.md@@ -21,7 +21,7 @@ We welcome contributions! Leann is built by the community, for the community.2. **Clone the repository**:```bash- git clone https://github.com/yichuan-w/LEANN.git leann+ git clone https://github.com/StarTrail-org/LEANN.git leanngit submodule update --init --recursivecd leann```diff --git a/docs/RELEASE.md b/docs/RELEASE.mdindex 8588f45..6757bba 100644--- a/docs/RELEASE.md+++ b/docs/RELEASE.md@@ -8,7 +8,7 @@ Add `PYPI_API_TOKEN` to GitHub Secrets:## Release (One-click)-1. Go to: https://github.com/yichuan-w/LEANN/actions/workflows/release-manual.yml+1. Go to: https://github.com/StarTrail-org/LEANN/actions/workflows/release-manual.yml2. Click "Run workflow"3. Enter version: `0.1.2`4. Click green "Run workflow" button@@ -19,4 +19,4 @@ That's it! The workflow will automatically:- ✅ Publish to PyPI- ✅ Create GitHub tag and release-Check progress: https://github.com/yichuan-w/LEANN/actions+Check progress: https://github.com/StarTrail-org/LEANN/actionsdiff --git a/docs/ast_chunking_guide.md b/docs/ast_chunking_guide.mdindex 34d7ccb..9e68ad6 100644--- a/docs/ast_chunking_guide.md+++ b/docs/ast_chunking_guide.md@@ -32,7 +32,7 @@ uv pip install -e "."#### For developers (from source, editable)```bash-git clone https://github.com/yichuan-w/LEANN.git leann+git clone https://github.com/StarTrail-org/LEANN.git leanncd leanngit submodule update --init --recursiveuv syncdiff --git a/docs/configuration-guide.md b/docs/configuration-guide.mdindex 89268d6..fc54350 100644--- a/docs/configuration-guide.md+++ b/docs/configuration-guide.md@@ -52,7 +52,7 @@ Based on our experience developing LEANN, embedding models fall into three categ### Quick Start: Cloud and Local Embedding Options**OpenAI Embeddings (Fastest Setup)**-For immediate testing without local model downloads(also if you [do not have GPU](https://github.com/yichuan-w/LEANN/issues/43) and do not care that much about your document leak, you should use this, we compute the embedding and recompute using openai API):+For immediate testing without local model downloads(also if you [do not have GPU](https://github.com/StarTrail-org/LEANN/issues/43) and do not care that much about your document leak, you should use this, we compute the embedding and recompute using openai API):```bash# Set OpenAI embeddings (requires OPENAI_API_KEY)--embedding-mode openai --embedding-model text-embedding-3-small@@ -157,7 +157,7 @@ leann ask my-notes \- Configure router or cloud provider port forwarding.- Tunnel traffic through tools like `tailscale`, `cloudflared`, or `ssh -R`.-When you set these options while building an index, LEANN stores them in `meta.json`. Any subsequent `leann ask` or searcher process automatically reuses the same provider settings – even when we spawn background embedding servers. This makes the “server without GPU talking to my local workstation” workflow from [issue #80](https://github.com/yichuan-w/LEANN/issues/80#issuecomment-2287230548) work out-of-the-box.+When you set these options while building an index, LEANN stores them in `meta.json`. Any subsequent `leann ask` or searcher process automatically reuses the same provider settings – even when we spawn background embedding servers. This makes the “server without GPU talking to my local workstation” workflow from [issue #80](https://github.com/StarTrail-org/LEANN/issues/80#issuecomment-2287230548) work out-of-the-box.**Tip:** If your runtime does not require an API key (many local stacks don’t), leave `--api-key` unset. LEANN will skip injecting credentials.diff --git a/docs/user-scripts-tr.md b/docs/user-scripts-tr.mdindex 6002fac..e4ea4bf 100644--- a/docs/user-scripts-tr.md+++ b/docs/user-scripts-tr.md@@ -9,7 +9,7 @@ Bu dokümantasyon, LEANN'ı günlük yaşamda kullanmak için hazırlanmış otoBu scriptleri kullanmak için önce LEANN repository'sini klonlayın:```bash-git clone https://github.com/yichuan-w/LEANN.git+git clone https://github.com/StarTrail-org/LEANN.gitcd LEANN```diff --git a/docs/user-scripts.md b/docs/user-scripts.mdindex 22f2d36..21f14df 100644--- a/docs/user-scripts.md+++ b/docs/user-scripts.md@@ -7,7 +7,7 @@ This documentation describes the automation scripts prepared for using LEANN in### 1. Clone the Repository```bash-git clone https://github.com/yichuan-w/LEANN.git+git clone https://github.com/StarTrail-org/LEANN.gitcd LEANN```diff --git a/llms.txt b/llms.txtindex e470008..a448d1f 100644--- a/llms.txt+++ b/llms.txt@@ -1,7 +1,7 @@# llms.txt — LEANN MCP and Agent Integrationproduct: LEANN-homepage: https://github.com/yichuan-w/LEANN-contact: https://github.com/yichuan-w/LEANN/issues+homepage: https://github.com/StarTrail-org/LEANN+contact: https://github.com/StarTrail-org/LEANN/issues# Installationinstall: uv tool install leann-core --with leanndiff --git a/packages/leann-backend-diskann/leann_backend_diskann/diskann_backend.py b/packages/leann-backend-diskann/leann_backend_diskann/diskann_backend.pyindex 8e97609..b3546f6 100644--- a/packages/leann-backend-diskann/leann_backend_diskann/diskann_backend.py+++ b/packages/leann-backend-diskann/leann_backend_diskann/diskann_backend.py@@ -222,7 +222,7 @@ class DiskannBuilder(LeannBackendBuilderInterface):# When num_vectors < 256, MKL's cblas_sgemm receives degenerate matrix dimensions# and emits non-fatal "Parameter N was incorrect" errors to stderr on Windows.# The index still builds correctly, but the noise can be confusing.- # See: https://github.com/yichuan-w/LEANN/issues/280+ # See: https://github.com/StarTrail-org/LEANN/issues/280_NUM_PQ_CENTROIDS = 256if data.shape[0] < _NUM_PQ_CENTROIDS:logger.warning(diff --git a/packages/leann-core/README.md b/packages/leann-core/README.mdindex 7f9e2ca..7d20a8e 100644--- a/packages/leann-core/README.md+++ b/packages/leann-core/README.md@@ -1,5 +1,5 @@# leann-core-Core APIs, CLI (`leann`), embedding pipeline, and backend plugin registry for [LEANN](https://github.com/yichuan-w/LEANN) — a lightweight local vector/RAG stack.+Core APIs, CLI (`leann`), embedding pipeline, and backend plugin registry for [LEANN](https://github.com/StarTrail-org/LEANN) — a lightweight local vector/RAG stack.-For installation, backends (HNSW, IVF, DiskANN), and full documentation, see the [main repository README](https://github.com/yichuan-w/LEANN/blob/main/README.md).+For installation, backends (HNSW, IVF, DiskANN), and full documentation, see the [main repository README](https://github.com/StarTrail-org/LEANN/blob/main/README.md).diff --git a/packages/leann-mcp/README.md b/packages/leann-mcp/README.mdindex 8af4556..8f3b090 100644--- a/packages/leann-mcp/README.md+++ b/packages/leann-mcp/README.md@@ -74,7 +74,7 @@ leann build my-repo --docs $(git ls-files) --embedding-mode sentence-transformer# Index only tracked Python files from Git.leann build my-python-code --docs $(git ls-files "*.py") --embedding-mode sentence-transformers --embedding-model all-MiniLM-L6-v2 --backend hnsw-# If you encounter empty requests caused by empty files (e.g., __init__.py), exclude zero-byte files. Thanks @ww2283 for pointing [that](https://github.com/yichuan-w/LEANN/issues/48) out+# If you encounter empty requests caused by empty files (e.g., __init__.py), exclude zero-byte files. Thanks @ww2283 for pointing [that](https://github.com/StarTrail-org/LEANN/issues/48) outleann build leann-prospec-lig --docs $(find ./src -name "*.py" -not -empty) --embedding-mode openai --embedding-model text-embedding-3-small```diff --git a/packages/leann/pyproject.toml b/packages/leann/pyproject.tomlindex 3b5e070..441af27 100644--- a/packages/leann/pyproject.toml+++ b/packages/leann/pyproject.toml@@ -38,5 +38,5 @@ cpu = [][project.urls]-Repository = "https://github.com/yichuan-w/LEANN"-Issues = "https://github.com/yichuan-w/LEANN/issues"+Repository = "https://github.com/StarTrail-org/LEANN"+Issues = "https://github.com/StarTrail-org/LEANN/issues"diff --git a/skills/leann-memory/README.md b/skills/leann-memory/README.mdindex 5f1a289..92b7c7a 100644--- a/skills/leann-memory/README.md+++ b/skills/leann-memory/README.md@@ -61,5 +61,5 @@ search, embeddings are recomputed on-demand via a local daemon. OpenClaw's async## Links-- [LEANN Repository](https://github.com/yichuan-w/LEANN)+- [LEANN Repository](https://github.com/StarTrail-org/LEANN)- [Integration Plan](../../docs/openclaw-integration-plan.md)diff --git a/tests/test_cli_verbosity.py b/tests/test_cli_verbosity.pyindex 37024a8..84da6e9 100644--- a/tests/test_cli_verbosity.py+++ b/tests/test_cli_verbosity.py@@ -2,7 +2,7 @@This module tests the configurable verbosity functionality that allowssuppressing C++ output from FAISS/HNSW.-See: https://github.com/yichuan-w/LEANN/issues/187+See: https://github.com/StarTrail-org/LEANN/issues/187"""import os