@andespindola/brainlink 1.10.0 → 1.10.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -62,6 +62,24 @@ Online retrieval always uses a single compression stage per pack; optional secon
|
|
|
62
62
|
Pack decryption uses a Brainlink key from `$BRAINLINK_HOME/keys` or from `BRAINLINK_SEARCH_PACK_KEY` when explicitly configured.
|
|
63
63
|
Legacy `.jsonl.gz` packs are upgraded to `.blpk` automatically on first search/context access.
|
|
64
64
|
|
|
65
|
+
## Brainlink vs Obsidian
|
|
66
|
+
|
|
67
|
+
Brainlink and Obsidian share the same raw material — plain Markdown, `[[wiki links]]`, backlinks, tags and a knowledge graph — so they are easy to confuse. They are **not the same product**, and they do not compete: they are built for different readers.
|
|
68
|
+
|
|
69
|
+
- **Obsidian** is a personal knowledge base (PKM) for a **human**. You open a GUI, write notes, and explore the graph with your eyes. It is a great second brain that lives on your machine.
|
|
70
|
+
- **Brainlink** is canonical memory for **AI agents**. There is no GUI to read: an agent queries it (CLI, JSON, local HTTP API, MCP) and gets the right context assembled on demand.
|
|
71
|
+
|
|
72
|
+
| Dimension | Obsidian | Brainlink |
|
|
73
|
+
| --- | --- | --- |
|
|
74
|
+
| Made for | A human reading/writing in a GUI | AI agents (LLMs), automation-first |
|
|
75
|
+
| Interface | Desktop & mobile app | CLI, JSON output, local HTTP API, MCP server, graph frontend |
|
|
76
|
+
| Retrieval | Full-text search + manual graph navigation | Full-text, semantic and hybrid retrieval + RAG/CAG context assembly |
|
|
77
|
+
| Graph | Visualization for a human to explore | Weighted-edge retrieval engine that ranks and assembles context |
|
|
78
|
+
| Security | Plain-text files on disk | Optional AES-256-GCM encrypted vault and private search packs |
|
|
79
|
+
| Usage | Single-user | Shared memory across agents via `agents/<agent-id>/` namespaces |
|
|
80
|
+
|
|
81
|
+
The vault stays Obsidian-compatible on purpose: it is plain Markdown with `[[wiki links]]`, so a human *can* open it in Obsidian-like tools (encrypted vaults excepted). But Brainlink is not a reimplementation of Obsidian — it is a memory layer for agents that happens to reuse the same portable format.
|
|
82
|
+
|
|
65
83
|
## Features
|
|
66
84
|
|
|
67
85
|
- Local-first Markdown vault.
|
package/package.json
CHANGED