Telys — on-device memory

Name: Telys — on-device memory
Author: thyn-ai

作者：thyn-ai版本 0.1.14i★ –i在你的电脑上运行

注册名称io.github.thyn-ai/telys

安装

概览

作者提供的说明（英文原文）

Private on-device memory & retrieval for AI assistants — offline vector + lexical search.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 搜索与 AI 记忆

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
注册中心没有列出需要填写的密钥。

你需要

PyPI已安装 Python 的 uv（用于 uvx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "telys": {
      "command": "uvx",
      "args": [
        "telys",
        "mcp"
      ]
    }
  }
}

在终端中运行这条命令

claude mcp add telys -- uvx telys mcp

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "telys": {
      "command": "uvx",
      "args": [
        "telys",
        "mcp"
      ]
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "telys": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "telys",
        "mcp"
      ]
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 thyn-ai 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“搜索与 AI 记忆”中的其他服务器比较i

星标数多于此分类中其他 7266 个服务器的 0%
发布到注册中心的时间比此分类中其他 7266 个服务器的 75% 更新
基础检查结果等于或优于此分类中其他 7266 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Telys — on-device memory 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.1.14）于12天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它？

同一分类中有：Context7, Codebase Memory, Exa

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Context7

作者：upstash

Up-to-date docs for AI agents

电脑或云端★ 64,224MIT昨天更新

安装

Codebase Memory

作者：DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

在你的电脑上运行★ 48,148MIT21天前更新

安装

Exa

作者：exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

在云端运行★ 5,213MIT上个月更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

telys

Public SDK for Telys — embedded, on-device memory & retrieval. In-process, zero cloud roundtrips at query time.

This package contains the complete developer-facing surface: the Telys/Collection facades, query/filter types, the EmbeddingProvider interface, the Tuner/TuningPlan interfaces, the full MCP server (telys/mcp.py — 19 tools, protocol 2025-06-18, stdio), a runtime loader, and the telys CLI. The numerical kernel (libame_kernel) the tools drive is a separately distributed, signed on-device runtime fetched by telys login (free community license) — the same arrangement as MCP servers that front hosted or signed-binary backends.

Install

As a CLI (recommended — isolated env, on your PATH, not pinned to one Python):

pipx install telys

telys login # sign in → free device license + signed runtime; fully offline thereafter

As a library (to import telys in your own project):

python -m venv .venv && . .venv/bin/activate

pip install telys

Plain pip install --user telys works too, but pip may warn that its user-scripts dir isn't on your

PATH (a macOS --user quirk) — pipx avoids that entirely. Runtime platforms: **macOS arm64, Linux

x86_64/arm64 (Windows: run under WSL2**).

from telys import Telys

db = Telys("./memory") col = db.create_collection("docs", dim=768, partition_by="tenant_id") # dim is arbitrary — 384/768/1024/1536/3072… col.add(vectors, ids=ids, metadata=metadata) # bring your own vectors (embedding-agnostic, any dimension) hits = col.search(qvec, where={"tenant_id": "acme"}, top_k=10, explain=True)

The runtime is required for execution; the embedder is optional — col.add(vectors, …) and col.add_texts(…) both need the runtime, but only *_texts needs an embedder (bring your own via telys.embedding.CallableEmbedder, or use the on-device bigram embedder).

For local development, install the runtime as a package instead of via the CLI:

pip install "telys[runtime]"   # or: pip install telys-runtime

MCP server

telys mcp runs Telys as a Model Context Protocol server over stdio, exposing 19 tools — the full memory surface (CRUD, filtered queries, lexical search, compaction / IVF / tuning, plus a repo auto-indexer) — to any MCP client (Claude Desktop/Code, Cursor, Codex, Qwen Code, …). Everything is local and offline. Introspection (initialize/tools/list) needs no credentials; executing memory tools requires the one-time free telys login (device authorization, free community plan) — fully offline thereafter, no API key in the client config.

pipx install telys

telys login # free device license + signed on-device runtime telys runtime verify # confirm the runtime the tools drive is present telys mcp # serve JSON-RPC 2.0 (protocol 2025-06-18) on stdin/stdout

You rarely start it by hand — telys mcp install writes the server entry into your clients — or add this block to a client's MCP config yourself:

"mcpServers": { "telys": { "command": "telys", "args": ["mcp"] } } }

Registry: io.github.thyn-ai/telys on the Official MCP Registry. Server source: packages/telys-sdk/telys/mcp.py. MCP docs: docs.telys.ai/mcp.

Tool	What it does	Required arguments
`telys_search`	Semantic + lexical search over a memory collection	`collection`, `query`
`telys_add`	Add text documents (collection auto-created if absent)	`collection`, `texts`
`telys_create_collection`	Create a collection (fix name + partition key up front)	`name`
`telys_list_collections`	List saved collections in the active store	—
`telys_stats`	Row counts and index state for one collection	`collection`
`telys_upsert`	Add-or-replace rows by id (the idempotent write)	`collection`, `texts`, `ids`
`telys_update`	Re-embed/replace EXISTING ids (strict: ids required)	`collection`, `texts`, `ids`
`telys_delete`	Tombstone rows by id	`collection`, `ids`
`telys_ids`	List live external ids, optionally `where`-scoped	`collection`
`telys_count`	Live row count, optionally `where`-scoped	`collection`
`telys_get`	Exact row lookup by id (re-reads repo source slices)	`collection`, `ids`
`telys_search_lexical`	On-device BM25 keyword search	`collection`, `query`
`telys_compact`	Flush tombstones, merge delta into the base layout	`collection`
`telys_build_ivf`	Build per-partition IVF indexes (recall-floor calibrated)	`collection`
`telys_build_lexical`	Fit the BM25 lexical index	`collection`
`telys_tune`	Produce (and optionally apply) a TuningPlan	`collection`
`telys_index_repo`	Walk + chunk + ingest a repo, incrementally refreshed	—
`telys_repo_search`	Search the auto-indexed repo (re-indexes first, always fresh)	`query`
`telys_workspace_info`	Report the configured workspace, repo_id and file count	—

Every tool ships a rich description (what it does, when to use it, parameters with defaults, failure modes) and static MCP annotations (readOnlyHint / destructiveHint / idempotentHint / openWorldHint) — openWorldHint: false throughout: the server makes no network calls. Listing the tools needs no credentials and no runtime: initialize + tools/list answer from the static tool registry; only actual tool calls load the signed runtime lazily.

Documentation

Full documentation lives at [docs.telys.ai](https://docs.telys.ai):

Quickstart: your first collection
Working with data — add, upsert, search, filter, snapshot
Embeddings — built-in lexical + bring-your-own via CallableEmbedder
CLI reference · MCP integration · Self-hosting
SDK API index

Telys — on-device memory

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令