Skip to content

novyxlabs/novyx-vault

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

186 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Novyx Vault

Novyx Vault

Open-source second brain with AI memory that actually persists.
Every other AI assistant starts from zero. This one learns.

Try it free  ·  Website  ·  Discord  ·  Contributing  ·  Changelog

License: MIT CI GitHub stars


The problem

AI in note-taking apps doesn't remember you. Obsidian plugins and most AI note tools do the same thing: search your notes when you ask a question (RAG). Close the tab, start a new session, and the AI starts from zero.

Novyx Vault is different. Your AI builds persistent memory from your notes and conversations — memory that survives sessions, consolidates over time, and can be rolled back when it goes wrong. The longer you use it, the smarter it gets.

What makes it different

Novyx Vault Obsidian
AI remembers across sessions Yes — persistent memory No
Memory rollback & audit trail Built in No
AI discovers hidden connections Built in (Ghost Connections) No
Bring your own AI provider Built in Plugin-dependent
Open source MIT Source-available
Desktop-local files Yes (Tauri desktop) Yes
Markdown files Yes Yes
Knowledge graph Yes Yes

Quick start

Use it now (no install)

vault.novyxlabs.com — sign in with GitHub or Google. Free.

Self-host (3 commands)

git clone https://github.com/novyxlabs/novyx-vault.git
cd novyx-vault
npm install && npm run dev

Open http://localhost:3000. That's it — notes, wiki-links, knowledge graph, and AI chat all work immediately.

Add persistent AI memory (optional):

echo "NOVYX_MEMORY_API_KEY=your_key" > .env.local

Get a free API key at novyxlabs.com — unlocks cross-session memory, rollback, ghost connections, and cortex insights.

Docker (one command)

docker run -p 3000:3000 ghcr.io/novyxlabs/novyx-vault

Desktop app (Tauri)

npm run tauri:dev    # development with hot reload
npm run tauri:build  # production build

Requires Rust.


Features

Persistent AI memory

The core differentiator. Powered by Novyx Core.

  • Cross-session memory — Your AI remembers projects, preferences, and decisions from every past session. Ask about something from last month and it responds with full context.
  • Ghost Connections — AI discovers hidden relationships between notes without shared keywords or explicit links.
  • Memory timeline & rollback — See what your AI learned and when. Roll back to any point in time.
  • Cortex insights — AI surfaces emerging themes and patterns from your accumulated knowledge.
  • Entity extraction — People, projects, and concepts extracted into a semantic knowledge graph.
  • Audit trail — Every memory operation logged with hash-chain verification.

Notes & editor

  • Markdown editor — CodeMirror 6 with live preview, syntax highlighting, keyboard shortcuts. Plain .md files, no lock-in.
  • Wiki-links & backlinks[[wiki-links]] with automatic bidirectional backlinks.
  • Knowledge graph — Interactive force-directed graph of your entire vault.
  • Folders, tags & search — Nested folders, inline tags, full-text search, pinned favorites.

AI writing tools

  • Voice capture — Record and transcribe on-device or via cloud. AI structures transcripts into clean notes.
  • Brain dump — Paste raw thoughts, get structured notes back.
  • Clip remix — Paste web content, get it rewritten in your voice.
  • Slash commands — Inline AI anywhere in the editor.
  • Weekly review — Automated summary of your writing activity.
  • Writing coach — AI feedback on clarity, structure, and tone.

AI providers (BYOK)

OpenAI, Anthropic, Google Gemini, DeepSeek, Groq, Together, Mistral, xAI Grok, Perplexity, Cohere, Nvidia NIM, Hyperbolic, Cerebras, SambaNova, Fireworks, Moonshot, MiniMax, OpenRouter, Ollama, LM Studio.

Keys are encrypted at rest in cloud mode and stay on your device in desktop mode. Switch providers without losing memory or notes.

Desktop-local & open source

  • Desktop app — Native via Tauri (macOS, Windows, Linux). Notes stored as plain markdown in ~/SecondBrain/. Core note editing works offline.
  • Cloud mode — Optional Supabase-powered hosted mode with auth, sharing, and publishing.
  • MIT licensed — Inspect, contribute, or self-host.

Importing from Obsidian

Already have an Obsidian vault? Vault imports your notes, preserves wiki-links, and adds persistent AI memory on top.

Settings → Import → Obsidian → Select your vault folder

MCP integration

The same Novyx memory works across Vault, Claude Code, Cursor, and any MCP-compatible tool.

pip install novyx-mcp
claude mcp add novyx-memory -- python -m novyx_mcp

Memories created in Claude Code appear in Vault. Memories from Vault are available to your coding agent. One API key, one memory, everywhere.


Cloud deployment

Cloud mode adds auth, account-backed storage, sharing, and publishing via Supabase.

Environment variables

Variable Required Description
STORAGE_MODE Cloud only Set to supabase for cloud mode
NEXT_PUBLIC_SUPABASE_URL Cloud only Supabase project URL
NEXT_PUBLIC_SUPABASE_ANON_KEY Cloud only Supabase anonymous key
SUPABASE_SERVICE_ROLE_KEY Cloud only Server-side key. Never expose to client.
NOVYX_MEMORY_API_KEY Desktop Personal Novyx API key
NOVYX_ADMIN_KEY Cloud only Admin key for per-user provisioning
UPSTASH_REDIS_REST_URL Optional Redis for rate limiting
UPSTASH_REDIS_REST_TOKEN Optional Redis auth token

Deploy

npm run build

Or connect to Vercel for automatic deployments.


Scripts

Command Description
npm run dev Development server
npm run build Production build
npm run start Production server
npm run lint ESLint
npm run test Playwright E2E tests
npm run test:unit Vitest unit tests
npm run test:cloud-smoke Opt-in Playwright smoke test against a deployed cloud URL
npm run tauri:dev Tauri desktop dev
npm run tauri:build Tauri desktop build

npm run test:cloud-smoke requires CLOUD_SMOKE_BASE_URL, CLOUD_SMOKE_EMAIL, and CLOUD_SMOKE_PASSWORD. Use a disposable cloud account because the suite creates, publishes, unpublishes, deletes, and purges a note under Smoke Tests/.

Tech stack

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · CodeMirror 6 · Novyx SDK · Supabase · Tauri v2

52 components · 64 API routes · 18+ AI providers

Project structure

app/              Next.js app router (pages + API routes)
components/       React components
lib/              Storage adapters, Novyx client, providers, transcription
public/           Static assets
src-tauri/        Tauri desktop app (Rust)
tests/            Playwright E2E + Vitest unit tests

Contributing

Contributions welcome! See CONTRIBUTING.md.

git clone https://github.com/novyxlabs/novyx-vault.git
cd novyx-vault
npm install
npm run dev
Contributors

License

MIT


Built by Novyx Labs

About

Open-source second brain with AI that actually remembers you. Persistent memory across sessions, rollback, audit trails, knowledge graph, voice capture, 20+ AI providers. Desktop + cloud.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages