1# modules/akasha/ — Explorador semántico de Mónadas (era nouser)
2
3**Propósito.** Daemon que descubre y consulta "Mónadas" (unidades
4semánticas auto-descriptivas) vía broker brahman. Provee embeddings
5locales (mock o real LLM) y un protocolo `Nous` line-delimited.
6
7## Crates
8
9| crate | tipo | rol |
10| --------------- | ----- | --------------------------------------------------------- |
11| `akasha-card` | lib | Definición Card del daemon + capabilities |
12| `akasha-core` | bin | Daemon: scanner FS + DB sled + cluster por embedding |
13| `akasha-nous` | lib | Protocolo Nous (JSON line-delimited) |
14| `akasha-nous-mock` | bin | Proveedor de embeddings deterministas (testing) |
15| `akasha-nous-real` | bin | Proveedor con fastembed/ort (LLM real) |
16
17## Dependencias
18
19- `akasha-core` ← `protocol/brahman-card`, `protocol/brahman-sidecar`,
20 `akasha-card`, `akasha-nous`, `shuma-discern`.
21- `akasha-nous-real` ← `fastembed` (opcional, detrás de feature
22 `embeddings`; `ort` viene transitivo). Sin feature, el crate compila
23 como stub mínimo. Profile opt-level=1 en root Cargo.toml para
24 `fastembed`/`ort`/`tokenizers`/`image`.
25- Consumido por: `apps/akasha-explorer` (GPUI dashboard).
26
27## Estado
28
29LOC 4,395. Pipeline de scan + embed + cluster funcional. Pendiente:
30cobertura de tests sobre el cluster engine (k-means actual es naive).
31Ver `docs/changelog/akasha.md`.
SDD.md
modules/akasha/ — Explorador semántico de Mónadas (era nouser)
Propósito. Daemon que descubre y consulta "Mónadas" (unidades
semánticas auto-descriptivas) vía broker brahman. Provee embeddings
locales (mock o real LLM) y un protocolo Nous line-delimited.
Crates
| crate | tipo | rol |
akasha-card | lib | Definición Card del daemon + capabilities |
akasha-core | bin | Daemon: scanner FS + DB sled + cluster por embedding |
akasha-nous | lib | Protocolo Nous (JSON line-delimited) |
akasha-nous-mock | bin | Proveedor de embeddings deterministas (testing) |
akasha-nous-real | bin | Proveedor con fastembed/ort (LLM real) |
Dependencias
akasha-core ← protocol/brahman-card, protocol/brahman-sidecar,
akasha-card, akasha-nous, shuma-discern.
akasha-nous-real ← fastembed (opcional, detrás de feature
embeddings; ort viene transitivo). Sin feature, el crate compila
como stub mínimo. Profile opt-level=1 en root Cargo.toml para
fastembed/ort/tokenizers/image.
- Consumido por:
apps/akasha-explorer (GPUI dashboard).
Estado
LOC 4,395. Pipeline de scan + embed + cluster funcional. Pendiente:
cobertura de tests sobre el cluster engine (k-means actual es naive).
Ver docs/changelog/akasha.md.