Sakthi Graph

शक्ति · சக்தி · power. A local-first AI knowledge graph for the Sabha OS council. Your decisions, your people, your projects — compounding on your machine.

Sakthi (Sanskrit/Tamil for power) is the memory layer of the Sabha trinity:

Sabha     — the council (the protocol)
Chanakya  — the archetype (decisive, tradeoff-aware counsel)
Sakthi    — your power (the memory, on your machine)

Forked from MemPalace (MIT). Sakthi preserves MemPalace's full MCP tool surface (renamed sakthi_*), the ChromaDB-backed knowledge graph, and the local-first architecture — while adding Sabha-specific presets so a Claude Code user installing Sabha OS gets a knowledge graph already shaped for operator-grade decision work.

What's different from MemPalace

Layer	Sakthi vs. MemPalace
Storage	Identical (ChromaDB-backed; ~300MB embedding model)
MCP server	Renamed: sakthi-mcp (was mempalace-mcp); both aliases shipped during the deprecation window
MCP tool names	sakthi_search, sakthi_kg_query, sakthi_diary_write, ... (was mempalace_*)
CLI	sakthi and sakthi-mcp (legacy mempalace, mempalace-mcp aliased)
Sabha-specific defaults	sakthi init --sabha bootstraps the 9 role wings used by the Sabha council
Diary templates	Role-aware templates per CFO / CMO / CIO / CAIO / CSO / CXO / CHRO / CLC / CEO
Brand	Sakthi-branded user surface; upstream attribution preserved (see NOTICE)
License	MIT (same as upstream)

For everything else — chunking, embedding, retrieval, graph traversal, drawer / wing / room semantics — Sakthi is MemPalace. The fork is about presentation + Sabha-specific defaults, not core architecture.

Install

# Recommended (isolated environment)
uv tool install sakthi-graph

# Or via pip
pip install sakthi-graph

# Or clone for development
git clone https://github.com/rdmurugan/sakthi-graph.git
cd sakthi-graph
pip install -e .

Quick start

# 1. Initialize Sakthi with the Sabha 9-wing preset
sakthi init --sabha ~/sakthi

# 2. Register with Claude Code (MCP)
claude mcp add sakthi -- sakthi-mcp --palace ~/sakthi

# 3. Use Sabha OS as usual; the council now grounds answers in your Sakthi.

For the full setup including Sabha OS itself:

claude plugin marketplace add rdmurugan/sabhaos
claude plugin install sabha-os@sabha-marketplace
claude plugin install sakthi-graph@sabha-marketplace
uv tool install sakthi-graph
sakthi init --sabha ~/sakthi

sakthi sittham — bring a corpus into the council's consciousness

Sittham (சித்தம், Tamil for consciousness / mind / awareness; cognate with Sanskrit chitta, चित्त) is the inner faculty that holds what the mind is aware of. sakthi sittham takes a folder's prepared graph and brings a compact, role-shaped summary into the right Sabha wing of your Sakthi — so the corpus now lives in the council's awareness, ready to be drawn upon.

/graphify ~/path/to/corpus            # prepare the graph (one-time per corpus)
sakthi sittham ~/path/to/corpus       # bring into Sakthi (auto-routed)
sakthi sittham <path> --dry-run       # preview routing without filing
sakthi sittham <path> --wing cfo --room pricing   # explicit override

The corpus is scored against the 9 Sabha role vocabularies; the dominant role's decisions room receives a compact drawer (node/edge/community counts, top god nodes, role-signal breakdown, report excerpt). Weak or split signals fall back to ceo/synthesis-notes. Idempotent on (wing, room, content).

Also exposed as MCP tool sakthi_sittham (the primary agent surface) and as mempalace.sittham.sittham().

What the --sabha preset gives you

Running sakthi init --sabha creates a knowledge-graph palace pre-shaped for the Sabha council:

~/sakthi/
├── wings/
│   ├── cfo/      — financial decisions, runway, pricing, unit economics
│   ├── cmo/      — positioning, channels, campaigns, repositioning notes
│   ├── cio/      — vendors, infra decisions, incidents, security posture
│   ├── caio/     — AI decisions, model selection, eval results, RAG notes
│   ├── cso/      — strategy decisions, partnerships, market entry, big bets
│   ├── cxo/      — UX experiments, retention findings, customer interviews
│   ├── chro/     — hiring decisions, classification, comp bands, performance
│   ├── clc/      — contract decisions, IP, compliance, regulatory hand-offs
│   ├── ceo/      — synthesis memos, board notes, founder-mode decisions
│   └── personal/ — life decisions (optional via --personal flag)

Each Sabha role's diary writes go to its wing by default, so search and retrieval naturally segment by domain.

MCP tools (32 total)

Sakthi exposes the full MemPalace tool surface, renamed:

Category	Tools
Status / read	sakthi_status, sakthi_list_wings, sakthi_list_rooms, sakthi_get_taxonomy, sakthi_search, sakthi_check_duplicate
Knowledge graph	sakthi_kg_query, sakthi_kg_add, sakthi_kg_invalidate, sakthi_kg_timeline, sakthi_kg_stats
Graph traversal	sakthi_traverse, sakthi_find_tunnels, sakthi_graph_stats, sakthi_create_tunnel, sakthi_list_tunnels, sakthi_delete_tunnel, sakthi_follow_tunnels
Drawer CRUD	sakthi_add_drawer, sakthi_delete_drawer, sakthi_get_drawer, sakthi_list_drawers, sakthi_update_drawer
Corpus ingest	sakthi_sittham
Diary	sakthi_diary_write, sakthi_diary_read
Operations	sakthi_sync, sakthi_reconnect, sakthi_hook_settings, sakthi_memories_filed_away, sakthi_get_aaak_spec

Backward-compatible legacy aliases (mempalace_*) are not shipped in Sakthi — clients should use the sakthi_* names. If you need MemPalace-compatible tool names, install upstream MemPalace directly.

Relationship to upstream MemPalace

Sakthi is an honest fork. We:

• Preserved the original MIT LICENSE
• Added NOTICE attributing upstream authorship
• Renamed the user-facing surface (CLI, MCP commands, tool names, README)
• Kept internal module structure (mempalace/ directory) intact — minimizes upstream-merge friction so we can pull in MemPalace improvements regularly
• Will contribute generic-useful improvements back to MemPalace upstream (not Sabha-specific presets, which stay here)

If you want pure MemPalace without the Sabha brand or presets, use github.com/MemPalace/mempalace directly. Sakthi exists specifically for Sabha OS users who want a knowledge graph already shaped for the council.

License

MIT. See LICENSE. Original copyright by milla-jovovich (MemPalace authors) preserved; Sabha-specific additions (the --sabha preset, role-aware diary templates, sakthi sittham corpus ingest, Sakthi-branded surface) copyright © 2025–2026 Durai (@rdmurugan), released under the same MIT License.

See NOTICE for full attribution.

Acknowledgment

Sakthi exists because MemPalace exists. The graph-shaped local memory architecture, the wing/room/drawer taxonomy, the ChromaDB integration, the entity-detection pipeline, the diary mechanism — all of it is MemPalace's work. Sakthi adds presentation + presets for the Sabha audience.

Thanks to the MemPalace maintainers for making this fork legally and ethically possible.

Documentation

Doc	What's in it
docs/SITTHAM.md	Detailed reference for sakthi sittham — the corpus-ingest verb. Vocabularies, drawer format, failure modes, how to extend.
docs/CLOSETS.md	Internal: how content gets summarized into closets (LLM-generated rollups).
docs/HISTORY.md	The upstream MemPalace history this fork inherits.
docs/schema.sql	The ChromaDB schema reference.
UPSTREAM_README.md	Original MemPalace README, preserved verbatim.
CHANGELOG.md	Version history (Sakthi fork + upstream MemPalace).
NOTICE	Attribution to upstream MemPalace authors.

Links

• Sabha OS: https://github.com/rdmurugan/sabhaos
• Sabha OS architecture overview: https://github.com/rdmurugan/sabhaos/blob/main/docs/ARCHITECTURE.md
• Upstream MemPalace: https://github.com/MemPalace/mempalace