Skip to content

Latest commit

 

History

History
100 lines (74 loc) · 4.47 KB

File metadata and controls

100 lines (74 loc) · 4.47 KB

llm-note banner

llm-note

CI License: MIT Python 3.10+ Tests: 16 Passed Ecosystem: doc-bricks Umbrella: open-bricks

Deutsch · English · Español · 简体中文 · 日本語 · Русский

Note

Datenschutz & Lokal-Zuerst: llm-note arbeitet vollständig auf lokalen SQLite-Datenbanken und einfachen Textdateien. Es benötigt keine API-Schlüssel, keine Cloud-Server, keinen Vektordatenbank-Overhead und stellt keinerlei Netzwerkverbindungen her. Ideal für datenschutzkonforme KI-Agenten-Workflows.

llm-note ist ein lokaler Notizkern für LLM-Agenten. Das Modul verbindet ein kleines SQLite-Denkarium mit einfachen Text-Notizbüchern, ohne Cloudkonto, ohne Server und ohne externe Laufzeitabhängigkeiten.

Systemarchitektur

graph TD
    subgraph Clients["Schnittstellen & Clients"]
        CLI["llm-note CLI"]
        PyAPI["Python API"]
        Skill["Agenten-Skill (SKILL.md)"]
    end

    subgraph CoreEngine["llm-note Notizkern"]
        NoteStore["NoteStore (SQLite)"]
        FileStore["FileNotebookStore (Text-Datei)"]
        I18N["Lokalisierung (EN/DE/ES/ZH/JA/RU)"]
    end

    subgraph LocalStorage["Lokale Speicher-Ebene"]
        DB[("data/notes.db<br/>(SQLite Denkarium)")]
        Notebooks["notebooks/*.txt<br/>(Text-Notizbücher)"]
        LockFile[".llm-note.lock"]
    end

    CLI --> NoteStore
    CLI --> FileStore
    PyAPI --> NoteStore
    PyAPI --> FileStore
    Skill --> CLI
    Skill --> PyAPI

    NoteStore --> DB
    NoteStore --> I18N
    FileStore --> Notebooks
    FileStore --> LockFile
Loading

Einstieg

Nutze llm-note, wenn ein Agent, Coding-Assistent oder lokaler Forschungsworkflow eine kleine, prüfbare Notizschicht braucht:

Bedarf llm-note hilft bei
Agenten-Gedächtnis Entscheidungen, Beobachtungen und Folge-Marker lokal in SQLite speichern.
Notizbuch-Inbox Textnotizen später prüfen, übertragen oder archivieren.
Datenschutz Ohne gehostete Dienste, Konten, Embeddings oder Hintergrund-Netzwerkzugriffe arbeiten.
Skill-Paket Einen wiederverwendbaren Notiz-Skill neben dem Python-Paket ausliefern.

Funktionen

  • Strukturierte Notizen, Logbuch-Einträge, Kategorien, Stimmung und Beförderungsmarker speichern.
  • Schnelle Text-Notizbücher mit #NB:-Transfermarkierungen führen.
  • Notizen per Python oder CLI durchsuchen.
  • Brainstorm-Einträge anlegen und später in Aufgaben, Wiki-Seiten oder Issues überführen.
  • Nutzertexte in sechs Sprachen bündeln: Deutsch, Englisch, Spanisch, vereinfachtes Chinesisch, Japanisch und Russisch.

Schnellstart

pip install -e .
llm-note --locale de write "Öffentliche README prüfen" --cat release
llm-note --locale de search README

Suchbegriffe werden wörtlich behandelt; % und _ sind keine SQL-Wildcards. Abfragelimits dürfen zwischen 0 und 1000 liegen. Text-Notizbücher behalten Unicode-Namen und koordinieren parallele lokale Prozesse über die Datei .llm-note.lock im Notizbuchordner. Offene Transfers erhalten eine #LLM-NOTE-ID, damit ein Retry nach einem Dateifehler den Eintrag nicht verdoppelt.

Datenschutz

llm-note sendet selbst keine Daten ins Netz. Datenbanken und Notizordner bleiben lokale Dateien und sind in .gitignore ausgeschlossen.

Einordnung

llm-note ist bewusst kleiner als vollständige Wissensdatenbanken wie Obsidian, Joplin, NotebookLM, Vektordatenbanken oder MCP-Notebook-Server. Es ist ein lokales Python-Paket für Agenten-Notizen, CLI-Notizbücher und reproduzierbare Logbücher, die in Git lesbar bleiben und leicht in andere Tools eingebettet werden können.

Passende Suchphrasen sind local-first LLM notes, SQLite note store for agents, agent notebook CLI, private AI notebook, LLM memory logbook und BACH Notizblock extraction.

Lizenz

MIT - Copyright 2026 Lukas Geiger