Skip to main content
Glama

kenges

Kengeş ders arşivi (kenges-arsiv) için Python paketi. Şimdilik: arşiv doğrulama (kenges check). Sözleşme: ARCHITECTURE.md (§3 arşiv düzeni, §4 record.md, §6 paket).

Kurulum

Python ≥ 3.11 gerekir.

python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'   # Windows: .venv\Scripts\pip

Related MCP server: MASA

Kullanım

kenges check <arsiv_yolu>          # insan okur çıktı
kenges check <arsiv_yolu> --json   # makine çıktısı
kenges mcp --archive <arsiv_yolu> --transport stdio
kenges mcp --archive <arsiv_yolu> --transport http  # http://127.0.0.1:8765/mcp
kenges mcp --archive <arsiv_yolu> --transport http --allowed-host example.trycloudflare.com

MCP kaynağı (biri seçilir)

kenges mcp --archive <arsiv_yolu>            # yerel extract + index
kenges mcp --index kenges-index.sqlite       # hazır indeks, arşiv gerekmez
kenges mcp --remote <owner>/kenges-arsiv     # Release'teki indeksi indirir (arşiv gerekmez)

--remote: index etiketli release'in kenges-index.sqlite asset'ini kullanıcı önbelleğine indirir (Linux ~/.cache/kenges, macOS ~/Library/Caches/kenges, Windows %LOCALAPPDATA%\kenges\Cache). ETag/updated_at değişmediyse tekrar indirmez; arka planda her --refresh-minutes (varsayılan 15, 0 = kapalı) dakikada kontrol eder, yeni dosyayı doğrulayıp (integrity_check + şema sürümü) atomik değiştirir. Ağ yoksa son geçerli önbellekle çalışır, hiç yoksa hata verir. Etiket: --tag (varsayılan index). Private repo / yüksek hız sınırı için GITHUB_TOKEN ortam değişkeni kullanılabilir.

Ref linkleri için indeks kenges index ... --repo <owner/repo> --commit <sha> ile üretilir (https://github.com/<repo>/blob/<sha>/<kayıt dizini>/<dosya>); CI bunu otomatik yapar.

Hata varsa çıkış kodu 1, yoksa 0. Denetlenenler: catalog/courses.yaml, her record.md (şema, konum/origin kuralları), files[].sha256/size, mükerrer sha256 ve id, based_on/related hedefleri, kayıtsız dosyalar. .., mutlak yol ve symlink reddedilir.

Test

.venv/bin/pytest -q

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides a local, read-oriented MCP server for the MASA protocol, enabling offline validation, inspection, lineage tracing, public-export audit, and processing-request planning for sound-matter records.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Serves an offline knowledge base — an aggregated corpus of reference works plus a RAG index over them and the user's own documents — to any local AI model over MCP. Enables offline assistants such as Open WebUI, OpenCode, or Jan to ground answers in searchable, provenance-tracked local content without any network connection.
    102 npm
    MIT
  • F
    license
    A
    quality
    C
    maintenance
    Gives an LLM client BM25 keyword search over a local corpus of Markdown and text files, letting it find ranked passages, fetch exact chunks with source offsets, read whole documents, and list what was indexed. It runs entirely locally over stdio with an in-memory index, calling no model and requiring no API key.
    4
    -