NinaiInstall Ninai
Menu

Install / MVP 0.1

Run Ninai on your machine.

The current MVP is a Python MCP server backed by local SQLite. It is built for technical evaluation and the Claude Code integration path.

Python3.11+AccountNot requiredStorageLocal SQLite
01

Install engine

Clone and install the local package.

Ninai uses the Python standard library for its engine and the official MCP SDK for transport. The normal installation builds a local wheel.

git clone https://github.com/HariDarshan2321/ninai.git
cd ninai/engine
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install .
02

Grant scopes

Start with the smallest useful boundary.

Recall is denied by default. Grant only the scopes Claude Code needs for the initial workflow; personal, health, and finance remain unavailable.

ninai permission grant claude-code project
ninai permission grant claude-code work
ninai permission list claude-code
03

Register MCP

Add one local server to Claude Code.

Restart Claude Code afterward, open /mcp, and confirm Ninai is available.

claude mcp add ninai -- ninai-mcp
04

Optional automatic capture

Observe existing MCP activity through the host.

Copy the PostToolUse hook into a project where Claude already uses Linear, GitHub, or another MCP server. You do not reconnect those services to Ninai.

mkdir -p .claude/hooks
cp /path/to/ninai/.claude/hooks/ninai_post_tool_use.py .claude/hooks/
cp /path/to/ninai/.claude/settings.example.json .claude/settings.json
chmod +x .claude/hooks/ninai_post_tool_use.py
05

Verify the boundary

Remember, recall, revoke.

STORE

Ask Claude: “Remember that the Ninai dashboard must be ready before launch.”

RECALL

Start a fresh session: “What must I finish before launch?”

REVOKE

ninai permission revoke claude-code project, then repeat the request.

Expected result

The first recall includes a source URI. The second returns no project facts.

06

MVP boundaries

Know what this build is—and is not.

  • Included Local SQLite, FTS5, explicit scopes, provenance, access logs, soft deletion.
  • Included Claude Code PostToolUse capture and explicit MCP remember/recall.
  • Not yet SQLCipher, signed desktop releases, universal capture, or an independent audit.
  • Not included Cloud sync, accounts, billing, Gmail OAuth, or mobile applications.

Questions? hello@ninai.io · Read the privacy architecture.