Newer
Older
TelosDB / README.md
@楽曲作りまくりおじさん 楽曲作りまくりおじさん 11 hours ago 2 KB docs: polish README.md and update system structure

TelosDB

ローカル完結型セマンティック検索基盤 & MCPサーバー


概要

TelosDB は、Tauri 2 と Rust を核とした、プライバシー重視のローカル特化型ナレッジベースです。 SQLite Vector拡張(sqlite-vec)を活用し、外部APIを一切介さずに、ローカルLLM(Gemma-3)を用いた高度な意味検索と知識管理を実現します。

AIエージェントが自律的に記憶を蓄積・整理するための基盤として設計されており、Model Context Protocol (MCP) を通じて、LM Studio や Claude Desktop 等から即座に利用可能です。


主な機能

  • 🧠 セマンティック検索 (Vector Search): 意味の近さを考慮した高度な検索。
  • 🤖 MCP SSE サーバー内蔵: AIエージェント(LM Studio / Claude等)からの自律的な知識操作が可能。
  • 🔄 自動ヒーリング (Self-Healing): モデル変更によるベクトル次元数の不一致を自動検知し、バックグラウンドで補完。
  • 🛡️ 完全ローカル・プライバシー: データ、モデル、推論エンジンのすべてがローカルで完結。
  • ✨ プレミアムなUI/UX: ガラスモーフィズムとカスタムアニメーションを採用したデスクトップ体験。
  • 📦 常駐管理: システムトレイ常駐により、MCPサーバーを常にバックグラウンドで待機可能。

システム構造

graph TD
    subgraph "Frontend (Webview)"
        UI[Premium Glass UI]
        SSE[SSE Client Monitor]
    end

    subgraph "Backend (Rust / Tauri)"
        Core[Tauri 2 Core]
        Axum[Axum SSE Server]
        DB[(SQLite + Vector Ext)]
        Logger[Rotating Logger]
    end

    subgraph "Sidecar (llama.cpp)"
        Server[llama-server]
        Model[Gemma-3 GGUF]
    end

    UI <-- JSON/SSE --> Axum
    Axum <-- CRUD/Search --> DB
    Core -- Lifecycle Mgmt --> Server
    Server -- Inference --> Model
    Server -- Log Sync --> Logger

クイックスタート

1. 動作要件

  • Windows 10/11 (x64)
  • Rust 1.77.2+
  • Node.js (Bun 推奨)

2. モデルの準備

src-tauri/bin/gemma-3-270m-it-Q4_K_M.gguf を配置してください。

3. ビルドと実行

bun install
bun run tauri dev

ディレクトリ構成

  • src/: フロントエンド(Vanilla JS + Vanilla CSS)
  • src-tauri/src/: バックエンド(Rust / Tauriコマンド / MCP実装)
  • document/: 設計書・仕様書(mermaid図解付き)
  • journals/: 作業記録(日付別)

ライセンス

MIT License