Skip to main content

codemap-semantic-index

Embedding-based semantic recall plugin for codemap.

Registers an embedding ranker into codemap recall via the codemap.recall_hooks entry-point group (introduced in codemap-core 0.4.1). codemap-aimemory automatically RRF-fuses the embedding ranking with its token ranking and applies freshness decay (P4-2).

Install

pipx inject codemap codemap-semantic-index
# pulls sentence-transformers + torch (~200MB)

# Pick + download a local model (1.2GB default)
codemap embed install                   # interactive picker
codemap embed install BAAI/bge-m3       # direct

# First embed (writes <project>/.ai-memory/_semantic/)
codemap embed

# Now `codemap recall` does double-path (token + embedding) + RRF + freshness
codemap recall '<query>' --with-content

Default model

Qwen/Qwen3-Embedding-0.6B (1024 dim, 32k context, 1.2GB). Same-source training as the Qwen cloud text-embedding-v3, so switching to cloud preserves recall "feel".

Cloud backend (any OpenAI-compatible embedding API)

codemap embed backend set    # interactive picker (qwen / openai / zhipu / voyage / custom)
codemap embed backend show
codemap embed backend reset  # back to local

Four preset providers + custom for self-hosted vLLM / Ollama / TEI. Config persists to ~/.config/codemap/embedding.yaml (chmod 600).

Storage

<project_root>/.ai-memory/_semantic/
├── chunks.json    chunked text + metadata (model-independent)
├── vectors.npy    (n_chunks, 1024) float32 (model-specific)
├── model_id.txt   active backend fingerprint
└── manifest.json  text_hash → chunk_id (drives incremental)

Switching models requires codemap embed --rebuild (different vector spaces are not comparable).

Design doc

Obsidian/Notes/07-Ideas/AI-Enterprise-Delivery-System/2026-06-27-p1-3-codemap-semantic-index-设计方案.md — full spec including chunker / RRF / freshness integration.

Metadata

Release files for codemap-semantic-index 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for codemap-semantic-index 0.2.3
File Size Uploaded Provenance Actions
codemap_semantic_index-0.2.3.tar.gz 35.5 kB With provenance Details for codemap_semantic_index-0.2.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for codemap-semantic-index 0.2.3
File Interpreter ABI Platform Actions
codemap_semantic_index-0.2.3-py3-none-any.whl Python 3 none any Details for codemap_semantic_index-0.2.3-py3-none-any.whl

Total release size: 66.0 kB

Release files / codemap_semantic_index-0.2.3.tar.gz

Download URL codemap_semantic_index-0.2.3.tar.gz
Size 35.5 kB
Tags Source
SHA-256 checksum
How to use checksums
fd20a4e6a14127b5852e60186937af04b0f233807a44c6507d3a417a2eb47e7d
BLAKE2b-256 checksum
How to use checksums
d458e83a4d108b5c2842438a0b4a55c7edc4cf7ac1b1cb297df8bb09c2885fef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.

Transparency log

Release files / codemap_semantic_index-0.2.3-py3-none-any.whl

Download URL codemap_semantic_index-0.2.3-py3-none-any.whl
Size 30.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
06f9b57716e21bdc8d31625dd2120fbaca0d6dc9160c79b58c9b1145ce414256
BLAKE2b-256 checksum
How to use checksums
555a9339aea52b01708bf7d78847196209c03d5a8c64c508cbda474b841f71a0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.

Transparency log

Security for codemap-semantic-index 0.2.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for codemap_semantic_index-0.2.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page